O que é a ClaudIA Agêntica

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

A ClaudIA Agêntica é uma funcionalidade que permite à ClaudIA executar ações reais via chamadas de API, MCPs (ferramentas), etc. — em vez de responder apenas com base nos conteúdos registrados na base de conhecimento.

Na prática: a ClaudIA passa a agir de forma autônoma e contextual. Ela decide quando agir, combina a solicitação do cliente com as diretrizes de um prompt e executa a ação mais adequada para resolver o atendimento ou simplesmente responder à dúvida da melhor forma possível — tudo isso sem precisar transferir para um humano.

Como funciona?

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

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

• Ativar a ClaudIA Agêntica, que age para ajudar o cliente

Em resumo: a ClaudIA deixa de ser apenas uma IA que responde perguntas e passa a ser uma IA que também age e busca informações para agir.

Os três componentes internos da ClaudIA Agêntica:

Judge — decide se a Agêntica age

O Judge lê a mensagem do cliente e a compara com as descrições das ferramentas disponíveis. Se existir um sub-agente para agir naquele assunto, a conversa será roteada para a Agêntica. Se não, a ClaudIA responde com base nos conteúdos da base de conhecimento e fluxos habituais.

Supervisor — decide quem age e entrega a resposta

Quando o Judge ativa a Agêntica, entra em cena o Supervisor: ele seleciona qual Sub-agente é o mais adequado para aquela solicitação e, após receber a resposta, formata a resposta final com o tom de voz do cliente.

Sub-agente — executa a ferramenta

O Sub-agente é o especialista. Ele tem prompt próprio para lidar com aquela situação e conta com as ferramentas (chamadas de API). Age seguindo as diretrizes do prompt e das ferramentas, devolve os dados estruturados ao Supervisor e nunca fala diretamente com o cliente.

Fluxo: Judge → decide se ativa → Supervisor → seleciona o Sub-agente → Sub-agente → executa a ferramenta → Supervisor → entrega a resposta ao cliente.

Exemplos em produção

Antecipação de check-in — hospedagem

Uma cliente entrou em contato informando que seu voo chegaria mais cedo e queria antecipar o check-in.

O que a ClaudIA Agêntica fez:

• Explicou as regras gerais (check-in antes das 13h tem cobrança adicional por dia)

• Solicitou o código de reserva para consultar as informações específicas dessa cliente via API

• Verificou a disponibilidade e identificou que a entrada antes das 11h não estava disponível

• Ofereceu o check-in gratuito entre 13h e 15h (cortesia após as 13h)

• Quando a cliente aceitou, chamou a ferramenta para registrar a solicitação no sistema

• Confirmou à cliente — ticket encerrado sem intervenção humana

💡 Por que a ClaudIA solicitou o código de reserva? Porque a disponibilidade de informações é específica de cada reserva. A ferramenta precisa desse parâmetro para consultar a API correta.

Consulta de limite de crédito — fintech

Um cliente perguntou sobre sua fatura e depois solicitou informações sobre aumento de limite.

O que a ClaudIA Agêntica fez:

• Respondeu sobre as condições gerais da fatura com base nos conteúdos registrados

• Quando o cliente perguntou sobre o limite, ativou a ferramenta de consulta de crédito

• Usou o helpdeskid (que chega automaticamente com o ticket) para identificar o cliente — sem precisar solicitar os dados novamente

• Retornou o limite atual, valor disponível e regras de recorrência — dados reais e personalizados

• Orientou sobre como antecipar uma parcela para liberar o limite

💡 Diferença em relação à ClaudIA sem Agêntica: Sem Agêntica: resposta genérica sobre como o limite de crédito funciona. Com Agêntica: dados reais do cliente em tempo real.

Rastreamento com código inválido — varejo

Um cliente forneceu um código de pedido com formato incorreto (mais dígitos do que o esperado).

O que a ClaudIA Agêntica fez:

• Ao tentar ativar a ferramenta, identificou que o código estava fora do formato esperado

• Em vez de retornar um erro genérico, orientou o cliente sobre o formato correto com um exemplo prático

• O cliente forneceu o código correto, a ClaudIA localizou o pedido e resolveu o ticket

💡 Como a ClaudIA soube que o código estava errado? A descrição da ferramenta especifica o formato esperado. Quando a entrada não corresponde, a ClaudIA decide não ativar a chamada e guia o cliente para corrigir a informação — sem uma mensagem de erro robótica.

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 que a ClaudIA pode executar durante o atendimento. A configuração tem três blocos principais:

Bloco 1 — Declaração de variáveis

Define quais dados a ClaudIA extrairá da conversa para usar na chamada de API.

• Nome da variável: ex.: CPF, codigo_pedido, email

• Descrição: ex.: "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 do ticket, a ClaudIA o extrai automaticamente — sem perguntar novamente.

Bloco 2 — Chamada de API

Configura a requisição enviada ao sistema externo:

• Endpoint: a URL da API

• Método: GET, POST, PATCH, etc.

• Headers: ex.: Authorization com token de autenticação

• Corpo / Parâmetros: os dados enviados na requisição, usando as variáveis do bloco anterior

Bloco 3 — Configuração da resposta

Define o que a ClaudIA receberá da API para formular a resposta:

• Resposta completa: retorna toda a resposta da API para a ClaudIA

• Resposta filtrada (JSON específico): útil quando a API retorna dados sensíveis que não devem ser expostos ao cliente — ex.: tokens, IDs internos, dados bancários

A descrição da ferramenta

A descrição é o campo que instrui a ClaudIA sobre quando e como ativar aquela ferramenta. É um dos campos mais importantes:

• Explica as capacidades daquela ferramenta

• Define o formato esperado dos parâmetros (ex.: "código de pedido com 6 dígitos, formato #XXXXXX")

• Funciona como o "manual de uso" da ferramenta para que a IA saiba quando usá-la e quais informações precisa para isso

✅ Boas práticas

• Escreva descrições precisas — são o principal mecanismo de controle de quando cada ferramenta é ativada

• Especifique o formato dos parâmetros — quantidade de dígitos, prefixo, tipo de dado — isso evita chamadas com entrada inválida

• Use resposta filtrada para dados sensíveis — exponha ao modelo apenas o necessário para formular a resposta

• Refine com base em casos reais — a Agêntica melhora à medida que os cenários ocorrem em produção