> 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/acoes/playbooks/build-a-playbook.md).

# Construir um Playbook

Defina Inputs, Sections, Tools, Artifacts, revisões e triggers num Playbook

Os Playbooks são construídos a partir de Inputs, Sections, Tools, Artifacts, blocos de Human Review e Triggers. Defina cada parte de forma clara para que o agente tenha o contexto certo e os revisores tenham os pontos de controlo adequados.

## Escolha um modelo

Use o recurso **Modelo** seletor no editor do Playbook para escolher **Automático** ou um modelo disponível. As opções apresentadas dependem do seu workspace e dos fornecedores disponíveis.

**GPT-6 Sol**, **GPT-6 Luna**, **Claude Opus 5.5**, **Claude Sonnet 5.5**, e **Kimi K3** estão disponíveis no seletor. Escolha Sol ou Opus 5.5 para trabalhos complexos, ou Luna quando a velocidade e o custo forem mais importantes.

### Comparar classificações dos modelos

Expanda um modelo para ajustar o seu esforço de raciocínio suportado **Esforço de raciocínio** e compare as classificações disponíveis para essa seleção:

| Classificação            | O que significam mais barras                                                |
| ------------------------ | --------------------------------------------------------------------------- |
| **Velocidade**           | Conclusão média mais rápida em execuções de benchmark                       |
| **Inteligência**         | Maior capacidade geral com base no benchmark público da Artificial Analysis |
| **Eficiência de custos** | Menos tarefas consumidas por execução de benchmark                          |

As classificações mudam com o esforço de raciocínio selecionado quando há dados de benchmark disponíveis. Alguns modelos e definições de esforço não têm classificações. Considere as barras como orientação comparativa: o seu Playbook, Inputs e Tools afetam o tempo de execução real, o uso de tarefas e a qualidade da saída. Auto não tem um benchmark fixo de modelo e esforço.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-931066925d9c8a7297d5b2aa5f05f6558ba3142b%2Fbuild-playbook-01-model-selector.png?alt=media" alt="Playbook model selector grouped by provider, with Kimi K3 expanded to show reasoning effort and Speed, Intelligence, and Cost efficiency ratings"><figcaption><p>Expanda um modelo para comparar as suas classificações em cada esforço de raciocínio.</p></figcaption></figure>

## Escolha um modo de execução

Utilize **Rápido** ou **Máximo** no editor do Playbook para escolher o grau de rigor com que o Playbook verifica o seu trabalho:

| Modo       | Use-o quando                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------- |
| **Rápido** | Quiser redigir mais rapidamente com uma verificação factual focada e menos ciclos de verificação.       |
| **Máximo** | Precisar de verificação factual exaustiva, recolha de fontes e verificações repetidas. Este é o padrão. |

Publique o Playbook para guardar o modo nessa versão. Uma Session mantém o modo da versão que executou, e pode inspecioná-lo em Session **Detalhes**. Alterar o rascunho não muda o modo de uma Session existente nem de uma versão afixada.

## 1. Definir Inputs

Os Inputs são a forma como um Playbook recebe informação em tempo de execução.

| Digite    | Usar para                                                                         |
| --------- | --------------------------------------------------------------------------------- |
| Texto     | Palavras-chave, URLs, prompts, strings em formato livre.                          |
| Número    | Contagens, limites, classificações.                                               |
| Ficheiro  | Documentos, briefings e exportações que o Playbook deve ler durante uma execução. |
| Brand Kit | Tom de voz, regras de escrita, públicos, regiões e diretrizes visuais.            |

Clique em **Mostrar definições avançadas** num Input para definir o nome da variável, a descrição, o placeholder e o valor predefinido.

## 2. Definir Sections

As Sections são a espinha dorsal estrutural de um Playbook. Cada Section contém instruções e pode, opcionalmente, terminar com um bloco de Human Review.

Organize as Sections por fase lógica, não por revisor. Um pipeline de conteúdo pode usar:

1. **Receção e validação:** Processar o Input, validá-lo e recolher contexto.
2. **Pesquisa e estratégia:** Pesquisar Knowledge Bases, analisar SERPs e rever concorrentes.
3. **Compilação do briefing:** Sintetizar a pesquisa num briefing acionável.
4. **Rascunho do artigo e ligação:** Gerar o conteúdo e adicionar ligações internas.
5. **Revisão final:** Pausar para Human Review antes de publicar.

Os modelos usam uma estrutura consistente dentro de cada Section. Use este padrão como ponto de partida e depois ajuste-o ao trabalho:

* **Objetivo:** Defina o que a Section deve alcançar.
* **Inputs e referências:** Nomeie os Inputs, Artifacts, campos do Brand Kit, Tools e Knowledge Bases que a Section deve usar. Insira-os pelo menu de barras quando possível.
* **Instruções:** Liste o trabalho em passos numerados e claros.
* **Saída:** Nomeie o Artifact que a Section deve escrever e o formato que deve usar.

## 3. Adicionar Tools

Digite `/` em qualquer Section para abrir o menu de barras. Use-o para inserir Tools, Inputs, Artifacts e outras referências nas instruções do Playbook.

Inputs, Artifacts e Tools tornam-se mais fáceis de reutilizar quando os insere pelo menu de barras em vez de escrever os respetivos nomes manualmente.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e1b0b98c35cd159dda4994c870bebaa731e1edcf%2Fbuild-playbook-02-slash-menu.png?alt=media" alt="Slash menu in a Playbook Section showing Inputs, Artifacts, Tools, Brand Kit, and formatting options, with the Tools submenu open"><figcaption><p>Digite / para inserir Tools, Inputs e Artifacts como referências.</p></figcaption></figure>

Para o catálogo completo de Tools, os MCP Connectors e as melhores práticas, consulte [Ferramentas](https://docs.airops.com/docs/pt/acoes/playbooks/tools.md).

### AirOps

* **AirOps MCP:** Aceda aos seus dados da AirOps, incluindo dados de Insights, Brand Kits, Knowledge Bases e Grids.
* **AirOps SEO Research:** Pesquisa de palavras-chave, análise de domínios e dados de backlinks.
* **Page 360 Report:** Diagnostique um URL próprio em termos de desempenho na pesquisa, visibilidade em IA, atualidade, 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 de IA e, em seguida, identifique lacunas a corrigir.
* **Web Page Scrape:** Extraia conteúdo de páginas Web.

### SEO Research

* **DataForSEO:** Dados de SEO e pesquisa de palavras-chave.
* **Moz:** SEO e análise de domínios.
* **Google Search Console:** Dados do GSC.

### Web Research

* **Pesquisa Google:** Pesquisar e recuperar resultados do Google.
* **Parallel Web Systems:** Use a Parallel Search API, a Parallel Extract API e a Parallel Task API para realizar pesquisa na web, obter dados estruturados a partir de URLs e processar inputs de pesquisa em saídas estruturadas.
* **Firecrawl:** Crawlar e extrair conteúdo de páginas Web.
* **Reddit:** Para mais detalhes, [Fale com a equipa de vendas](https://www.airops.com/book-a-call).

### Imagem e Vídeo

* **Geração de Imagem:** Gere ou edite imagens alojadas com GPT Image 2.5 Sunburst, GPT Image 2.5 Flare, GPT Image 2 ou Nano Banana 2. Consulte [Ferramentas de Imagem e Vídeo](https://docs.airops.com/docs/pt/acoes/playbooks/tools/image-and-video.md) para orientação sobre os modelos.
* **Imagens de Stock:** Pesquise no Getty Images ou Unsplash e depois obtenha uma imagem selecionada por ID para usar num Artifact ou numa etapa de publicação.

### Gestão do Conhecimento

* **Slack:** Ler o histórico do canal e enviar mensagens.
* **Google Docs:** Ler e editar documentos do Google Docs.

### Enriquecimento B2B

* **Brandfetch:** Obter ativos e informações da marca.
* **Hunter.io:** Encontrar e verificar endereços de e-mail. Para mais detalhes, [Fale com a equipa de vendas](https://www.airops.com/book-a-call).

### Anúncios

* **OpenAI Ads:** Obter o desempenho da conta. Criar e gerir campanhas, grupos de anúncios e anúncios quando as ferramentas de escrita estão ativadas. Consulte [Ferramentas de anúncios](https://docs.airops.com/docs/pt/acoes/playbooks/tools/ads.md) para ver a disponibilidade e os passos de revisão.

Pode adicionar qualquer MCP Connector de que precise nas definições de MCP Connectors do seu workspace. As ferramentas MCP ligadas aparecem na lista de Tools do editor do Playbook.

{% hint style="info" %}
Quando adicionar uma etapa de pesquisa na Knowledge Base, referencie a Knowledge Base pelo nome no seletor de Knowledge Base da etapa. Não confie na seleção automática quando o Playbook precisar de uma fonte específica.
{% endhint %}

## 4. Adicionar Human Review

Coloque Human Review como um bloco no final de uma Section existente. Não crie uma Section separada apenas para revisão.

Use Human Review quando alguém precisar de aprovar texto, escolher entre opções ou editar a saída gerada antes de a próxima Section ser executada.

As opções de revisor incluem:

* **Pessoa nomeada:** Um membro específico da equipa.
* **Utilizador atual:** A pessoa que acionou o Playbook.
* **Qualquer membro pode rever:** Qualquer membro do workspace pode rever.

As revisões aparecem na Inbox.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-aa59d35d0bf59d0595c551ddcf26add728f5cd0c%2Fbuild-playbook-03-human-review.png?alt=media" alt="Reviewer menu on a Section&#x27;s Human Review block, with Any member can review, Current user, and teammates listed, and Maya Chen selected"><figcaption><p>Adicione Human Review no final de uma Section. As revisões aparecem na Inbox.</p></figcaption></figure>

{% hint style="info" %}
O encaminhamento condicional nativo para vários revisores ainda não está disponível. A solução atual é uma Section por revisor, com lógica de salto nas instruções da Section. Por exemplo: "Se a complexidade não for 3, salte esta Section."
{% endhint %}

## 5. Declarar Artifacts

Os Artifacts são as saídas persistentes produzidas por um Playbook. Declare um quando um resultado precisar de ser armazenado, revisto, partilhado, reutilizado a jusante ou publicado após o fim da Session.

Os tipos de Artifact suportados incluem:

* Markdown
* HTML
* JSON
* CSV
* PNG
* JPG
* GIF

Dê a cada Artifact um nome claro e depois referencie-o a partir da Section que o deve escrever. Se uma Section não produzir um Artifact, o seu conteúdo permanece no contexto da Session.

Para links estáveis, comentários, sugestões, menções, Edit with AI, histórico de versões e reutilização de Grid, consulte [Artefactos](https://docs.airops.com/docs/pt/acoes/playbooks/artifacts.md).

## 6. Configurar um Trigger

Os Triggers determinam como um Playbook se inicia.

| Acionador     | Como funciona                                                                                                                             | Ideal para                                                                                        |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Agendamento   | Executa-se com uma cadência recorrente, como todas as segundas-feiras às 9h.                                                              | Auditorias semanais de conteúdo, verificações de atualidade do Brand Kit, relatórios recorrentes. |
| Webhook       | Inicia quando um sistema externo envia um pedido HTTP para o URL de webhook do Playbook.                                                  | Eventos de publicação em CMS, submissões de formulários, integrações de terceiros.                |
| Monitorização | Usa o Parallel Web Systems para verificar uma consulta de monitorização a cada 12 horas e inicia o Playbook quando a condição é detetada. | Alertas competitivos, monitorização de mercado, monitorização da saúde do conteúdo.               |
| AEO Insight   | Inicia quando os limiares ativados do AEO Insight são atingidos, como mudanças na taxa de menções, quota de voz ou taxa de citações.      | Atualização programática, resposta competitiva, lacunas de cobertura do AEO.                      |

{% hint style="info" %}
Os Triggers podem usar **Predefinido** ou uma versão fixada do Playbook. **Predefinido** segue a versão publicada atual. Um Trigger fixado continua a usar a versão selecionada até o alterar. Se uma nova versão alterar os Inputs, atualize a configuração de Inputs do Trigger antes de depender de execuções futuras. Consulte [Acionadores de Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/triggers.md) para ver os passos de configuração e exemplos de payload de webhook.
{% endhint %}

## 7. Use o Quill para iterar

O Quill é o capitão agente da AirOps para a criação de Playbooks. Clique no botão flutuante verde no canto inferior direito do editor.

[Quill](https://docs.airops.com/docs/pt/quill.md) pode:

* Editar o seu Playbook a partir de prompts em linguagem natural.
* Reescrever um prompt de Workflow como uma breve instrução de agente com contexto.
* Usar anexos de ficheiros e imagens para atualizar o Playbook ou o Brand Kit.
* Analisar a estrutura do Playbook e sugerir reorganizações.

Dê ao Quill o contexto completo desde o início. No chat, **Enter** enviar, por isso mantenha cada instrução num único parágrafo.

Duplique um Playbook antes de uma grande reescrita estrutural para ter um ponto de reversão limpo.

## Verificar o estado do Playbook

Rever **Estado** na lista de Playbooks ou abra o controlo de Estado no editor para ver as verificações que precisam de atenção antes de publicar ou executar o Playbook.

## 8. Publicar

Publicar cria um instantâneo versionado que os consumidores a jusante podem executar a partir de Grids e Triggers. Use um Trigger de Webhook quando um sistema externo deva iniciar um Playbook programaticamente. Os rascunhos continuam editáveis. As versões publicadas são referências executáveis.

Se alterou os Inputs, atualize quaisquer mapeamentos de Grid e a configuração de Inputs do Trigger que utilizem este Playbook antes de executar em escala.

### Restaurar uma versão anterior

Abra o histórico de versões no editor do Playbook, selecione a versão pretendida e clique em **Restaurar**. A AirOps copia essa versão para o rascunho atual para que a possa rever antes de publicar.

Restaurar uma versão substitui o rascunho atual. Descarregue ou publique quaisquer alterações do rascunho que precise de manter antes de restaurar uma versão mais antiga.

A restauração está disponível nos planos Free, Starter, Pro, Pro Plus e Platform.

## Importar ou exportar um Playbook

O editor pode descarregar um Playbook como Markdown ou JSON. Também pode importar Markdown ou JSON para um Playbook existente.

{% hint style="warning" %}
Importar Markdown ou JSON substitui o conteúdo atual do Playbook. Descarregue primeiro o Playbook existente se precisar de um ponto de reversão.
{% endhint %}


---

# 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/acoes/playbooks/build-a-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.
