> 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/best-practices.md). # Boas práticas Orientação prática para criar Playbooks fiáveis Use estas práticas para tornar os Playbooks mais fáceis de executar, rever e melhorar. ## Comece com a cobertura do Brand Kit e dos Prompts Um Brand Kit atual e uma cobertura completa dos Prompts são as duas maiores alavancas de qualidade. Confirme ambos antes de otimizar a estrutura do Playbook. ## Comece com menos instruções Dê ao agente orientação suficiente para compreender o objetivo e, depois, acrescente restrições onde precisar de comportamento previsível. Instruções excessivamente prescritivas podem reduzir a capacidade do agente de raciocinar sobre casos-limite. ## Organize as Secções por fase Use fases como **Pesquisa**, **Rascunho**, e **Rever**. Evite organizar as Secções em torno de pessoas, como "Secção do Estratega" ou "Secção do Editor". A estrutura baseada em fases é mais fácil de reutilizar e mais fácil de rever. ## Formate cada Secção de forma consistente Dê a cada Secção uma estrutura interna previsível para que o agente entenda o objetivo, o revisor possa analisar o trabalho rapidamente e as Secções seguintes saibam qual Artefacto usar. Uma Secção forte normalmente inclui: * **Objetivo:** Uma ou duas frases que definem o que esta Secção deve conseguir. * **Entradas e referências:** Os campos de Entradas, Artefactos, Brand Kit, Ferramentas ou Bases de Conhecimento que a Secção deve usar. Insira-os com o menu de barra diagonal sempre que possível. * **Instruções:** Passos numerados para o trabalho que o agente deve executar. Mantenha-os focados em decisões, restrições e preferências de fonte. * **Saída:** O Artefacto que a Secção deve escrever, mais o formato necessário, como um relatório em Markdown, um mapa JSON ou um artigo final. Use o mesmo padrão em todas as Secções. Por exemplo, uma Secção de pesquisa pode indicar o objetivo, fazer referência ao prompt-alvo e ao Brand Kit, listar os passos de pesquisa e, depois, escrever as conclusões em **AI & Google Results.md**. Uma Secção de redação pode fazer referência a **Content Outline.md** como no **Topic Research.md**, listar os requisitos de escrita e, depois, escrever o rascunho em **Article Draft.md**. ## Use as Secções como pontos de verificação Adicione uma Secção quando precisar de: * Um Artefacto distinto. * Uma pausa para Revisão Humana. * Um ponto de referência limpo para Secções posteriores. ## Escreva Artefactos apenas quando precisar de persistência O contexto é transmitido automaticamente entre Secções. Use Artefactos quando um resultado precisar de ser armazenado, partilhado ou referenciado mais tarde. ## Faça referência às Bases de Conhecimento pelo nome Escolha a Base de Conhecimento específica no seletor de Base de Conhecimento do passo. A seleção automática ou a pesquisa em todas as Bases de Conhecimento pode obter informação da fonte errada. ## Faça referência aos Artefactos pelo nome Os nomes dos Artefactos são estáveis. Os nomes dos ficheiros podem mudar. Use o menu de barra diagonal para inserir referências a Artefactos pelo nome em Secções subsequentes. ## Mantenha a publicação separada da criação de conteúdo Use Playbooks para criar, atualizar, rever e preparar conteúdo. Publique a partir de uma coluna da Grid, de um Playbook de publicação separado ou de um CMS MCP após a revisão. Isto torna mais fácil controlar a revisão editorial, o mapeamento dos campos do CMS e o acompanhamento da publicação. Quando um Playbook ou um CMS MCP publicar ou atualizar uma página, use a ferramenta MCP da AirOps `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 visibilidade em IA, citações, menções e tráfego a essa atualização de conteúdo. ## Combine Playbooks de descoberta de oportunidades e de produção de resultados Permita que um Playbook monitorize dados e encontre oportunidades e, depois, deixe um Playbook de ação separado produzir o resultado. Isto torna cada Playbook mais fácil de compreender, rever e iterar. ## Peça ao Quill para traduzir prompts de Workflow Quando migrar um Workflow, cole o prompt original com o contexto completo e peça [Quill](/docs/pt/quill.md) para o traduzir numa instrução concisa para o agente. Depois, ajuste o resultado. ## Mantenha as alterações propostas sujeitas a revisão humana Playbooks bem concebidos sugerem alterações para aprovação humana em vez de as aplicarem automaticamente quando o discernimento é importante. Este padrão gera confiança, deteta casos-limite e mantém as partes interessadas informadas. --- # 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/best-practices.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.