O que é a ClaudIA Agêntica e como ela funciona

Quando usar

• Você quer entender o que é a ClaudIA Agêntica e como ela difere da ClaudIA tradicional

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

• Você quer aprender a estrutura interna (Judge → Supervisor → Sub-agente)

Pré-requisitos

• Acesso ao Hub com a feature Agêntica habilitada

• Conhecimento básico do que é a ClaudIA tradicional

Sobre este artigo

A ClaudIA Agêntica permite à 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

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

Os três componentes internos

Judge — decide se a Agêntica age

Lê a mensagem do cliente e compara com as descriptions das ferramentas disponíveis. Se existir um sub-agente apropriado, a conversa é roteada para a Agêntica. Caso contrário, a ClaudIA responde com base na base de conhecimento.

Supervisor — decide quem age e entrega a resposta

Quando o Judge ativa a Agêntica, o Supervisor:

• Seleciona qual Sub-agente é o mais adequado

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

Sub-agente — 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 Sub-agente → Sub-agente → executa a ferramenta → Supervisor → entrega a resposta

Exemplos em produção

🎥 Vídeo de demonstrações

Antecipação de check-in — hospedagem

Cliente informa que o voo chegará mais cedo. A Agêntica:

• 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 → Agêntica chama a tool 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 Agêntica:

• Responde sobre fatura via base de conhecimento

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

• Usa o helpdeskId automaticamente — sem pedir dados de novo

• 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. A Agêntica:

• 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:

• Explica as capacidades

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

• Funciona como manual de uso da tool para a IA

Boas práticas