> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/getting-started/building-your-first-playbook.md).

# Criar o seu primeiro Playbook

Crie e execute o seu primeiro Playbook AirOps

Neste tutorial, vai criar um Playbook de criação de conteúdo. O Playbook recebe uma palavra-chave principal ou prompt-alvo, pesquisa respostas de pesquisa de LLM a partir do AirOps Insights e resultados do Google, cria um esboço, redige o artigo, adiciona ligações e produz um artigo final em Markdown.

Este exemplo de conteúdo próprio mostra como transformar uma oportunidade de descoberta de IA em trabalho de agente repetível, com o contexto da sua marca e Revisão Humana. Pode aplicar a mesma abordagem a outras tarefas de pesquisa, atualização e otimização na sua estratégia.

## Antes de começar

Para obter a saída da mais alta qualidade, configure as duas fontes de contexto de que este Playbook depende:

* **AirOps Insights:** Acompanhe os prompts, tópicos, concorrentes e páginas que lhe interessam. O Playbook usa o AirOps Insights para pesquisar respostas de pesquisa de LLM, citações nessas respostas e oportunidades de AEO para o prompt-alvo.
* **Brand Kit:** Mantenha o seu Brand Kit atualizado para que o Playbook possa usar o seu posicionamento, público, voz, regras de escrita, linhas de produtos e contexto dos concorrentes.

## O que vai criar

O Playbook irá:

1. Aceitar uma palavra-chave principal, um prompt-alvo e o Brand Kit como Entradas.
2. Pesquisar respostas de pesquisa de LLM do AirOps Insights e compará-las com os resultados do Google.
3. Analisar o conteúdo dos concorrentes e as lacunas de conteúdo.
4. Criar um esboço, um rascunho, um mapa de ligações e o artigo final.
5. Fazer uma pausa para Revisão Humana antes de o artigo final ser aprovado.

## Passo 1: Criar um Playbook em branco

1. Clique em **Crie**.
2. Selecione **Playbook**.
3. Selecione **Playbook em branco**.
4. Nomeie o Playbook **Criação de Blogue**.

A AirOps abre o editor do Playbook. O editor tem uma linha de chips de cabeçalho para Ferramentas, Entradas, Artefactos e **Adicionar gatilho**, além de ações no canto superior direito para **Executar Playbook**, **Publicar**, e **Histórico de execuções**.

## Passo 2: Adicionar Entradas

Crie as Entradas de que o Playbook precisa em tempo de execução.

| Nome da entrada   | Digite    | Descrição                                                                       |
| ----------------- | --------- | ------------------------------------------------------------------------------- |
| `primary_keyword` | Texto     | A palavra-chave de SEO que o artigo deve visar.                                 |
| `target_prompt`   | Texto     | O prompt ou pergunta de pesquisa do LLM a que o artigo deve ajudar a responder. |
| `brand_kit`       | Brand Kit | O Brand Kit que deve orientar o posicionamento, o público, a voz e as regras.   |

O Playbook deve funcionar quando qualquer um deles `primary_keyword` ou `target_prompt` for fornecido. Se ambos forem fornecidos, use ambos para moldar a pesquisa e a estratégia do artigo.

## Passo 3: Adicionar Ferramentas

Digite `/` em qualquer Secção para abrir o menu de barra. Use-o para inserir Ferramentas, Entradas, Artefactos e outras referências diretamente nas instruções do Playbook.

Para este tutorial, adicione as Ferramentas que o seu espaço de trabalho tem ligadas:

* **Google Search:** Encontre os resultados atuais do Google para a palavra-chave alvo.
* **Parallel Web Systems:** Use a Parallel Search API, a Parallel Extract API e a Parallel Task API para pesquisar a web, extrair conteúdo-fonte e estruturar conclusões.
* **AirOps SEO Research:** Obtenha contexto de palavra-chave, domínio e SEO.
* **DataForSEO**, **Moz**, ou **Google Search Console:** Adicione dados de SEO se o seu espaço de trabalho usar estas fontes.
* **Page 360 Report:** Diagnostique um URL próprio em termos de desempenho de pesquisa, visibilidade em IA, frescura, sinais de autoridade e conteúdo da página.
* **Page Versus Report:** Compare um URL próprio com as páginas que estão a vencer nas respostas de pesquisa e IA e, em seguida, revele lacunas a colmatar.
* **Web Page Scrape:** Leia páginas específicas que o Playbook precisa de inspecionar.
* **Brandfetch:** Enriqueça detalhes da empresa ou da marca quando necessário.

{% hint style="info" %}
Não precisa de todas as Ferramentas na primeira versão. Comece com Google Search, Parallel Web Systems, AirOps SEO Research e quaisquer relatórios de páginas do AirOps relevantes para o artigo.
{% endhint %}

## Passo 4: Declarar Artefactos

Os Artefactos são os resultados duradouros que o Playbook produz. Adicione estes Artefactos antes de escrever as Secções para os poder referenciar pelo nome.

| Artefato                     | Digite   | Finalidade                                                                                                               |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| **AI & Google Results.md**   | Markdown | Capta conteúdo existente, os principais resultados do Google e citações de respostas de LLM do AirOps Insights.          |
| **Análise Concorrencial.md** | Markdown | Resume a intenção de pesquisa, a estrutura dos concorrentes, as palavras-chave, as FAQs, as lacunas e a adequação a AEO. |
| **Topic Research.md**        | Markdown | Armazena factos verificados, insights de especialistas, exemplos e correções de afirmações.                              |
| **Content Outline.md**       | Markdown | Define a estrutura do artigo e o briefing de escrita.                                                                    |
| **Article Draft.md**         | Markdown | Armazena o primeiro rascunho completo do artigo.                                                                         |
| **Mapa de Ligações.json**    | JSON     | Mapeia ligações internas e externas para as secções do artigo.                                                           |
| **Artigo Final.md**          | Markdown | Armazena o artigo finalizado com ligações.                                                                               |

Use o menu de barra para inserir referências a Artefactos nas Secções seguintes. Referencie os Artefactos pelo nome, e não pelo nome de ficheiro gerado numa Sessão.

## Passo 5: Escrever as Secções

Use Secções para descrever o trabalho em fases. Mantenha a primeira versão focada no caminho principal.

Formate cada Secção com um curto **Objetivo**, as Entradas ou Artefactos que deve referenciar, claro **Instruções**, e o esperado **Saída** Artefacto. Use o menu de barra para inserir referências a Entradas, Artefactos, Ferramentas e Brand Kit em vez de escrever os seus nomes manualmente.

### Secção A: Pesquisar respostas de LLM e resultados do Google

Diga ao Playbook para:

* Verifique o site da marca para conteúdo existente relacionado com a palavra-chave ou o prompt.
* Use o AirOps Insights para pesquisar respostas de pesquisa de LLM e citações para o prompt-alvo.
* Use o Google Search e ferramentas de SEO para recolher os principais resultados do Google para a palavra-chave principal.
* Exclua redes sociais, fóruns e domínios concorrentes sempre que possível.
* Escreva os resultados em **AI & Google Results.md**.

### Secção B: Analisar concorrentes e lacunas

Diga ao Playbook para:

* Extraia títulos, conteúdo do corpo, contagem de palavras e secções de FAQ das páginas citadas e classificadas mais fortes.
* Analise a intenção de pesquisa, a cobertura do tema, a estrutura, as palavras-chave, as FAQs e as lacunas.
* Use o Brand Kit para identificar ângulos que a marca possa legitimamente assumir.
* Escreva a análise em **Análise Concorrencial.md**.

### Secção C: Recolher pesquisa sobre o tema

Diga ao Playbook para:

* Construa uma agenda de pesquisa a partir de **Análise Concorrencial.md**.
* Encontre estatísticas atuais, perspetivas de especialistas, exemplos do mundo real e alegações desatualizadas dos concorrentes.
* Prefira fontes primárias e autoritativas.
* Escreva os resultados em **Topic Research.md**.

### Secção D: Criar o esboço

Diga ao Playbook para:

* Use **Análise Concorrencial.md**, **Topic Research.md**, e o Brand Kit para definir a estratégia do artigo.
* Inclua o H1, H2s, H3s, contagem-alvo de palavras, pontos-chave, palavras-chave, notas de pesquisa, perguntas dos leitores e o ângulo da marca.
* Escreva o esboço em **Content Outline.md**.

### Secção E: Redigir e rever o artigo

Diga ao Playbook para:

* Redija o artigo a partir de **Content Outline.md**.
* Use **Topic Research.md** para factos, exemplos e fontes.
* Siga a voz do Brand Kit, o público, as regras de escrita e as convenções do tipo de conteúdo.
* Escreva o rascunho em **Article Draft.md**.
* Pause para Revisão Humana antes de finalizar.

### Secção F: Adicionar ligações e finalizar

Diga ao Playbook para:

* Adicione ligações internas relevantes do site da marca.
* Adicione ligações externas que suportem afirmações específicas.
* Escreva o plano de ligações em **Mapa de Ligações.json**.
* Escreva o artigo finalizado em **Artigo Final.md**.

## Passo 6: Executar e publicar

1. Clique em **Executar Playbook**.
2. Introduza uma palavra-chave principal, um prompt-alvo ou ambos.
3. Selecione o Brand Kit.
4. Revise cada Artefacto à medida que é criado.
5. Conclua a etapa de Revisão Humana a partir da Caixa de Entrada ou da vista de Sessão.
6. Confirme que **Artigo Final.md** está concluído.
7. Clique em **Publicar** quando a estrutura do Playbook funcionar de forma fiável.

Os Playbooks publicados podem ser executados a partir de Grelhas e Disparadores. Use um [Disparador de Webhook](/docs/pt/acoes/playbooks/triggers.md) quando um sistema externo deve iniciar um Playbook de forma programática. As edições do rascunho permanecem editáveis, mas as execuções subsequentes usam uma versão publicada.

## Expanda o seu Playbook

Depois de publicar, pode:

* Adicionar o Playbook a uma Grelha para criar artigos em muitas palavras-chave ou prompts.
* Adicionar um Agendamento, Webhook ou Disparador de Monitorização.
* Use [Quill](/docs/pt/quill.md) para rever o Playbook a partir de instruções em linguagem natural.
* Criar um fluxo de publicação separado para atualizações do CMS.

{% hint style="info" %}
A melhor prática é manter a criação de conteúdo e a publicação no CMS separadas. Execute primeiro o Playbook de conteúdo, reveja a saída e depois publique através de uma coluna de Grelha, de um Playbook de publicação separado ou de um CMS MCP. Se um Playbook ou um CMS MCP publicar ou atualizar uma página, use a ferramenta AirOps MCP `track_aeo_page_content_update` com o URL da página e o tipo de atualização para que o AirOps Insights possa associar futuras alterações de desempenho a essa atualização de conteúdo.
{% endhint %}

Parabéns, construiu e executou o seu primeiro Playbook de criação de conteúdo.

Este passo a passo segue a mesma estrutura geral que o **Criação de Blogue** template. Execute o template com a mesma palavra-chave, prompt-alvo e Brand Kit se quiser comparar as saídas e ver como uma versão mais completa lida com o mesmo briefing.

Para referência mais aprofundada, consulte [Criar um Playbook](/docs/pt/acoes/playbooks/create-a-playbook.md), [Construir um Playbook](/docs/pt/acoes/playbooks/build-a-playbook.md), e [Executar um Playbook](/docs/pt/acoes/playbooks/run-a-playbook.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/getting-started/building-your-first-playbook.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.