> 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 Entradas, Secções, Ferramentas, Artefactos, blocos de Revisão Humana e Gatilhos. Defina cada parte claramente para que o agente tenha o contexto certo e os revisores tenham os pontos de controlo certos. ## Escolha um modelo Use a funcionalidade **Modelo** seletor no editor do Playbook para escolher **Auto** ou um modelo disponível. As opções apresentadas dependem do seu espaço de trabalho e dos fornecedores disponíveis. **GPT-6 Sol**, **GPT-6 Luna**, e **Claude Opus 5.5** estão disponíveis no seletor. Escolha Sol ou Opus 5.5 para trabalho complexo, ou Luna quando a velocidade e o custo forem mais importantes. ### Comparar classificações de modelos Expanda um modelo para ajustar o seu **esforço de raciocínio** suportado e comparar as classificações disponíveis para essa seleção: | Classificação | O que mais barras significa | | ------------------------ | --------------------------------------------------------------------------- | | **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 os dados de benchmark estão disponíveis. Alguns modelos e definições de esforço não têm classificações. Trate as barras como orientação comparativa: o seu Playbook, Entradas e Ferramentas afetam o tempo de execução real, o uso de tarefas e a qualidade da saída. O Auto não tem um benchmark fixo de modelo e esforço. ## 1. Definir Entradas As Entradas são a forma como um Playbook recebe informações em tempo de execução. | Digite | Usar para | | --------- | --------------------------------------------------------------------------------- | | Texto | Palavras-chave, URLs, prompts, strings de texto livre. | | Número | Contagens, limites, classificações. | | Ficheiro | Documentos, briefings e exportações que o Playbook deve ler durante uma execução. | | Brand Kit | Voz, regras de escrita, públicos, regiões e diretrizes visuais. | Clique em **Mostrar definições avançadas** numa Entrada para definir o nome da variável, descrição, placeholder e valor predefinido. ## 2. Definir Secções As Secções são a espinha dorsal estrutural de um Playbook. Cada Secção contém instruções e pode, opcionalmente, terminar com um bloco de Revisão Humana. Organize as Secções por fase lógica, não por revisor. Um pipeline de conteúdo pode usar: 1. **Ingestão e validação:** Analisar a Entrada, validá-la e reunir contexto. 2. **Pesquisa e estratégia:** Pesquisar Bases de Conhecimento, analisar SERPs e rever concorrentes. 3. **Compilação do briefing:** Sintetizar a pesquisa num briefing acionável. 4. **Rascunho do artigo e ligação interna:** Gerar o conteúdo e adicionar ligações internas. 5. **Revisão final:** Pausar para Revisão Humana antes de publicar. Os modelos usam uma estrutura consistente dentro de cada Secção. Use este padrão como ponto de partida e depois adapte-o ao trabalho: * **Objetivo:** Defina o que a Secção deve alcançar. * **Entradas e referências:** Nomeie as Entradas, Artefactos, campos do Brand Kit, Ferramentas e Bases de Conhecimento que a Secção deve usar. Insira-os pelo menu de barra quando possível. * **Instruções:** Liste o trabalho em passos numerados claros. * **Saída:** Nomeie o Artefacto que a Secção deve escrever e o formato que deve usar. ## 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 nas instruções do Playbook. Entradas, Artefactos e Ferramentas tornam-se mais fáceis de reutilizar quando os insere pelo menu de barra em vez de escrever os nomes manualmente. Para o catálogo completo de Ferramentas, Conectores MCP e boas práticas, consulte [Ferramentas](/docs/pt/acoes/playbooks/tools.md). ### AirOps * **AirOps MCP:** Aceda aos seus dados da AirOps, incluindo dados de Insights, Brand Kits, Bases de Conhecimento 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 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:** Extrair conteúdo de páginas web. ### Pesquisa de SEO * **DataForSEO:** Dados de SEO e pesquisa de palavras-chave. * **Moz:** SEO e análise de domínios. * **Google Search Console:** Dados do GSC. ### Pesquisa na web * **Google Search:** Pesquisar e obter resultados do Google. * **Parallel Web Systems:** Use a API Parallel Search, a API Parallel Extract e a API Parallel Task para realizar pesquisa na web, extrair dados estruturados de URLs e processar entradas de pesquisa em saídas estruturadas. * **Firecrawl:** Rastrear e extrair páginas web. * **Reddit:** Para mais detalhes, [Fale com 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](/docs/pt/acoes/playbooks/tools/image-and-video.md) para orientação sobre os modelos. * **Imagens de stock:** Pesquise no Getty Images ou no Unsplash e, depois, obtenha uma imagem selecionada pelo ID para uso num Artefacto ou numa etapa de publicação. ### Gestão do Conhecimento * **Slack:** Leia o histórico do canal e envie mensagens. * **Google Docs:** Ler e editar documentos do Google Docs. ### Enriquecimento B2B * **Brandfetch:** Obter ativos de marca e informações. * **Hunter.io:** Encontrar e verificar endereços de email. Para mais detalhes, [Fale com Vendas](https://www.airops.com/book-a-call). ### Anúncios * **OpenAI Ads:** Obtenha o desempenho da conta. Crie e gerencie campanhas, grupos de anúncios e anúncios quando as ferramentas de escrita estiverem ativadas. Consulte [Ferramentas de Anúncios](/docs/pt/acoes/playbooks/tools/ads.md) para disponibilidade e etapas de revisão. Pode adicionar qualquer Conector MCP de que precise nas definições de Conectores MCP do seu espaço de trabalho. As ferramentas MCP ligadas aparecem na lista Ferramentas do editor do Playbook. {% hint style="info" %} Quando adicionar uma etapa de pesquisa numa Base de Conhecimento, faça referência à Base de Conhecimento pelo nome no seletor de Base de Conhecimento da etapa. Não dependa da seleção automática quando o Playbook precisar de uma fonte específica. {% endhint %} ## 4. Adicionar Revisão Humana Coloque a Revisão Humana como um bloco no final de uma Secção existente. Não crie uma Secção separada apenas para revisão. Use a Revisão Humana quando alguém precisar de aprovar texto, escolher entre opções ou editar o resultado gerado antes de a próxima Secção 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 espaço de trabalho pode rever. As revisões aparecem na Caixa de Entrada. {% hint style="info" %} O encaminhamento condicional nativo para vários revisores ainda não está disponível. A solução atual é uma Secção por revisor, com lógica de salto nas instruções da Secção. Por exemplo: "Se a complexidade não for 3, ignore esta Secção." {% endhint %} ## 5. Declarar Artefactos Os Artefactos são os resultados persistentes que um Playbook produz. Declare um quando um resultado precisar de ser armazenado, revisto, partilhado, reutilizado a jusante ou publicado após o fim da Sessão. Os tipos de Artefacto suportados incluem: * Markdown * HTML * JSON * CSV * PNG * JPG * GIF Dê a cada Artefacto um nome claro e depois faça referência a ele na Secção que deve escrever nele. Se uma Secção não produzir um Artefacto, o seu conteúdo permanece no contexto da Sessão. Para links estáveis, comentários, sugestões, menções, Editar com IA, histórico de versões e reutilização em Grid, consulte [Artefatos](/docs/pt/acoes/playbooks/artifacts.md). ## 6. Configurar um Gatilho Os Gatilhos determinam como um Playbook inicia. | Acionador | Como funciona | Ideal para | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | Agendamento | Executa-se numa 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 do webhook do Playbook. | Eventos de publicação do 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. | | Insight de AEO | Inicia quando os limiares ativados do AEO Insight são cumpridos, como alteração na taxa de menções, quota de voz ou taxa de citações. | Atualização programática, resposta competitiva, lacunas de cobertura de AEO. | {% hint style="info" %} Os Gatilhos podem usar **Predefinido** ou uma versão fixa do Playbook. **Predefinido** segue a versão publicada atual. Um Gatilho fixo continua a usar a versão selecionada até a alterar. Se uma nova versão alterar as Entradas, atualize a configuração das Entradas do Gatilho antes de confiar em execuções futuras. Consulte [Gatilhos de Playbook](/docs/pt/acoes/playbooks/triggers.md) para passos de configuração e exemplos de payload de webhook. {% endhint %} ## 7. Use o Quill para iterar O Quill é o capitão de agentes da AirOps para a criação de Playbooks. Clique no botão verde flutuante no canto inferior direito do editor. [Quill](/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. * Use anexos de ficheiro e imagem para atualizar o Playbook ou o Brand Kit. * Raciocinar sobre a estrutura do Playbook e sugerir reorganizações. Dê ao Quill o contexto completo desde o início. No chat, **Enter** submete, 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 a saúde do Playbook Rever **Saúde** na lista de Playbooks ou abra o controlo de Saúde no editor para ver as verificações que requerem atenção antes de publicar ou executar o Playbook. ## 8. Publicar A publicação cria um instantâneo versionado que os consumidores a jusante podem executar a partir de Grids e Gatilhos. Use um Gatilho 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 as Entradas, atualize quaisquer mapeamentos de Grid e a configuração das Entradas do Gatilho que usem este Playbook antes de executar em grande escala. ### Restaurar uma versão anterior Abra o histórico de versões a partir do editor do Playbook, selecione a versão pretendida e clique **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. Faça download ou publique quaisquer alterações de rascunho que precise de manter antes de restaurar uma versão mais antiga. Restaurar está disponível nos planos Free, Starter, Pro, Pro Plus e Platform. ## Importar ou exportar um Playbook O editor pode descarregar um Playbook em 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=&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.