Principal Primeiros passos Como navegar pela interface de agentes da ClaudIA Agêntica

Como navegar pela interface de agentes da ClaudIA Agêntica

Última atualização em May 21, 2026

Quando usar

  • Você é novo na tela de Agentes da Agêntica e quer entender o que cada parte faz

  • Você precisa criar, testar, publicar ou manter agentes

  • Você quer entender as três abas (Agentes, Ferramentas, Servidores MCP)

Pré-requisitos

Sobre este artigo

Este guia explica, tela por tela, como usar a área de Agentes da ClaudIA Agêntica — onde você cria, testa, publica e mantém os agentes que vão atender seus clientes. O foco aqui é navegação e uso da interface (para conceitos, use os outros artigos).

As três abas da plataforma

A área da ClaudIA Agêntica é dividida em três abas no menu lateral:

  1. Agentes — onde você cria e gerencia o Supervisor e os Sub-agentes

  2. Ferramentas (Tools) — onde você cria e configura as chamadas de API que os Sub-agentes podem usar

  3. Servidores MCP — onde você gerencia conexões via Model Context Protocol que disponibilizam tools para a plataforma

As três abas

Aba Agentes

Lista todos os agentes do projeto, dividida em duas seções:

  • Supervisores — o orquestrador (normalmente um só). Mostra quantos Sub-agentes estão vinculados

  • Sub-agentes — os especialistas. Cada linha mostra nome, trecho da descrição e quantas tools estão ativas

Filtro por projeto (workspace)

No canto superior direito, antes do botão de criar, existe um seletor de projeto. Cada conta pode ter mais de um workspace.

Se você só vê um projeto ou o seletor aparece desabilitado, é porque sua conta tem apenas um workspace disponível — comportamento normal.

Os dois caminhos para criar um agente

  1. Montar com AI Companion (botão laranja, à esquerda) — abre um modal de início com duas opções: começar do zero ou migrar um Eddie existente do workspace. Em ambos os casos, o Companion conduz a criação em linguagem natural.

  2. + Criar (botão laranja, à direita) — abre o formulário manual para criar um Sub-agente ou Supervisor. Recomendado para quem já entende a estrutura.

Os dois caminhos coexistem — você pode criar a base com o Companion e refinar manualmente.

Ações em cada linha

À direita de cada agente:

  1. Testar (Playground) — abre o Playground encaixado para conversar com o agente em modo teste

  2. Duplicar — cria uma cópia para editar sem mexer no original (útil para testar variações de prompt)

  3. Editar — abre o formulário do agente

  4. Deletar — remove o agente

Se for um Sub-agente vinculado ao Supervisor, é preciso desvinculá-lo antes de deletar.

Criando um Sub-agente manualmente

Ao clicar em + Criar → Sub-agente, abre o modal com quatro campos:

Modal Criar sub-agente

  1. Nome do sub-agente — identifica na lista. Use algo descritivo como "Especialista em Status de Pedidos". Não aparece para o cliente.

  2. Descrição — texto que o Supervisor lê para decidir quando chamar. A regra de roteamento mora aqui. Use linguagem do cliente.

  3. Instruções de comportamento (system prompt) — o que o Sub-agente deve fazer quando acionado.

  4. Tools — lista de ferramentas disponíveis. Ative apenas as que o especialista precisa. Selecionar todas liga todas de um servidor de uma vez.

Após salvar, o Sub-agente vai para a seção "Sub-agentes" e fica pronto para ser vinculado ao Supervisor.

Para o Supervisor, o fluxo é parecido com campos próprios (tom de voz, sub-agentes vinculados).

Criando com AI Companion

Ao clicar em Montar com AI Companion, a tela troca para um chat. Você descreve em linguagem natural e o Companion conduz a conversa.

Tela do Companion

Não cole tokens reais ou API keys aqui — use placeholders genéricos (ex: TOKEN_API_KEY) e edite o valor verdadeiro depois, direto na tela de Ferramentas.

Testando no Playground

Para abrir, clique no ícone do balãozinho na linha do agente.

Playground

No topo do painel direito:

  1. Seletor de agente — troca o agente sem fechar o painel

  2. Reiniciar conversa — limpa o histórico (use sempre que terminar um caso de teste)

No corpo da conversa, sempre que o agente chama uma tool, aparece um bloco Saída da tool expansível mostrando o nome, o JSON cru e o call_id.

O toggle Ocultar chamadas de tool mostra só a conversa do ponto de vista do cliente.

Aba Ferramentas

Lista todas as tools criadas no projeto, com nome, descrição curta, número de parâmetros, criação e atualização.

Aba Ferramentas

Criando uma ferramenta

Clique em + Criar ferramenta:

Modal criar tool

  1. Nome — usado pelo agente internamente. Sem espaços, prefira snake_case (ex: consultar_endereco_por_cep)

  2. Descrição da ferramenta — campo mais importante. É com base nela que o agente decide se usa essa tool durante o reasoning.

Descrições genéricas geram chamadas erradas e silenciosas. Especifique o que a tool faz, qual API consome, quais parâmetros precisa receber e em qual formato.

Após criar, a ferramenta abre no editor visual de Fluxos controlados (Eddie) onde você monta a chamada de API.

Observações