🧱 As 7 partes obrigatórias
Todo playbook tem o mesmo esqueleto. Quando você decora as 7 seções, escreve playbook novo em 2 horas — não em 2 dias. Cada seção responde a uma pergunta que a IA fará no momento de agir.
Por que CADA seção importa
- 1. Contexto → tom e vocabulário
- 2. Objetivo → recorta o escopo
- 3. Entradas → IA reconhece o input
- 4. Regras → comportamento previsível
As 3 últimas blindam
- 5. Exemplos → resolvem ambiguidade
- 6. Formato → integração não quebra
- 7. Limites → previne dano
🗣️ Linguagem que IA entende
A IA segue padrões. Linguagem clara reduz alucinação; linguagem vaga produz resposta inventada. Três regras: imperativo > descritivo, exemplo > explicação, regra explícita > bom senso.
✗ Vago — IA inventa
✓ Imperativo — IA obedece
📋 Banimentos no playbook
- ✗"Use bom senso" — IA não tem bom senso, tem padrão estatístico.
- ✗"Seja natural" — natural para quem?
- ✗"Resolva como puder" — abre porta para alucinação.
- ✗"Adapte conforme necessário" — gera comportamento errático.
💡 Dica prática
Releia seu playbook procurando advérbios vagos ("simpaticamente", "naturalmente", "rapidamente"). Cada um é uma armadilha. Troque por critério mensurável: "responda em até 3 linhas", "use o primeiro nome", "comece com 'Olá'".
🎬 Exemplos resolvidos (few-shot)
Para cada situação típica, mostre entrada real e saída correta. 3-5 exemplos diversos curam 70% dos erros de tom e formato. É mais rápido escrever 5 exemplos do que descrever 50 regras.
FAQ direta. Estabelece o tom esperado.
Ambíguo ou borda. Mostra como balancear.
Caso em que IA reconhece limite e escala.
💡 Dica prática
Peça ao dono 5 capturas de tela de conversas reais (com clientes diferentes) e use como base. Exemplo de verdade tem peso 10x maior que exemplo inventado.
📐 Formato de saída fixo
Se a saída vai para humano (WhatsApp, e-mail), texto curto. Se vai para sistema (Sheets, CRM, n8n), JSON com campos nomeados. Sem formato fixo, integração quebra.
⚙️ Por que JSON é regra para n8n/Make
- • Cada campo do JSON vira variável no próximo node (parse automático).
- • Você consegue rotear (if/then) por campo: "se para_humano = true, mande para fila".
- • Sheets/Airtable recebem colunas certas sem código.
- • Logs ficam estruturados, fáceis de auditar depois.
💡 Dica prática
No prompt da IA, termine sempre com: "Responda APENAS com JSON válido, sem texto antes ou depois." É a frase que evita 90% dos erros de parse no n8n.
📂 Onde mora o playbook
Playbook não pode morar dentro do prompt do n8n ou só na sua cabeça. Ele é documento vivo do cliente — onde a equipe lê, revisa e edita.
📘 Notion (recomendado)
- • 1 página dedicada por agente
- • Sub-páginas: FAQ, exemplos, histórico
- • Comentários e menções no time
- • Bom para empresa que já usa Notion
- • Histórico de versões nativo
📄 Google Docs
- • 1 doc por agente na mesma pasta
- • Comentários inline
- • Histórico de versões automático
- • Familiaridade total do dono
- • Compartilhamento simples por link
🚫 Nunca aqui
- • Apenas dentro do prompt no n8n — dono não acessa, não revisa.
- • Em PDF — não edita, vira reliquia em uma semana.
- • No seu computador — cliente fica refém de você.
- • Em vários lugares — verdade fragmentada gera bug.
💡 Dica prática
No playbook do n8n, coloque sempre um link para o documento oficial no topo do prompt. Quando a versão mudar no Notion/Docs, atualize a referência no n8n e versione.
🔁 Versionamento e iteração
Toda mudança é uma versão nova. Sem histórico, depuração vira adivinhação. Quando o agente errar (e vai errar), você precisa saber qual versão do playbook ele seguia.
✓ Faça em toda mudança
- • Incrementa versão (1.0 → 1.1)
- • Anota data e autor
- • Resume mudança em 1 linha
- • Comunica ao dono (mensagem curta)
- • Atualiza link no n8n se necessário
📐 Convenção simples
- • +0.1: ajuste pequeno (tom, exemplo)
- • +1.0: muda comportamento amplo
- • Cabeçalho mostra a versão ativa
- • Rodapé mostra o histórico todo
💡 Dica prática
No log do n8n, grave em cada execução "playbook_version: X.Y". Quando o cliente reclamar "o bot respondeu errado essa semana", você abre o log, vê a versão e a regra exata que disparou — debug em minutos, não em horas.