> Entenda seu agente — a lista, como criar e as áreas reais da tela de detalhe, sem prometer o que a UI não faz. # 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ê**. > **Nota.** > **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](/ambiente-ia/criador-de-agentes). ### Novo agente — 2 passos 1. **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. 2. **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. > **Nota.** > **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](/ambiente-ia/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 | > **Atenção.** > **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. > **Nota.** > **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](/ambiente-ia/prompts). É o texto que o modelo lê a cada turno da conversa. ### Ferramentas Quais [ferramentas](/ambiente-ia/tools) 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](/ambiente-ia/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](/ambiente-ia/desempenho). ## 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](/ambiente-ia/playground). ## Próximo passo → [Tipos de agente](/ambiente-ia/tipos-de-agente) → [Base de conhecimento](/ambiente-ia/conhecimento)