🆔 Bloco 1 — Identidade do agente
Nome, função, empresa, tom de voz. 50-80 palavras max. Sem identidade, agente vira ChatGPT genérico — cliente percebe na 1ª resposta.
📖 Exemplo Polaris
✓ Identidade boa
- • Nome próprio humanizado
- • Empresa explícita
- • Função específica
- • Tom definido
- • Limite claro ("quando não sabe...")
✗ Identidade fraca
- • "Você é um assistente útil"
- • Sem nome de empresa
- • Função genérica
- • Sem tom definido
- • Sem limite
🌍 Bloco 2 — Contexto da empresa
Descrição da empresa: o que vende, para quem, horário, área de cobertura, regras gerais de negócio. 100-200 palavras.
Estrutura do bloco
- • O que faz: "Distribuidora de bebidas premium e mainstream em Joinville/SC"
- • Para quem: "Bares, restaurantes, mercadinhos, eventos"
- • Área: "Joinville + cidades vizinhas (raio 80km)"
- • Horário: "Atende WhatsApp 8h-20h dias úteis; pedidos noturnos respondidos na 1ª hora útil"
- • Pagamento: "PIX, boleto ou prazo até 14 dias para clientes recorrentes"
- • Frete: "Grátis acima de R$ 500; cobrado R$ 50 abaixo"
⚠️ Contexto fraco = alucinação
Sem contexto, agente alucina serviços que a empresa não oferece, prazos que não existem, área de cobertura imaginária. Contexto fundamenta cada resposta.
📚 Bloco 3 — Conhecimento e RAG
Instrui quando consultar RAG (FAQ, base de produtos), como citar fonte, quando dizer "não sei".
📖 Quando buscar no RAG
"Sempre que cliente perguntar sobre produto específico, preço, prazo, condições. Use ferramenta `buscar_produto`."
🎯 Top-K e re-rank
"Pega top-5 resultados, lê os 3 mais relevantes. Se nenhum responde a pergunta, admita desconhecimento."
🪞 Grounding com citação
"Cite a fonte quando aplicável: 'Conforme tabela atualizada em 15/05'. Não invente fonte."
🚫 Admitir desconhecimento
"Quando informação não está no contexto nem na base, responda: 'Não tenho essa info comigo. Vou verificar com o time e te retorno.' Cria ticket de escalação."
📏 Bloco 4 — Regras tácitas (RT-XX)
Inclui as RT-01..RT-NN do Pacote como regras explícitas. Numeradas, com gatilho e ação.
📖 Exemplo de listagem
✓ Por que numerar
Numeração ajuda no debug: "agente aplicou RT-07 errado?". Cliente confere. Operador audita. Sem numeração, regras viram bagunça.
🔧 Bloco 5 — Ferramentas (tools)
Lista de tools disponíveis com quando chamar cada uma e quais parâmetros. Tool use sem instrução = agente inventa parâmetro.
🔍 buscar_produto(sku ou nome)
"Use sempre que cliente pedir cotação. Parâmetros: SKU (string) OU nome (string). Retorna preço, estoque, descrição."
📋 criar_pedido(cliente_id, itens, forma_pagamento)
"Só após cliente confirmar SKUs + quantidades + pagamento. Cria pedido no Bling, retorna número."
💸 gerar_pix(valor, descrição)
"Após criar pedido, gere PIX. Retorna QR code. Envia para cliente."
🚨 escalar_humano(motivo, contexto)
"Use quando gatilho de escalação ativado (pedido > R$ 5k, reclamação, baixa confiança). Cria ticket, notifica humano."
💡 Tool description = contrato
Descrição clara da tool reduz erro de chamada em 60-70%. Exemplos de uso reduzem mais 20%. Total: 85-90% das chamadas corretas.
📋 Blocos 6-7 — Formato e exemplos few-shot
Bloco 6: formato de resposta (sem markdown se WhatsApp, com emoji ou sem). Bloco 7: 5-10 exemplos REAIS extraídos do Pacote.
🎨 Bloco 6 — Formato
- • Sem markdown (WhatsApp não renderiza)
- • 1-3 frases curtas, não parágrafo
- • 1-2 emojis por mensagem (🍺 ✅ 🚚)
- • Sempre termina com pergunta ou CTA
- • Nome do cliente quando souber
📚 Bloco 7 — Few-shot example
📊 Few-shot é 2ª alavanca de qualidade
Depois do RAG, few-shot real é o maior ganho. Carrega tom + vocabulário + ritmo sem fine-tune. 5-10 exemplos cobrem 70% dos cenários.
📜 Resumo do módulo
Próximo módulo:
4.2 — Construção do agente · Sonnet + Haiku · RAG no Supabase · memória · prompt caching · n8n · observabilidade.