Ce face AI Agent
AI Agent conectează un chat model și una sau mai multe unelte; modelul decide ce unealtă cheamă și cu ce parametri, apoi formulează răspunsul. Trebuie conectată cel puțin o unealtă. Memoria și output parser-ul sunt opționale.
Setarea veche de tip de agent este depreciată din n8n 1.82.0: toate nodurile AI Agent lucrează acum ca Tools Agent, care folosește interfața de tool calling din LangChain. Versiunea 1 a nodului, cu tipurile Conversational Agent, OpenAI Functions Agent, Plan and Execute Agent, ReAct Agent și SQL Agent, este eliminată în n8n 3.0. Pentru cazurile SQL Agent, documentația recomandă o unealtă Postgres sau MySQL conectată la un AI Agent recent.
Promptul vine fie din câmpul chatInput al nodului anterior (de obicei Chat Trigger), fie îl definești tu. Cu Enable Streaming (pornit implicit), răspunsul ajunge la utilizator pe măsură ce e generat, dacă triggerul suportă streaming: Chat Trigger sau Webhook cu Response Mode Streaming. Pentru uneltele sensibile poți cere aprobare umană din secțiunea Human review a conectorului Tool.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
Source for Prompt (User Message) |
Connected Chat Trigger Node (citește chatInput) sau Define below (text sau expresie în Prompt (User Message)). |
Require Specific Output Format |
Cere conectarea unui output parser: Auto-fixing, Item List sau Structured Output Parser. |
Enable Fallback Model |
Adaugă un al doilea port de chat model, folosit când modelul principal eșuează. |
System Message |
Mesaj trimis agentului înainte de conversație, pentru a-i ghida deciziile. |
Max Iterations |
De câte ori rulează modelul ca să ajungă la un răspuns. Implicit 10. |
Return Intermediate Steps |
Include în ieșire pașii intermediari ai agentului. |
Tracing Metadata |
Perechi cheie-valoare adăugate în evenimentele de tracing (de exemplu LangSmith). Intrările goale se ignoră. |
Automatically Passthrough Binary Images |
Trimite imaginile binare la agent ca mesaje de tip imagine. |
Enable Streaming |
Trimite răspunsul în timp real. Pornit implicit. |
Exemple practice
Exemplul 1: Asistent de chat cu memorie și unelte
Chat Trigger -> AI Agent
Chat Model: OpenAI Chat Model
Memory: Simple Memory (Session ID: Connected Chat Trigger Node)
Tool: Google Calendar
Tool: Call n8n Workflow Tool
Exemplul 2: Data curentă în System Message
Ești asistentul tehnic al firmei. Data curentă: {{ $now.toFormat('yyyy-MM-dd HH:mm') }}. Răspunde concis, în română.
Greșeli frecvente și bune practici
- Eroarea
No prompt specifiedcând promptul nu vine de la un Chat Trigger: schimbă sursa promptului din Connected Chat Trigger Node în Define below. - Eroarea
A Chat Model sub-node must be connected: agentul nu poate rula fără model. - Eroare în sub-nodul Simple Memory pe fluxuri vechi sau copiate din șabloane (fostul Window Buffer Memory): șterge nodul de memorie și adaugă-l din nou, ca să ai ultima versiune.