Nó Agent · agent

Referência do nó

Kind:agentCategoria:IA

Para que serve

Imagina que você tem um atendente muito bem treinado que sabe usar ferramentas, consultar documentos e tomar decisões por conta própria. O Nó Agent coloca esse atendente dentro do fluxo: quando o fluxo chega nesse bloco, o agent entra em ação, faz o trabalho dele (raciocínio, consultas, ações) e devolve o resultado para o fluxo continuar.

Quando usar

• Delegar ao agent uma tarefa que exige raciocínio e múltiplas etapas
• Integrar um atendente com IA em pontos específicos do fluxo (ex.: só para clientes VIP)
• Usar ferramentas MCP ou busca na web dentro do fluxo sem configurar tudo do zero
• Combinar a estrutura de um fluxo com a inteligência de um agent configurado separadamente

---

Como funciona

O Nó Agent é uma ponte entre o Flow Builder e o Agent Builder. Você configura o agent uma vez no Agent Builder (com instruções, memória, ferramentas, base de conhecimento) e depois o reutiliza em qualquer fluxo adicionando este nó.

Flow Builder
  ↓ (dados do contato, histórico, variáveis)
Nó Agent  →  Agent Builder (raciocínio + ferramentas)
  ↓ (resposta gerada pelo agent)
Próximo nó do fluxo

---

Passo a passo

1. ·
   Certifique-se de que o agent que você quer usar já está criado e publicado no Agent Builder.
   

   

   CAPTURAR: tela do Agent Builder com um agent configurado e o status 'Ativo' visível

2. ·
   Arraste o nó **Agent** para o canvas e conecte ao fluxo.
3. ·
   No painel, selecione o **Agent** desejado na lista de agents disponíveis.
   

   

   CAPTURAR: painel do nó agent com dropdown mostrando a lista de agents disponíveis para seleção

4. ·
   Configure a **Mensagem de entrada** — geralmente {{userinput.query}} ou uma mensagem montada por um nó anterior.
5. ·
   Salve. A resposta do agent fica disponível como {{agent.output}} para os nós seguintes.

---

Campos

Campo	O que faz
Agent	Qual agent executar (criado no Agent Builder)
Mensagem de entrada	O que o agent vai receber como input
Contexto adicional	Variáveis extras que o agent pode usar
Timeout	Tempo máximo de execução do agent (em segundos)

Saídas

Variável	Conteúdo
output	A resposta final gerada pelo agent
steps	Os passos intermediários realizados (para debugging)

---

Diferença entre Nó LLM e Nó Agent

	Nó LLM	Nó Agent
Raciocínio	Único passo	Multi-step (pensa, age, reavalia)
Ferramentas	Não	Sim (MCP, busca web, subagents)
Memória longa	Não	Sim (configurada no agent)
Configuração	No próprio nó	No Agent Builder, reutilizável

---

Saiba mais sobre o Agent Builder

Para aprender a criar e configurar agents completos — com instruções, memória, guardrails e ferramentas — acesse o guia dedicado:

Guia do Agent Builder →

Dica

O Nó Agent é ideal quando você quer que uma parte do fluxo seja "inteligente e autônoma" enquanto o resto do fluxo mantém controle total sobre o que acontece antes e depois.

Atenção

Um agent pode demorar mais para responder do que um nó LLM simples, porque ele pode executar várias etapas. Configure o timeout adequadamente para não ter respostas interrompidas em conversas longas.