Agentes de IA
O que é um agente na DOM360, como ele é configurado e como opera de ponta a ponta.
O que é um agente
Um agente é uma configuração completa de inteligência artificial que atende por um canal (WhatsApp, chat ou ligação de voz) em nome de um cliente. Um agente não é só um prompt: é a combinação de
- um modelo de linguagem (e seus parâmetros, como temperatura);
- um prompt do sistema e regras de negócio que orientam como ele se comporta na conversa;
- um conjunto de ferramentas MCP habilitadas (veja MCPs) que ele pode acionar durante o atendimento;
- uma base de conhecimento própria, com documentos que ele pode consultar;
- um ou mais canais pelos quais ele é acionado;
- um ciclo de vida (rascunho → produção → inativo/arquivado) que decide se ele responde de fato.
Na DOM360 existem dois tipos de superfície — agentes de texto (WhatsApp/chat) e agentes de voz (ligações telefônicas) — configurados em telas separadas, mas seguindo a mesma lógica de identidade, comportamento e ferramentas.
Propósito do agente
Todo agente declara um propósito, que muda o vocabulário da tela de Resultados e o que conta como sucesso:
| Propósito | O que significa no resultado |
|---|---|
| Vendas | Fala em ganhos e custo por ganho. |
| Cobrança | Fala em acordos e custo por acordo. |
| Suporte | Fala em resoluções e custo por resolução. |
| Qualificação | Fala em qualificados e custo por qualificado. |
| Copilot | Assiste um usuário interno da operação — fica fora da tela de Resultados. |
| Tarefa | Roda como pré ou pós-hook de outro agente — não atende ninguém, não tem canal nem campanha própria. |
Ciclo de vida
Um agente passa por quatro estados, nesta ordem de progressão natural:
Rascunho — agente criado mas ainda não ativado para o cliente. Pode ser editado livremente.
Em produção — ativo, responde no canal configurado, e passa a contar na franquia e na cobrança do cliente.
Inativo — interrompido temporariamente: não responde, mas pode voltar a produção.
Arquivado — encerramento definitivo. Um agente arquivado não volta a produção nem a rascunho.
"Ativo" (switch de status) e "Em produção" (ciclo de vida) são coisas diferentes: Ativo = responde; Em produção = conta na franquia e na cobrança. Um agente pode estar ativo e ainda em rascunho — é possível testá-lo antes de ele contar como produção faturável.
Como criar e configurar um agente
A forma mais rápida de começar é pela Biblioteca de Modelos (templates pré-configurados — por exemplo, "SDR Padrão" para prospecção ou "Copilot Padrão" para suporte interno): escolher "Usar modelo" já traz prompt, ferramentas e parâmetros de IA de um ponto de partida testado. Também é possível criar um agente do zero pelo botão Novo agente.
Dentro da configuração de um agente, as abas são:
Comportamento
- Nome e status (ativo/inativo) do agente;
- Propósito e a regra de fechamento por inatividade (depois de quanto tempo sem mensagem a conversa é considerada encerrada);
- Configurações do modelo: qual modelo de linguagem usar e seus parâmetros (ex.: temperatura);
- Prompt do sistema: o texto principal que orienta o agente durante toda a conversa (suporta Markdown);
- Regras de negócio: um texto complementar, anexado ao prompt do sistema, para procedimentos e políticas específicas que você queira manter separados do prompt principal.
Ferramentas
A tela de integrações descrita em MCPs: conectar credenciais e escolher quais ferramentas, dentro de cada integração, este agente específico pode usar.
Conhecimento
A base de conhecimento própria do agente — os documentos que a ferramenta kb.search consulta durante a conversa. Cada agente tem a sua própria base, isolada dos demais.
Hooks
Agentes do tipo Tarefa entram aqui: um agente de tarefa roda como pré-hook (antes da conversa principal começar, por exemplo para enriquecer o contexto) ou pós-hook (depois do resultado da conversa ser registrado, por exemplo para classificar o desfecho) de outro agente.
Canais
Por onde o agente é acionado (WhatsApp, outro canal de texto configurado, ou telefonia, no caso de voz).
Versões
Todo agente mantém um histórico de versões do que foi publicado — permitindo comparar o que mudou entre uma versão e outra, e restaurar uma versão anterior se necessário.
Como o agente usa as ferramentas na prática
Durante a conversa, o modelo decide por conta própria quando chamar uma ferramenta — por exemplo, ao perceber que o usuário quer agendar algo, ele chama google_calendar.check_availability antes de confirmar um horário, ou crm.create_lead ao identificar uma oportunidade comercial real. A qualidade dessa decisão depende diretamente do prompt do sistema: veja Qualidade de Prompt para como escrever instruções que levem o agente a usar as ferramentas certas, no momento certo.
Agentes de voz seguem a mesma lógica de prompt, ferramentas e ciclo de vida dos agentes de texto — a diferença principal é o canal (ligação telefônica via tronco SIP em vez de mensagem) e parâmetros específicos de voz (como a voz sintetizada usada).