> 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 informados. {% hint style="warning" %} Os Playbooks não podem ser usados dentro de Workflows. Você pode criar um Playbook a partir de um Workflow existente, mas não pode adicionar um Playbook como uma etapa 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, arquivos ou um Brand Kit. * **Seções** que contêm instruções, chamadas de ferramentas e pontos de controle de Revisão Humana. * **Ferramentas** que o agente pode usar, incluindo Pesquisa de SEO, Pesquisa na Web, Imagem e Vídeo, Conectores MCP e muito mais. * **Artefatos** que o Playbook produz, como arquivos Markdown, HTML, JSON, CSV, PNG, JPG ou GIF. * **Gatilhos** que determinam como um Playbook é iniciado, incluindo Agendamento, Webhook, Monitor e AEO Insight, quando ativado. ## Conceitos-chave | Termo | Definição | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Playbook | A definição do agente com Entradas, Seções, Ferramentas, Artefatos e um Gatilho. Executar um Playbook produz uma Sessão. | | Seção | Uma unidade de trabalho em um Playbook. Cada Seção pode incluir instruções, chamadas de ferramentas e um bloco de Revisão Humana. | | Entrada | Informações que você fornece quando um Playbook é executado, como uma palavra-chave, URL de destino, upload de arquivo ou Brand Kit. | | Ferramenta | Uma ação que o agente pode executar, desde pesquisas na web e de SEO até ferramentas nativas como o Slack e ferramentas fornecidas por Conectores MCP. | | Artefato | Uma saída persistente que o Playbook produz, como um post de blog, imagem, análise ou dados estruturados. | | Acionador | Uma condição que inicia um Playbook automaticamente. Os tipos de gatilho incluem Agendamento, Webhook, Monitor e AEO Insight, quando ativado. | | Sessão | Uma única execução do Playbook. Cada Sessão produz Artefatos e registra o trabalho realizado pelo agente. | | Caixa de entrada | A fila no nível do espaço de trabalho onde os revisores veem as etapas de Revisão Humana pendentes e os resultados de Sessão que precisam de atenção. | | Histórico de execuções | O registro de cada Sessão produzida por um Playbook. | | Revisão Humana | Um ponto de pausa em que uma pessoa deve aprovar ou editar o trabalho do agente antes que ele continue. | | Quill | O capitão agente da AirOps que ajuda você a criar e editar Playbooks a partir de prompts em linguagem natural. Veja [Quill](/docs/pt/quill.md). | | Memória | Persistência entre Sessões, usada quando um Playbook precisa se lembrar do que já apresentou ou concluiu. | ## 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 estejam atualizados. Essas duas fontes de contexto moldam a qualidade de cada Sessão. ### Configure o AirOps Insights O AirOps Insights é a fonte de dados de visibilidade de pesquisa por IA, incluindo prompts monitorados, respostas de busca de LLM, citações, presença de concorrentes e oportunidades de conteúdo. Quando um Playbook pesquisa oportunidades de AEO ou respostas de busca de LLM, ele deve usar os dados monitorados no AirOps Insights em vez de tratar a pesquisa por IA como uma pesquisa genérica na web. Cubra os tópicos, personas, regiões e etapas do funil que são importantes para você. Expanda 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 de concorrentes. O padrão comum é: o AirOps Insights rastreia prompts e respostas de busca de LLM, um Playbook monitora esses dados e encontra oportunidades, e então um segundo Playbook toma ações e cria ou atualiza o resultado. ### Mantenha seu Brand Kit atualizado Todo Playbook pode herdar o seu Brand Kit, então mudanças em tom de voz, regras de escrita, públicos, regiões, linhas de produto, diretrizes visuais e contexto de concorrentes entram no resultado do Playbook. Um Brand Kit desatualizado prejudica o resultado posterior. Audite o Brand Kit em uma cadência recorrente. Atualize-o quando lançar um produto, mudar o posicionamento, adicionar um novo público ou expandir para uma nova região. Use [Atualização do Brand Kit](/docs/pt/contexto/brand-kit/refresh.md) para monitorar fontes em tempo real e propor edições no 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 Ao abrir o editor de Playbooks, você verá: * Uma linha de chips de cabeçalho acima da primeira Seção mostrando Ferramentas, Entradas, Artefatos e **Adicionar gatilho**. * 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. * Use chips de referência inline enquanto escreve. Entradas e Brand Kits aparecem como chips verdes. Ferramentas aparecem como chips cinza com ícones. Digite `/` em qualquer Seção para abrir o menu de barra. O menu de barra exibe Ferramentas, Entradas, Artefatos e outras referências que você pode inserir nas suas instruções. ## Guias de Playbook * [Criar um Playbook](/docs/pt/acoes/playbooks/create-a-playbook.md) * [Construir um Playbook](/docs/pt/acoes/playbooks/build-a-playbook.md) * [Trabalhar com Artefatos](/docs/pt/acoes/playbooks/artifacts.md) * [Ferramentas](/docs/pt/acoes/playbooks/tools.md) * [Executar um Playbook](/docs/pt/acoes/playbooks/run-a-playbook.md) * [Gatilhos de Playbook](/docs/pt/acoes/playbooks/triggers.md) * [Conectar Playbooks a outras ferramentas](/docs/pt/acoes/playbooks/integrations.md) * [Aplicar as melhores práticas de Playbook](/docs/pt/acoes/playbooks/best-practices.md) * [Solucionar problemas de Playbooks](/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=&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.