> 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.md).

# Playbooks

Crie e execute Playbooks com instruções em linguagem natural

Os Playbooks permitem descrever o trabalho como instruções em linguagem natural, anexar contexto como um Brand Kit e executar o processo de ponta a ponta, mantendo os revisores a par.

{% hint style="warning" %}
Os Playbooks não podem ser usados dentro de Workflows. Pode criar um Playbook a partir de um Workflow existente, mas não pode adicionar um Playbook como um passo de Workflow.
{% endhint %}

Um Playbook é composto por:

* **Um Playbook em estilo de documento** que descreve o que o agente deve fazer.
* **Entradas** que o Playbook aceita em tempo de execução, como texto, números, ficheiros ou um Brand Kit.
* **Secções** que contêm instruções, chamadas de ferramentas e pontos de controlo de Revisão Humana.
* **Ferramentas** que o agente pode usar, incluindo SEO Research, Web Research, Image and Video, MCP Connectors e muito mais.
* **Artefactos** que o Playbook produz, como ficheiros Markdown, HTML, JSON, CSV, PNG, JPG ou GIF.
* **Acionadores** que determinam como um Playbook é iniciado, incluindo Schedule, Webhook, Monitor e AEO Insight quando ativado.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1f84287eb1edf5ffbbdd31bcc303a5bae367ce29%2Fplaybooks-01-list.png?alt=media" alt="Playbooks tab under Actions listing five SpaceOps Playbooks with their Health, Model, Version, Triggers, and Last Edited details"><figcaption><p>A lista de Playbooks mostra a saúde, a versão e os acionadores de cada Playbook.</p></figcaption></figure>

## Conceitos-chave

| Termo                  | Definição                                                                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Playbook               | A definição do agente com Entradas, Secções, Ferramentas, Artefactos e um Acionador. Executar um Playbook produz uma Sessão.                                        |
| Secção                 | Uma unidade de trabalho num Playbook. Cada Secção pode incluir instruções, chamadas de ferramentas e um bloco de Revisão Humana.                                    |
| Entrada                | Informação que fornece quando um Playbook é executado, como uma palavra-chave, URL de destino, carregamento de ficheiro ou Brand Kit.                               |
| Ferramenta             | Uma ação que o agente pode realizar, desde pesquisa na web e SEO até ferramentas nativas como o Slack e ferramentas fornecidas pelos conectores MCP.                |
| Artefacto              | Um resultado persistente que o Playbook produz, como um artigo de blogue, imagem, análise ou dados estruturados.                                                    |
| Acionador              | Uma condição que inicia automaticamente um Playbook. Os tipos de acionador incluem Schedule, Webhook, Monitor e AEO Insight quando ativado.                         |
| Sessão                 | Uma única execução de Playbook. Cada Sessão produz Artefactos e regista o trabalho realizado pelo agente.                                                           |
| Caixa de entrada       | A fila ao nível do espaço de trabalho onde os revisores veem os passos pendentes de Revisão Humana e os resultados da Sessão que precisam de atenção.               |
| Histórico de execuções | O registo de todas as Sessões produzidas por um Playbook.                                                                                                           |
| Revisão Humana         | Um ponto de pausa onde uma pessoa deve aprovar ou editar o trabalho do agente antes de ele continuar.                                                               |
| Quill                  | o capitão agente da AirOps que o ajuda a criar e editar Playbooks a partir de prompts em linguagem natural. Veja [Quill](https://docs.airops.com/docs/pt/quill.md). |

## As duas fontes de contexto que impulsionam a qualidade

Antes de criar um Playbook, certifique-se de que o AirOps Insights e o seu Brand Kit estão atualizados. Estas duas fontes de contexto moldam a qualidade de cada Sessão.

### Configurar o AirOps Insights

O AirOps Insights é a fonte de dados de visibilidade de pesquisa de IA, incluindo prompts monitorizados, respostas de pesquisa de LLM, citações, presença da concorrência e oportunidades de conteúdo. Quando um Playbook pesquisa oportunidades de AEO ou respostas de pesquisa de LLM, deve usar os dados monitorizados no AirOps Insights em vez de tratar a pesquisa de IA como uma pesquisa web genérica.

Cubra os tópicos, personas, regiões e etapas do funil que lhe interessam. Amplie a cobertura a partir de fontes como consultas do Google Search Console, linguagem de chamadas de vendas, tickets de suporte e lacunas de citações dos concorrentes.

O padrão comum é: o AirOps Insights monitoriza prompts e respostas de pesquisa de LLM, um Playbook monitoriza esses dados e encontra oportunidades, depois um segundo Playbook atua e cria ou atualiza a saída.

### Mantenha o seu Brand Kit atualizado

Cada Playbook pode herdar o seu Brand Kit, por isso alterações à voz, regras de escrita, públicos, regiões, linhas de produto, diretrizes visuais e contexto dos concorrentes passam para a saída do Playbook. Um Brand Kit desatualizado degrada a saída subsequente.

Audite o Brand Kit regularmente. Atualize-o quando lançar um produto, alterar o posicionamento, adicionar um novo público ou expandir para uma nova região.

Utilize [Atualização do Brand Kit](https://docs.airops.com/docs/pt/contexto/brand-kit/refresh.md) para monitorizar fontes em tempo real e propor edições ao Brand Kit para aprovação humana.

{% hint style="warning" %}
Use o novo formato de Brand Kit com Playbooks. Os Brand Kits legados não funcionam tão bem com Playbooks e podem reduzir a qualidade da saída.
{% endhint %}

## Anatomia de um Playbook

Quando abrir o editor de Playbook, verá:

* Uma linha de chips no cabeçalho acima da primeira Secção, mostrando Ferramentas, Entradas, Artefactos e **Adicionar Acionador**.
* Ações no canto superior direito para **Executar Playbook**, **Publicar**, e **Histórico de execuções**.
* **Quill, o capitão agente da AirOps,** como um botão flutuante verde no canto inferior direito do editor.
* Referencie chips inline à medida que escreve. Entradas e Brand Kits aparecem como chips verdes. As Ferramentas aparecem como chips cinzentos com ícones.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1d6bffb9013f3eaa2d2b627f82288c30362413b4%2Fplaybooks-02-editor-anatomy.png?alt=media" alt="Playbook editor with the header chip row, Run Playbook, Publish, and Run History actions, Input and Tool pills, and the Quill button"><figcaption><p>O editor de Playbook: chips no cabeçalho, ações no canto superior direito, referências inline e Quill.</p></figcaption></figure>

Digite `/` em qualquer Secção para abrir o menu de barra diagonal. O menu de barra diagonal apresenta Ferramentas, Entradas, Artefactos e outras referências que pode inserir nas suas instruções.

## Guias de Playbook

* [Criar um Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/create-a-playbook.md)
* [Construir um Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/build-a-playbook.md)
* [Trabalhar com Artefactos](https://docs.airops.com/docs/pt/acoes/playbooks/artifacts.md)
* [Ferramentas](https://docs.airops.com/docs/pt/acoes/playbooks/tools.md)
* [Executar um Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/run-a-playbook.md)
* [Acionadores de Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/triggers.md)
* [Ligar Playbooks a outras ferramentas](https://docs.airops.com/docs/pt/acoes/playbooks/integrations.md)
* [Aplicar as melhores práticas de Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/best-practices.md)
* [Resolver problemas de Playbooks](https://docs.airops.com/docs/pt/acoes/playbooks/troubleshooting.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/acoes/playbooks.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.
