O que são os Agentes Especialistas e como funcionam

Quando usar

• Você quer entender o que são os Agentes Especialistas e como eles diferem da ClaudIA tradicional

• Você quer ver exemplos reais de uso (hospedagem, fintech, varejo)

• Você quer aprender a estrutura interna (Judge → Supervisor → especialista → ferramentas)

Pré-requisitos

• Acesso ao painel com os Agentes Especialistas habilitados

• Conhecimento básico do que é a ClaudIA tradicional

Sobre este artigo

Os Agentes Especialistas permitem à ClaudIA executar ações reais via chamadas de API, MCPs (ferramentas) etc. — em vez de responder apenas com base nos conteúdos da base de conhecimento.

Na prática, a ClaudIA passa a agir de forma autônoma e contextual, decidindo quando agir, combinando a solicitação do cliente com diretrizes de prompt e executando a ação mais adequada.

🎥 Webinar com o CEO — visão geral e contexto estratégico

Como funciona

Quando um cliente envia uma mensagem, a IA analisa a solicitação (e o contexto) e decide:

• Responder diretamente com base nos conteúdos registrados, ou

• Acionar os Agentes Especialistas, que agem para ajudar o cliente

Os três componentes internos

Judge — decide se os especialistas atuam

Lê a mensagem do cliente e compara com as descrições dos especialistas disponíveis. Se existir um especialista apropriado, a conversa é roteada para o Supervisor. Caso contrário, a ClaudIA responde com base na base de conhecimento.

Supervisor — decide quem age e entrega a resposta

Quando o Judge aciona os especialistas, o Supervisor:

• Seleciona qual especialista é o mais adequado

• Formata a resposta final com o tom de voz do cliente

Especialista — executa a ferramenta

O especialista. Tem prompt próprio para a situação e conta com as ferramentas (chamadas de API). Devolve dados estruturados ao Supervisor — nunca fala diretamente com o cliente.

Fluxo: Judge → decide se ativa → Supervisor → seleciona o especialista → especialista → executa a ferramenta → Supervisor → entrega a resposta

Uma analogia que ajuda

Pense na central de atendimento telefônico de uma empresa grande:

• A recepção ouve o cliente e decide para onde encaminhar. É o Judge.
• O atendente conversa com o cliente do começo ao fim, mas não acessa sistema nenhum. É o Supervisor.
• Os especialistas de retaguarda acessam os sistemas e respondem ao atendente, nunca ao cliente. São os Agentes Especialistas.
• Os sistemas da empresa que os especialistas consultam são as ferramentas.

Três consequências práticas:

• O tom de voz mora num lugar só: no Supervisor.
• O especialista não vê a conversa inteira. Ele recebe só o que o Supervisor contou.
• Se nenhum especialista executa uma ação, o sistema não executa. O Supervisor não tem acesso a sistemas.

Exemplos em produção

🎥 Vídeo de demonstrações

Antecipação de check-in — hospedagem

Cliente informa que o voo chegará mais cedo. O especialista:

• Explica regras gerais (check-in antes das 13h tem cobrança)

• Solicita código de reserva para consultar a API

• Verifica disponibilidade — entrada antes das 11h indisponível

• Oferece check-in gratuito entre 13h-15h (cortesia)

• Cliente aceita → o especialista chama a ferramenta para registrar no sistema

• Confirma → ticket encerrado sem intervenção humana

Consulta de limite de crédito — fintech

Cliente pergunta sobre fatura, depois sobre aumento de limite. A ClaudIA:

• Responde sobre fatura via base de conhecimento

• Ativa a ferramenta de consulta de crédito quando muda o tópico

• Usa o helpdeskId automaticamente, porque a ferramenta declara um parâmetro com esse nome — sem pedir dados de novo (veja como configurar)

• Retorna limite atual, valor disponível e regras

• Orienta sobre antecipar parcela para liberar limite

Rastreamento com código inválido — varejo

Cliente informa código de pedido com mais dígitos do que o esperado. O especialista:

• Identifica que o código está fora do formato esperado

• Em vez de erro genérico, orienta com exemplo prático

• Cliente fornece o código correto → ticket resolvido

Como criar uma ferramenta

As ferramentas são configuradas no espaço de trabalho da ClaudIA, dentro da configuração do agente. Cada ferramenta representa uma chamada de API. A configuração tem três blocos:

Bloco 1 — Declaração de variáveis

Define quais dados a ClaudIA extrairá da conversa para a chamada:

• Nome: cpf, codigo_pedido, email

• Descrição: "CPF do cliente, 11 dígitos, apenas números"

A descrição instrui a IA sobre o que coletar e em qual formato. Se o dado já estiver no histórico, a ClaudIA o extrai automaticamente.

Bloco 2 — Chamada de API

• Endpoint — URL

• Método — GET, POST, PATCH

• Headers — ex: Authorization

• Corpo / Parâmetros — usando as variáveis do Bloco 1

Bloco 3 — Configuração da resposta

• Resposta completa — toda a resposta da API

• Resposta filtrada (JSON específico) — útil quando a API retorna dados sensíveis (tokens, IDs internos, dados bancários)

A descrição da ferramenta

É um dos campos mais importantes: é por ela que o especialista escolhe a ferramenta certa, na hora certa, com os dados certos. Escreva uma frase de propósito e três blocos curtos:

• O que faz, em linguagem de negócio (não "chama o endpoint de orders")
• Quando usar: a situação que justifica a chamada
• Quando não usar: a ferramenta vizinha que é fácil de confundir com esta
• O que devolve: os resultados possíveis, com nome. Exemplo: encontrou um, encontrou vários, não encontrou, cliente não existe

A descrição de cada variável também conta: diga o que é o dado, o formato (ex: "código de pedido com 6 dígitos, formato #XXXXXX") e de onde tirar quando há mais de uma origem possível na conversa.

Exemplos completos em Boas práticas para criar um Agente Especialista.

Boas práticas