Entenda seu agente
O agente é a IA que atende o seu provedor. Esta página explica o que existe na configuração de um agente e o que a conecta/ai já montou para você.
Como funciona na prática. A voz do agente — motor de chamadas, síntese de voz (TTS), transcrição (STT), modelo de linguagem e ambiente sonoro — é montada pela equipe conecta/ai no onboarding e roda como padrão do sistema. Não existe uma aba “Voz” no painel. O que você ajusta na tela do agente é a persona, o conhecimento, as ferramentas e os canais.
Onde fica
A lista de agentes fica em /ia/agentes. Cada agente abre em /ia/agentes/[id], com um cabeçalho fixo que mostra nome, papel (Primário ou Especialista), status e o botão Playground.
A lista /ia/agentes
O topo mostra um mapa de roteamento (o primário à esquerda, os especialistas à direita) e quatro indicadores dos últimos 7 dias: agentes ativos, conversas, transferências e número de especialistas.
Cada agente aparece como um card com avatar, papel, status (Ativo, Treinando ou Inativo), descrição e contadores de ferramentas, bases e canais. No rodapé do card ficam os botões Configurar (abre o detalhe) e Playground.
Criar um agente — 2 caminhos
Há dois botões no cabeçalho da lista (aparecem enquanto o seu plano permite criar mais agentes):
- “Novo agente” — criação por template, em 2 passos.
- “Criar com IA” — o assistente que gera a configuração a partir de uma descrição em texto. Veja Criador de agentes.
Novo agente — 2 passos
Passo 1 — Galeria de templates. Você escolhe um ponto de partida: Recepção, Suporte Técnico, Financeiro, Comercial ou Em branco. Cada template já traz nome, descrição, personalidade e um conjunto de ferramentas sugerido.
Passo 2 — Formulário. Já vem preenchido com os padrões do template. Você ajusta Nome, Slug (identificador único na org), Descrição (aparece para os outros agentes decidirem quando transferir) e Personalidade (o editor estilo Notion). O checkbox Agente primário define se ele recebe todo inbound novo.
Apenas um agente primário por organização. Marcar um novo como primário desmarca o anterior. Especialistas recebem conversas por transferência do primário — veja Tipos de agente.
As áreas da tela de detalhe
A tela de detalhe do agente organiza a configuração em áreas na barra lateral, agrupadas por intenção. Você troca de área sem sair da página.
| Grupo | Áreas |
|---|---|
| Quem é | Identidade · Conversa |
| O que faz | Ferramentas · Conhecimento |
| Onde atende | Canais |
| Como performa | Desempenho |
Não há aba “Voz” nem link para um flow nesta tela. São essas seis áreas. Os parâmetros de voz não são editáveis aqui — são padrão de runtime configurado pela conecta/ai.
Identidade
Os dados de fundo. O campo Nome é editável (com botão Salvar) e há um interruptor de Status (Habilitado / Pausado). Já ID, Papel (Primário ou Especialista) e Descrição aparecem apenas para leitura. Aqui também fica o Departamento: quando o agente assume uma conversa, o departamento dela passa a ser o dele automaticamente. No fim da área há a zona de perigo para apagar o agente.
Papel e slug não mudam pela tela. Depois de criado, o papel (Primário/Especialista) e o slug do agente não são editáveis pela interface. Para trocar, crie um agente novo ou fale com a conecta/ai. O agente primário não pode ser apagado — promova outro a primário antes.
Conversa
A persona e a forma de falar:
- Greeting (WhatsApp) — a saudação inicial.
- Tom de voz — três opções: Formal, Amigável ou Neutro.
- Personalidade — o campo mais importante, escrito no editor estilo Notion. É o texto que o modelo lê a cada turno da conversa.
Ferramentas
Quais ferramentas o agente pode acionar — ações nativas (2ª via, status de conexão, abrir chamado…), ferramentas HTTP customizadas e ferramentas MCP. Há um interruptor “Acesso a todas as ferramentas” e, quando desligado, uma grade por domínio para escolher tool a tool.
Conhecimento
As bases de conhecimento vinculadas a este agente — o que ele consulta para responder — mais as lacunas detectadas (perguntas que a IA não soube responder), com atalho para criar o artigo que falta.
Canais
Em quais canais (📞 telefone, 💬 WhatsApp) o agente atende, e o vínculo agente↔canal (Vincular / Desvincular). O status de cada canal aparece só para leitura — ligar ou desligar um canal é em Configurações → Integrações, não aqui.
Desempenho
Indicadores deste agente: motivos de escalonamento, lacunas de conhecimento, ferramentas com falha e as últimas interações. Para o comparativo entre agentes, veja Desempenho dos agentes.
Pausar um agente
Pelo interruptor de Status na área Identidade. Pausar congela o agente: ele para de atender, mas a configuração e o histórico ficam intactos. Útil para manutenção ou para validar um ajuste antes de ligar para todos.
Testar antes de ligar para clientes
Use o Playground em /ia/agentes/[id]/playground. Ele conversa com o agente de verdade — inclusive as ferramentas, que executam normalmente. Vale rodar as perguntas mais comuns antes de colocar qualquer mudança no ar. Veja Playground.
Próximo passo
→ Tipos de agente → Base de conhecimento