IA & AgentesAgentes

Configurar agentes

Esta é a tela onde você define como a IA do seu provedor se comporta.

Lista de agentes
Lista de agentes

Onde fica

  • Tela nova (agent-centric): /agentes — wizard de 4 passos para criar + editor com 4 tabs
  • Tela legada: /ia/agentes/[id] — com Health Score e áreas adicionais de Comportamento/Evolução

Permissão necessária: agentes:view (e agentes:edit para mexer).

Listar agentes

A página principal mostra cada agente em card com:

  • Nome do agente
  • Avatar / iniciais
  • Status (ativo / pausado)
  • Health Score (apenas tela legacy) — nota de 0-100 baseada em qualidade
  • Resumo de feature ativa (Outbound, gravação, etc.)
  • Botões: Editar, Pausar/Ativar, Duplicar, Excluir

Wizard de criação (tela nova)

  1. Passo 1 — Tipo de agente. Escolha o uso principal:

    • WhatsApp (texto + áudio)
    • Telefone (voz)
    • Híbrido (ambos)

  2. Passo 2 — Engine de voz (apenas se usar telefone).

    • ConectaAI (LiveKit) — pipeline próprio, mais customizável
    • Retell — parceiro com latência otimizada (configs avançadas ficam bloqueadas)

  3. Passo 3 — Identidade básica.

    • Nome do agente (ex.: “Sofia”)
    • Saudação inicial (a primeira frase que ele fala)
    • Tom de voz (formal / amigável / neutro)

  4. Passo 4 — Conhecimento + canais.

    • Atribuir KB existente ou criar nova vazia
    • Vincular canais (WhatsApp, telefone) que ele atende

Após criar, vai para o editor com 4 tabs.

Editor — 4 tabs

Tab Geral

Saudação (textarea) A primeira fala. Boa saudação tem 3 elementos:

  • Identificação do agente: “Aqui é a Sofia”
  • Vínculo com a empresa: “do time de atendimento da SuperNet”
  • Convite: “Como posso te ajudar hoje?”

Tom de voz (3 cards selecionáveis)

  • Formal — “Senhor cliente, em que posso auxiliá-lo?”
  • Amigável — “Oi! Como posso te ajudar?”
  • Neutro — “Olá. Em que posso ajudar?”

Horário de atendimento 7 toggles (um por dia da semana), cada um com inputs de hora início e hora fim.

Ações disponíveis Toggles em 2 colunas. Cada AgentAction pode ser ligado/desligado:

  • check_connection_status
  • open_ticket
  • send_second_invoice
  • schedule_visit
  • escalate_to_human
  • …e tools customizadas vinculadas

Tab Conhecimento

Lista de KnowledgeEntry { question, answer } que esse agente consulta. Add via formulário inline (prompt() no MVP), delete por id.

→ Como construir uma boa KB

Tab Escalonamento

Lista de regras com condition, action, priority (alta/média/baixa). CRUD inline.

Exemplos de regras:

  • “Se cliente disser ‘humano’ → transferir imediatamente” (alta)
  • “Se sentimento for negativo por 3 turnos → transferir” (alta)
  • “Se tópico for fora do escopo → transferir” (média)
  • “Se IA não conseguir resposta após 2 tentativas → transferir” (média)

Tab Comportamento (apenas legacy)

Health Score (nota 0-100), histórico de notas, áreas que precisam atenção.

Inclui:

  • Áreas de Evolução — sugestões automáticas (em breve, hoje desabilitado)
  • Aprendizados recentes — KB sugerida pra cadastrar baseado em interações reais
  • Score por categoria — empatia, precisão, resolução

Pausar agente

Botão Pausar congela o agente — ele para de atender, mas a configuração e o histórico ficam intactos.

Útil em:

  • Manutenção planejada
  • Testar nova versão do prompt antes de ligar para todo mundo
  • Pausar canal de cobrança fora de horário comercial

Duplicar agente

Cria cópia do agente com sufixo “(cópia)”. Útil para:

  • Versionar antes de mexer em algo arriscado
  • Criar variante para A/B (ex.: tom formal vs amigável)

Health Score (tela legacy)

Nota 0-100 calculada a partir de:

  • Resolução autônoma (% sem precisar humano) — peso 40%
  • Sentimento positivo (cliente satisfeito) — peso 25%
  • Aderência ao prompt (IA seguindo regras definidas) — peso 20%
  • Latência (tempo de resposta) — peso 15%

Atualiza diariamente com base nas conversas das últimas 24h. Score:

  • 80-100 — excelente
  • 60-79 — bom, com pontos a melhorar
  • 40-59 — atenção
  • 0-39 — intervenção urgente

Velocidade de fala (em breve)

Vai permitir ajustar quão rápido a IA fala em chamadas (slow / normal / fast). Hoje é fixo no normal — funciona pra maioria dos casos.

Limites por plano

  • Starter — 1 agente
  • Pro — 3 agentes
  • Enterprise — ilimitado

→ Limites

Próximo passo

→ Tipos de agente
→ Base de conhecimento

Visão geralTipos de agente