O Supervisor é o orquestrador da ClaudIA Agêntica — o componente responsável por entender a intenção do cliente, decidir como responder e garantir que a resposta chegue com o tom de voz correto.
Entender o que o Supervisor faz (e o que ele não faz) é essencial para configurar bem a plataforma.
🧠 O que o Supervisor faz
O Supervisor só entra em cena para pegar o cliente do pedido e resolver junto aos sub-agents, ele:
-
Entende o que o cliente presica
-
Seleciona o Sub-agente correto para aquele pedido, com base na description de cada especialista
-
Passa o contexto necessário para o Sub-agente agir
-
Faz iterações com o sub-agent para resolver a dor do cliente
-
Formata a resposta final usando o tom de voz configurado para aquele cliente
O Supervisor nunca inventa, complementa ou contradiz informações que o Sub-agente não forneceu. A resposta do especialista é a fonte da verdade.
🚫 O que o Supervisor não faz
-
Não tem acesso ao mundo real diretamente — não liga, não envia e-mail, não abre tickets
-
Não pede dados "por via das dúvidas" — só solicita o que é absolutamente necessário para avançar (se um sub-agent pedir mais dados, o supervisor pede ao cliente)
-
Não oferece sugestões proativas após responder — sem "Posso ajudar em mais alguma coisa?"
-
Não promete ações que não pode executar — na dúvida, assume que não pode
🔀 Como o Supervisor decide qual Sub-agente chamar
O Supervisor seleciona o Sub-agente com base na description de cada um — um texto curto que descreve quando aquele especialista deve ser acionado.
Não é necessário (nem recomendado) listar os Sub-agentes no prompt do Supervisor. As descriptions já fazem esse trabalho.
⚠️ Atenção: duplicar regras de roteamento no prompt do Supervisor e na description do sub-agent cria duas fontes de verdade que podem conflitar. Mantenha as regras de roteamento apenas na description.
🎙️ Configurando o Tom de Voz
O tom de voz define como o Supervisor se comunica com o cliente — não o que ele faz. É configurado no campo do prompt e controla identidade, vocabulário, formato e regras de comunicação.
O que deve estar no tom de voz
-
Tom geral: formal ou informal, direto ou explicativo, caloroso ou neutro
-
Vocabulário: palavras preferidas e proibidas, como tratar o cliente (você/tu/senhor), uso de emoji
-
Situações difíceis: como responder à frustração, dar notícias ruins, dizer "não consigo fazer isso"
-
Formato: comprimento da resposta, uso de listas, quebras de parágrafo
-
Exemplos: pares de "prefira X / evite Y" — são os mais úteis para a IA
Exemplo de instrução eficaz:
Prefira "seu pedido tá a caminho" a "o pedido encontra-se em trânsito". Use linguagem direta e evite formalismo burocrático.
O que não deve estar no tom de voz
-
Lógica de negócio ou cenários de atendimento → vai no system prompt do Sub-agente
-
Regras de roteamento → vão na description do sub-agent
-
Instruções sobre quando acionar tools → vão no system prompt do Sub-agente
Checklist de avaliação do tom de voz
-
Sem contradições: "ser informal" + "sempre usar senhor/senhora" é conflito — resolver antes de publicar
-
Cobertura emocional: cobre ao menos pergunta neutra, cliente frustrado e notícia ruim
-
Escrito como instrução: não é copy-paste de brand doc — é instrução para IA