Agents ai_agent

Agente IA

Agente conversacional com memória de sessão, injeção de contexto recuperado e chamadas a sub-fluxos como ferramentas.

O que faz?

É o cérebro conversacional do seu fluxo. Um assistente com Inteligência Artificial que conversa com seu cliente, entende suas intenções e responde naturalmente.

Como funciona?

Usa modelos de linguagem avançados (LLMs) configurados com seu prompt (instruções). Lê a memória de conversas passadas (session memory) e pode usar 'ferramentas' (como consultar seu estoque ou buscar no seu Base de Conhecimento) antes de responder.

Por que usar?

É indispensável para qualquer bot de suporte, vendas ou perguntas frequentes. Sem este nó, você teria que programar botões e menus rígidos para cada possível pergunta.

Entradas

nome	tipo
`text`	string

Saídas

nome	tipo
`content`	string
`model`	string
`turn_index`	number
`streamed`	boolean
`tool_calls`	array

Ramificações

Ramificações fixas

success — Sucesso
error — Erro

Configuração

model string opcional

vision_model string opcional

role "copilot" | "chatbot" opcional

system_prompt string opcional

input_field string obrigatório padrão: "text"

memory_key string obrigatório padrão: "messages"

history_turns integer obrigatório padrão: 20

temperature number obrigatório padrão: 0.7

max_tokens integer opcional

reasoning "off" | "low" | "medium" | "high" opcional

injectors array<object> opcional

stream boolean obrigatório padrão: true

context_memory_keys array<string> obrigatório padrão: []

reply_memory_key string opcional

tools array obrigatório padrão: []

max_tool_iterations integer obrigatório padrão: 5

recent_turns integer opcional

memory_facts_schema object opcional

memory_summary_config object opcional

auto_retrieve object opcional

Configuração padrão

{
  "model": "deepseek/deepseek-v4-flash",
  "system_prompt": "You are a helpful assistant. Reply in the user language.",
  "input_field": "text",
  "memory_key": "messages",
  "history_turns": 20,
  "temperature": 0.7,
  "max_tokens": 1024,
  "stream": true,
  "context_memory_keys": [],
  "tools": [],
  "max_tool_iterations": 5
}

Eventos emitidos

node.token
Tokens da resposta em streaming (um evento por fragmento).
agent.reply
Resposta final com modelo, tamanho e flag de streaming.
agent.tool_call_started
Dispara quando o LLM solicita uma ferramenta, antes da execução.
agent.tool_call_completed
Dispara após uma chamada de ferramenta resolver (sucesso ou erro).
tool_call.<name>
Emissão por cada ferramenta inline. O <name> é o nome declarado pela ferramenta.
agent.tool_iteration_limit
O modelo atingiu o limite de iterações de ferramentas com chamadas pendentes.