Executar agente de IA da empresa com instruction e contexto de telefone do contato.
Nó AI Agent
O nó AI Agent (workflow_ai_agent) executa um agente de IA da empresa com a mesma lógica do chat no app. A sessão é resolvida automaticamente a partir de agent + contact phone — histórico isolado por contato para IA orientada por workflow.
Encontre-o na paleta WhatsWave em Automações.
Figura 1: Nó AI Agent — seletor de agente, telefone e instruction
O que faz
| Aspecto | Comportamento |
|---|---|
| Node type | workflow_ai_agent |
| Executor | logic — runner de agente no servidor |
| Session | Auto-resolvida: agent ID + contact_phone_number |
| Outputs | response, data, tool_logs, usage, session_id |
O agente pode usar ferramentas configuradas (CRM, HTTP, etc.) conforme configurações do agente. Chamadas de ferramentas aparecem em tool_logs; uso de tokens em usage.
Campos de configuração
| Campo | Key | Obrigatório | Descrição |
|---|---|---|---|
| Agent | agent_id | Sim | Selecione entre agentes da empresa |
| Contact phone | contact_phone_number | Sim | E.164 — escopo do histórico da sessão, ex.: {{trigger.body.phone}} |
| Instruction / message | instruction | Sim | Mensagem do usuário ou tarefa para o agente |
| System prompt supplement | system_prompt | Não | Regras extras só para esta execução |
| Persist to session | persist_session | Não | Padrão true — salva mensagens user + assistant no histórico |
Persist session (persist_session)
| Value | Comportamento |
|---|---|
true | Grava instruction do usuário e resposta do assistente na sessão do agente — visível na UI de chat do agente |
false | Execução pontual sem atualizar histórico armazenado — útil para classificação ou extração |
Dicas e boas práticas
- Coloque contexto dinâmico em
instruction, não só emsystem_prompt— ex.:Answer based on: {{trigger.body.question}}. - Busque mensagens primeiro com nó Messages e inclua transcrição em
instructionpara consciência multi-turno quandopersist_sessionfor false. - Use
persist_session: falsepara extração leve de PII (intenção, sentimento) que você não quer na memória de longo prazo do agente. - Inspecione
tool_logsao depurar efeitos colaterais inesperados em CRM ou API. - Encadeie nó Send com
{{workflow_ai_agent_1.response}}para entregar a resposta no WhatsApp. - Mesmo telefone = mesma sessão entre execuções — turnos persistidos anteriores influenciam o agente, a menos que resete via nó Session.
Exemplos de uso
Exemplo 1 — Auto-resposta a webhook recebido
Trigger: Webhook — pergunta do cliente.
Fluxo:
- AI Agent
contact_phone_number:{{trigger.body.from}}instruction:{{trigger.body.text}}
- Send — Text:
{{workflow_ai_agent_1.response}}
Exemplo 2 — Classificar lead sem persistir
Trigger: Webhook — novo contato.
Fluxo:
- AI Agent
instruction: "Classify as hot/warm/cold: {{trigger.body.message}}"persist_session:false
- Condition no
responseparseado → ramos de coluna CRM
Exemplo 3 — Agente com guardrails extras
Trigger: Manual.
Fluxo:
- AI Agent
system_prompt: "Never promise discounts over 10%. Reply in Portuguese."instruction: variável da mensagem do cliente
- CRM — comentário com tokens de
usagepara auditoria de cobrança
FAQ
Qual a diferença para nós OpenAI/Gemini?
AI Agent usa seu agente configurado (ferramentas, prompt base, configurações de modelo). Nós LLM são chamadas brutas à API sem tooling de agente.
Onde usar session_id?
Saída session_id para depuração ou updates via nó Session — normalmente gerenciado automaticamente.
Um agente pode atender muitos contatos?
Sim — isolamento de sessão é por contact_phone_number.
Por que resposta vazia?
Verifique se o agente está habilitado, chaves de modelo configuradas e instruction não vazia após resolução de variáveis.
Artigos relacionados
Este artigo foi útil?
Precisa de mais ajuda? Falar com suporte