AI Agent Node (Tools Agent) în n8n & Automatizări AI

Nodul central din n8n care transformă un model de limbaj într-un agent capabil să decidă singur ce unelte să apeleze, să păstreze memoria conversației și să respecte un System Prompt.

Configurare nod & expresie
Nod: AI Agent (Tools Agent)
Sub-conectori obligatorii:
  • Chat Model (OpenAI / Anthropic / Ollama)
  • Memory (opțional: Window Buffer / Postgres)
  • Tool (HTTP Request, SQL, Call Workflow, Google Calendar)

Descriere & Utilizare

Nodul AI Agent este piesa de rezistență a automatizărilor inteligente din n8n. În timp ce un lanț simplu (LLM Chain) execută un singur apel fix către model, nodul AI Agent rulează o buclă de raționament (ReAct / Tool Calling): primește cererea utilizatorului, analizează ce unelte are atașate la conectorul Tool, apelează una sau mai multe unelte cu parametrii potriviți și formulează răspunsul final.

În versiunile recente de n8n, modul implicit și recomandat este Tools Agent, care folosește suportul nativ de Function Calling al modelelor moderne (GPT-4o, Claude 3.5/3.7 Sonnet, Gemini 2.5, Qwen 2.5).

Sub nodul AI Agent vei observa patru porturi inferioare: Chat Model (creierul agentului), Memory (istoricul dialogului), Tool (acțiunile pe care le poate executa) și opțional Output Parser (pentru răspunsuri în format JSON strict).

Cum să o reții ușor

💡 Ca un manager de proiect într-o cameră de comandă: primește mesajul clientului, își consultă agenda (Memory), sună departamentul tehnic sau financiar (Tools) și apoi îi trimite clientului soluția completă.

Opțiuni și parametri tehnici

  • Prompt Source (Connected Chat Trigger / Define Below): preia automat mesajul din {{ $json.chatInput }} sau îți permite să construiești un prompt personalizat din orice nod anterior.
  • System Message: instrucțiunile de rol, regulile de business, tonul vocii și data curentă (ex: Astăzi este {{ $now.toISO() }}).
  • Max Iterations: numărul maxim de pași de apelare a uneltelor (implicit 10) pentru a preveni buclele infinite.
  • Return Intermediate Steps: când este activat, include în ieșirea nodului toate apelurile către unelte și răspunsurile brute pentru audit și depanare.

Exemple practice și cazuri de utilizare

  • Asistent de programări: conectează OpenAI Chat Model + Postgres Chat Memory + uneltele Google Calendar (Get Events & Create Event).
  • Injectarea datei curente în System Message: Ești asistentul tehnic dexblog. Data și ora curentă: {{ $now.format("yyyy-MM-dd HH:mm") }}. Răspunde concis în română.
  • Limitarea buclelor: setează Max Iterations = 5 pentru agenții expuși public pe WhatsApp sau Telegram.

Sfaturi de configurare & capcane

Include întotdeauna în System Message numele exact al uneltelor atașate și când trebuie folosite fiecare — modelele iau decizii mult mai rapide și mai precise când au reguli clare în promptul de sistem.

Comenzi și ghiduri înrudite