Principal Primeiros passos Como configurar o Supervisor da ClaudIA Agêntica

Como configurar o Supervisor da ClaudIA Agêntica

Última atualização em May 21, 2026

Quando usar

  • Você está configurando pela primeira vez o Supervisor da Agêntica
  • Você quer entender o que ele faz e o que ele não faz
  • Você precisa configurar o tom de voz do Supervisor

Pré-requisitos

  • Acesso ao Hub com a feature Agêntica habilitada
  • Projeto (workspace) selecionado no seletor do canto superior direito da tela de Agentes — o campo Project é obrigatório nos formulários do Supervisor e dos Sub-agentes
  • (Recomendado) Sub-agentes já criados — ver Como criar Sub-agentes

Sobre este artigo

O Supervisor é o orquestrador da ClaudIA Agêntica — responsável por entender a intenção do cliente, decidir como responder e garantir que a resposta chegue com tom de voz correto.

O que o Supervisor faz

O Supervisor entra em cena para pegar o pedido do cliente e resolver junto aos Sub-agentes:

  1. Entende o que o cliente precisa

  2. Seleciona o Sub-agente correto, com base na description de cada especialista

  3. Passa o contexto necessário para o Sub-agente agir

  4. Itera com o Sub-agente para resolver a dor do cliente

  5. Formata a resposta final usando o tom de voz configurado

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 absolutamente necessário (se um Sub-agente pedir, 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 com base na description de cada Sub-agente — 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.

Duplicar regras de roteamento no prompt do Supervisor + na description cria duas fontes de verdade que podem conflitar. Mantenha as regras 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 prompt.

O que deve estar no tom de voz

  • Tom geral — formal/informal, direto/explicativo, caloroso/neutro

  • Vocabulário — palavras preferidas/proibidas, tratamento (você/tu/senhor), uso de emoji

  • Situações difíceis — como responder à frustração, dar notícias ruins, dizer "não consigo"

  • Formato — comprimento da resposta, 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

  • Lógica de negócio ou cenários → vai no system prompt do Sub-agente

  • Regras de roteamento → vão na description do Sub-agente

  • Instruções de 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; resolva 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

Observações