Conteúdo detalhado
🎭 Persona e tom
Persona é a primeira coisa que o usuário sente — antes mesmo de ler resposta nenhuma. Defina nome, papel, vocabulário e nível de formalidade com a mesma seriedade com que se define um cargo no time.
# Identidade Nome: Sofia Papel: Corretora digital da Imobiliária Vivenda Idade aparente: 30s, profissional experiente Tom: empático, direto, sem rodeio, sem emojis em excesso Idioma: pt-BR (você, não tu) Nunca: gírias datadas, vocabulário técnico desnecessário
💡 Quanto mais concreta, melhor
Persona vaga ("seja simpático") vira atendimento genérico. Persona concreta ("Sofia, corretora 30s, fala como uma amiga que entende do mercado") vira marca.
⛔ Regras invioláveis
Regras são o que impede a crise pública. Não confie em "o modelo sabe que não deve". Explicite. Coloque no final do prompt (recency) e em maiúsculas quando crítico.
✓ Regras úteis
- ✓Nunca dê preço sem consultar tool
- ✓Nunca prometa prazo de entrega
- ✓Sempre confirme dados sensíveis antes de gravar
- ✓Nunca discuta política/religião
- ✓Se for ofendido, registre e encerre educadamente
✗ Regras inúteis
- ✗"Seja sempre útil" (vago)
- ✗"Não invente" (sem dizer como)
- ✗"Use bom senso" (modelo não tem)
- ✗100 regras sem ordem de prioridade
- ✗Regras que contradizem outras
📐 Formato de resposta
Formato consistente vira UX consistente. Defina tamanho máximo, uso de bullets, emojis, quebra de linha. WhatsApp aceita formato diferente de chat web.
Resposta curta vence sempre em chat. Bot prolixo cansa.
Listas com mais de 5 itens viram parede. Máx 3.
Mais que isso parece spam. Use só para sinalizar status.
Negrito para palavra-chave. Sem títulos H1/H2 em chat.
🧪 Few-shot examples
Exemplo vale mais que mil instruções abstratas. Coloque 2–5 trocas exemplo no prompt mostrando exatamente o comportamento esperado em casos comuns e em casos difíceis.
# Exemplos de boa interação [Usuario]: oi [Sofia]: Oi, Marina! Tudo bem? Como posso ajudar hoje? [Usuario]: quero apto 2 quartos [Sofia]: Perfeito! Em qual região da cidade você procura? [Usuario]: quanto custa o aluguel mesmo do imovel 1023? [Sofia]: Vou checar agora. [chama detalhar_imovel(id=1023)] [Usuario]: voce eh real? [Sofia]: Sou uma assistente virtual da Vivenda. Mas posso resolver busca, agendamento e dúvidas — e se precisar, te conecto com um corretor humano em segundos.
🪜 Hierarquia de instruções
Modelos prestam mais atenção no começo e no fim. Estrutura recomendada: missão e identidade no topo; tools e regras críticas no rodapé. O meio é onde a atenção mais cai ("lost in the middle").
1. Identidade e missão
Quem é o bot, qual o objetivo principal. Topo do prompt.
2. Conhecimento de contexto
Resumo do negócio, glossário de termos internos.
3. Tools disponíveis
Lista + quando usar cada uma.
4. Estilo e formato
Tom, comprimento, uso de listas/emoji.
5. Few-shot examples
2-5 trocas que ancoram o comportamento.
6. Regras invioláveis
Rodapé. Recency garante que o modelo lembre.
🔁 Iterar com base em logs
Prompt sem ciclo de melhoria envelhece em 2 semanas. O loop: pegue conversas ruins reais, identifique a regra ausente, adicione, teste contra um eval set fixo, deploy.
🧪 Loop de melhoria do prompt
Toda mudança no prompt deve ser:
- •Motivada por log real, não por opinião
- •Testada contra eval set (20-50 casos críticos)
- •Comparada com a versão anterior (A/B em produção)
- •Versionada (sim, prompt em git)
- •Documentada — o que mudou e por quê
⚠️ Versione prompt
Prompt sem versionamento é o erro mais barato de cometer e o mais caro de pagar. Você muda uma linha, qualidade despenca em prod, e ninguém sabe o que era ontem.
📌 Resumo do módulo
Próximo:
2.2 — 🔌 Conectando conhecimento e ferramentas