Agentes de IA são assistentes virtuais configuráveis que respondem automaticamente às mensagens dos clientes com base em um prompt personalizado. Cada agente tem seu próprio comportamento, tom de voz, ferramentas disponíveis e base de conhecimento — podendo ser configurado para atender um setor específico da sua operação.
Para acessar, vá em Automações → Agentes de IA.
Como criar um agente de IA
- Acesse Automações → Agentes de IA.
- Clique em + Novo agente.
- Configure as três abas disponíveis: Início, Ferramentas e Conhecimento.
- Clique em Salvar agente.
Aba Início — Configurações principais
Nome e setor
Defina um nome curto e fácil de identificar para o agente (ex: Leonardo – Atendimento). Em Filas, selecione em qual fila/departamento o agente vai atuar — este campo é obrigatório.
Prompt principal
O prompt é o coração do agente — é aqui que você define o comportamento, o tom de voz, os limites de resposta e as regras que o agente deve seguir. Escreva de forma clara e estruturada, usando seções como Identidade, Regras, Perfil da empresa e Limites absolutos.
Um bom prompt é específico, direto e limitado ao escopo do agente. Evite prompts genéricos ou muito longos — quanto mais focado, mais preciso e econômico em tokens será o agente.
Configuração de IA
Defina qual provedor e modelo de IA o agente utilizará:
- Provedor de IA — OpenAI ou Google Gemini.
- Modelo — selecione o modelo disponível para o provedor escolhido (ex: GPT-4o, Gemini 2.0 Flash).
- API Key — cole a chave de API do provedor selecionado.
Para obter a chave de API, consulte os artigos:
- Como obter a chave de API da OpenAI
- Como obter a chave de API do Google Gemini
Aba Ferramentas
As ferramentas ampliam o que o agente pode fazer além de responder mensagens de texto. Ative apenas as ferramentas necessárias para o escopo do agente — cada ferramenta ativada deve ser instruída no prompt para que o agente saiba quando e como usá-la.
As ferramentas disponíveis incluem: Enviar produto, Executar integração externa, Curtir mensagem, Enviar arquivo do contato, Enviar emoji, Horário da empresa, Ver dados do contato, Atualizar contato, Formatar mensagem, Executar comando, Chamar outro prompt, Listar profissionais, Listar agendamentos, Criar agendamento, Atualizar agendamento e Segunda via Asaas.
Para a documentação completa de cada ferramenta, seus comandos e exemplos de uso no prompt, consulte o artigo Ferramentas Disponíveis nos Agentes de IA — Comandos Internos e Como Usar no Prompt.
Aba Conhecimento
A base de conhecimento fornece contexto adicional ao agente — materiais que ele consultará para enriquecer as respostas. São aceitos dois tipos de recurso:
- Imagens — envie imagens com informações visuais relevantes (ex: tabela de preços, cardápio, mapa).
- Links — adicione URLs de páginas que o agente deve consultar como referência (ex: página de produtos, base de conhecimento, site da empresa).
A base de conhecimento é ideal para informações que mudam com frequência ou que são muito extensas para colocar diretamente no prompt. Mantenha os recursos atualizados para garantir respostas precisas.
Visualizando os detalhes do agente
Na listagem de agentes, clique na seta de expansão ao lado do agente para ver um resumo completo sem precisar abrir o editor:
- Agente e setor — ID, nome, empresa, setor e fila.
- Modelo e parâmetros — provedor, modelo, temperatura, máximo de tokens, máximo de mensagens e modo de voz.
- Prompt principal — visualização do texto do prompt.
- Ferramentas e conhecimento — ferramentas ativas e número de itens na base de conhecimento.
- Chaves (ocultas) — confirmação de que a API Key está configurada (exibida parcialmente por segurança).
- Uso de tokens — consumo de tokens de prompt, conclusão e total.
- Registro — data de criação e última atualização do agente.
Parâmetros avançados
| Parâmetro | O que define |
|---|---|
| Temperatura | Nível de criatividade das respostas. Valores mais baixos (ex: 0) tornam as respostas mais previsíveis e consistentes. Valores mais altos (ex: 1) tornam as respostas mais variadas. |
| Max. tokens | Limite máximo de tokens por resposta. Controla o tamanho das respostas do agente. |
| Max. mensagens | Número máximo de mensagens do histórico da conversa que o agente considerará ao responder. |
| Voz | Define o modo de saída do agente — texto ou voz. |
Perguntas frequentes
Posso ter mais de um agente configurado? Sim. Você pode criar múltiplos agentes, cada um atuando em uma fila diferente ou sendo acionado em contextos específicos — por fluxo, campanha por frase ou diretamente pelo canal.
O agente responde todas as mensagens automaticamente? Depende de como ele está configurado. Se estiver ativo no canal via aba Integrações, ele responderá automaticamente. Se for acionado via fluxo ou campanha por frase, responderá apenas nos contextos configurados.
Como acompanhar o consumo de tokens do agente? Expanda o agente na listagem e consulte a seção Uso de tokens, que exibe o consumo separado por prompt, conclusão e total.
Como desativar o agente para um cliente específico? No painel lateral da conversa, ative a opção Desabilitar chatbot para aquele contato. O agente deixará de responder para ele sem afetar os demais atendimentos.