> 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 Brand Kit e a cobertura de Prompt

Uma Brand Kit atualizada e uma cobertura completa de prompts são as duas maiores alavancas de qualidade. Confirme ambas antes de otimizar a estrutura do Playbook.

## Comece com menos instruções

Dê ao agente orientação suficiente para compreender o objetivo e depois adicione 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 compreenda o objetivo, o revisor consiga analisar rapidamente o trabalho e as secções seguintes saibam que Artifact usar.

Uma secção forte normalmente inclui:

* **Objetivo:** Uma ou duas frases que definem o que esta secção deve alcançar.
* **Inputs e referências:** Os campos de Inputs, Artifacts, Brand Kit, Tools ou Knowledge Bases que a secção deve usar. Insira-os com o menu de barra oblíqua sempre que possível.
* **Instruções:** Etapas numeradas para o trabalho que o agente deve realizar. Mantenha-as centradas em decisões, restrições e preferências de fontes.
* **Saída:** O Artifact que a secção deve escrever, mais o formato exigido, como um relatório em Markdown, um mapa JSON ou o artigo final.

Use o mesmo padrão em todas as secções. Por exemplo, uma secção de pesquisa pode indicar o objetivo, referenciar o prompt-alvo e a Brand Kit, listar as etapas de pesquisa e depois escrever as conclusões em **AI & Google Results.md**. Uma secção de redação pode referenciar **Content Outline.md** quanto 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 controlo

Adicione uma secção quando precisar de:

* Um Artifact discreto.
* Uma pausa para revisão humana.
* Um ponto de referência claro para secções posteriores.

## Escreva Artifacts apenas quando precisar de persistência

O contexto é transferido automaticamente entre secções. Use Artifacts quando um resultado precisar de ser armazenado, partilhado ou referenciado mais tarde.

## Consulte Knowledge Bases pelo nome

Escolha a Knowledge Base específica no seletor de Knowledge Base da etapa. A seleção automática ou a pesquisa em todas as Knowledge Bases pode obter dados da fonte errada.

## Consulte Artifacts pelo nome

Os nomes dos Artifacts são estáveis. Os nomes de ficheiros podem mudar. Use o menu de barra oblíqua para inserir referências a Artifacts pelo nome nas secções seguintes.

## Mantenha a publicação separada da criação de conteúdo

Use os 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 de campos do CMS e o acompanhamento da publicação.

Quando um Playbook ou um CMS MCP publica ou atualiza 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 na IA, citações, menções e tráfego a essa atualização de conteúdo.

## Combine Playbooks para encontrar oportunidades e produzir resultados

Permita que um Playbook monitorize dados e encontre oportunidades e, depois, que um Playbook de ação separado produza 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 contexto completo e peça [Quill](https://docs.airops.com/docs/pt/quill.md) para o traduzir numa instrução concisa para o agente. Depois, reduza o resultado.

## Mantenha as alterações propostas sujeitas a revisão humana

Os Playbooks bem concebidos sugerem alterações para aprovação humana em vez de as aplicar automaticamente quando o julgamento é importante. Este padrão cria 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=<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.
