Folyamatautomatizálás Claude Code és n8n-nel · Lecke 06

AI beépítése az n8n workflowba

Ebben a leckében megnézzük, hogyan kerül be a Claude egy n8n folyamatba. Megismerjük a cluster node felépítést, bekötjük a Claude-ot az AI Agenthez, és tisztázzuk, mikor elég a natív node, és mikor kell inkább a HTTP Request node a Messages API-hoz.

Vissza a tananyaghoz

Cluster node, egy root és a sub-node-ok

Az n8n AI funkciói nem egyetlen mindent tudó node-ból állnak, hanem úgynevezett cluster node felépítésre épülnek. Egy root node adja a fő funkciót, és köré egy vagy több sub-node csatlakozik, amely kiterjeszti a működését. Ezek a node-ok a LangChain keretrendszerre épülnek. A legfontosabb root node az AI Agent, amely alapértelmezetten a Tools Agentként működik. Köré kerül a chat model, a memória és a tool sub-node.

AI Agent root node, Tools Agent Anthropic Chat Model a Claude modell, kötelező Memory opcionális, kontextushoz Tool legalább egy kell A sub-node-ok alulról, dedikált csatlakozókkal kapcsolódnak a root node-hoz
Az AI Agent a root node, alá csatlakozik a chat model, a memória és a tool sub-node. Chat model és legalább egy tool nélkül a node nem hajtható végre.

A Claude bekötése az AI Agenthez

A Claude-ot az Anthropic Chat Model sub-node adja hozzá az AI Agenthez. Ez a sub-node teszi elérhetővé az Anthropic Claude modellcsaládot a beszélgetős agentekhez. A hitelesítéshez Anthropic credential kell, amelyhez egy API kulcsot kell létrehozni. A kulcs az Anthropic Console Settings menüjének API Keys pontjában készül, majd a Copy Key gombbal kimásolva bekerül az n8n credentialbe. Ugyanezt a credentialt használja az önálló Anthropic node és az Anthropic Chat Model is.

  1. Anthropic credential létrehozásaAz Anthropic Console Settings menüjének API Keys pontjában a Create Key gombbal generálsz egy kulcsot, például n8n-integration névvel, majd a Copy Key gombbal kimásolod.
  2. AI Agent node hozzáadásaA workflowba felveszed az AI Agent root node-ot, amely alapértelmezetten Tools Agentként működik.
  3. Anthropic Chat Model csatlakoztatásaAz AI Agent alá kötöd az Anthropic Chat Model sub-node-ot, és beállítod nála az imént létrehozott Anthropic credentialt.
  4. Tool és memória hozzáadásaLegalább egy tool sub-node kötelező, a memória sub-node opcionális, folyamatos, több lekérdezéses beszélgetéshez.

Az adat útja az agentbe és vissza

Amikor a workflow eljut az AI Agentig, a bejövő adat a root node-hoz kerül. Az agent a chat model sub-node segítségével dönt, a tool sub-node-okat használja a részfeladatokhoz, és ha van memória, onnan hozza a korábbi kontextust. A végén a válasz visszakerül a workflowba, és a következő node dolgozik vele tovább. A cserélhető felépítés előnye, hogy a Claude-ot adó Anthropic Chat Model sub-node kicserélhető másik LLM sub-node-ra anélkül, hogy a workflow többi része változna.

Bejövő adat előző node AI Agent tervez és dönt Chat Model Tool Válasz következő node Az adat belép az agentbe, a sub-node-ok segítik a döntést, a válasz visszatér a workflowba
Az AI Agent a bejövő adatból a chat model és a tool sub-node-ok segítségével dolgozik, majd a válasz visszakerül a következő node-hoz.

Natív node vagy HTTP Request

Ha van natív Anthropic vagy Anthropic Chat Model node, azt érdemes használni, mert kevesebb konfigurációt és egyszerűbb credential kezelést jelent. Az önálló Anthropic app node az agentikus felhasználáson túl közvetlen, egyszeri Claude hívásokat is kínál, ilyen a Message a Model, az Analyze Document, az Analyze Image, a fájlkezelés és a prompt eszközök. Ha egy Anthropic funkció nincs natív node-ra képezve, akkor a HTTP Request node hívja közvetlenül a Messages API-t.

Natív Anthropic node

  • Message a Model, egyszeri Claude hívás
  • Analyze Document és Analyze Image
  • Fájlkezelés és prompt eszközök
  • Credential egy helyen, kevés beállítás

HTTP Request a Messages API-hoz

  • Akkor, ha nincs natív lefedettség
  • POST hívás az api.anthropic.com címre
  • Fejlécek és JSON body kézzel
  • Bármely REST API elérhető így

A Messages API hívása HTTP Request node-ból

A HTTP Request node az n8n egyik legsokoldalúbb node-ja, bármely REST API-t lekérdez, és AI Agenthez toolként is csatolható. A Messages API hívása POST metódussal megy a v1/messages végpontra. Kötelező fejléc a Content-Type, az anthropic-version a 2023-06-01 értékkel, és az x-api-key az API kulccsal. A body kötelező mezői a model, a max_tokens és a messages tömb a user és assistant szerepekkel.

2023-06-01

A kötelező anthropic-version fejléc értéke. A Messages API POST hívása a https://api.anthropic.com/v1/messages végpontra megy, a Content-Type, az anthropic-version és az x-api-key fejlécekkel, a body-ban a model, a max_tokens és a messages mezőkkel.

ANTHROPIC APP NODE közvetlen, egyszeri Claude hívások Text, Message a Model Document, Analyze Document Image, Analyze Image File és Prompt eszközök HTTP REQUEST NODE a Messages API közvetlen hívása POST v1/messages Content-Type fejléc anthropic-version és x-api-key body, model, max_tokens, messages
Az önálló Anthropic node kész műveletekkel dolgozik, a HTTP Request node pedig fejlécekkel és JSON body-val közvetlenül hívja a Messages API-t.

Több agent egy workflowban

Ha egy folyamatban több, feladatra szakosodott agentre van szükség, az AI Agent Tool node teszi lehetővé, hogy egy root szintű agent más agenteket eszközként hívjon meg. Az elsődleges agent felügyeli és delegálja a munkát a specializált AI Agent Tool node-oknak. Így több agent használható egyetlen workflowban a sub-workflow-k kontextus és változókezelési bonyolultsága nélkül.

Root AI Agent felügyel és delegál AI Agent Tool részfeladat A AI Agent Tool részfeladat B AI Agent Tool részfeladat C
Multi-agent orchestrációnál a root agent az AI Agent Tool node-okat hívja eszközként, és delegálja rájuk a szakosodott részfeladatokat.
← Előző lecke Következő lecke →

Workshop

AI Transformation Day

Egésznapos, vezetőknek szóló program. Feltérképezzük, hol tart a szervezet, mi az első reális lépés, és milyen belső feltételek szükségesek a sikerhez. A nap végén konkrét, prioritizált cselekvési lista.

Érdekel a program →