Agent Node
Oktatóvideó
Az Agent Node minden IntraCord workflow alapvető építőköve. Tartalmazza a beszélgetést irányító LLM-promptot, az ügynök által hívható Toolokat, valamint a hivatkozott tudásbázisdokumentumokat. Egy workflow-ban több Agent Node is lehet, amelyek mindegyike a beszélgetés egy-egy szakaszát kezeli.
Az Agent Node-okhoz kapcsolódó Edge-ek olyan útvonalak, amelyeket az LLM-ek a beszélgetés eddigi menetétől függően használhatnak.
Mi kerül az Agent Node-ba
Kérés
Az ügynök viselkedésére vonatkozó utasítások ebben a lépésben. Legyen egyértelmű a sorrendben: ha az ügyintézőnek meg kell erősítenie a személyazonosságát, mielőtt megbeszélné a fizetést, mondja ezt a promptban. A homályos promptok következetlen viselkedést eredményeznek.
Toolok
Külső funkciók, amelyeket az ügynök hívhat meg ebben a lépésben – például számlaegyenlegek keresése vagy CRM-rekord frissítése. Adjon hozzá Toolokat a Node beállítási paneljének „HTTP és Toolok” vagy „MCP” lapján.
Megszakítás engedélyezése
Ha be van kapcsolva, a hívó félbeszakíthatja az ügynököt a beszéd közben.
Global Prompt hozzáadása
Ha be van kapcsolva, és létezik globális Node, akkor a Globális Prompt a Node Promptja elé kerül futás közben. Alapértelmezés szerint be.
Tudásbázis-dokumentumok
Fájlok, amelyekre az ügynök hivatkozhat, amikor kérdésekre válaszol – termékismertetők, GYIK, irányelvek. Csatolja őket a "Dokumentumok kezelése" gombbal a Node beállításai panelen.
Edge-ek konfigurálása
Minden kimenő Edge-nek van egy egyszerű nyelven írt feltétele. Az LLM kiértékeli a beszélgetést, és kiválasztja azt az Edge-et, amelynek állapota a legjobban megfelel.
Írja le az élfeltételeket a lehető legpontosabban:
| Homályos (kerülje) | Specifikus (felhasználás) |
|---|---|
| "Adós válaszol" | "Az adós megerősíti személyazonosságát, és készen áll a számla megvitatására" |
| "Hívás vége" | "Az adós kötelezettséget vállal egy meghatározott fizetési mód mellett, és megadja az összeget" |
| "Probléma" | "Az adós vitatja az adósságot, vagy hitelesítési dokumentációt kér" |
Változók kinyerése
Az Agent Node ki tudja bontani a strukturált adatokat a beszélgetésből, miután a Node befejeződött. Engedélyezze ezt a Node beállításainál a „Változók kivonásának engedélyezése” alatt.
Miután engedélyezte, konfiguráljon két dolgot:
- Extraction Prompt: általános utasítások, amelyek elmondják az LLM-nek, hogyan kell megközelíteni a kivonást.
- Kicsomagolandó változók: változók listája, mindegyik névvel, adattípussal (
string,number,boolean) és változónkénti utalással, amely leírja, hogy mit kell rögzíteni.
Például:
Extraction Prompt:
Extract the payment outcome from this debt collection call.
Variables:
- amount_user_will_pay (string): Amount the user said they will pay.
- payment_method (string): How they said they will pay, e.g. card, bank transfer.
- sentiment (string): User tone: cooperative, hesitant, angry, refused.
Minden kinyert érték a gathered_context objektumban tárolódik. Ezek az adatok Node Promptban nem érhetők el; hivatkozzon rájuk a Webhook Node payloadjában {{gathered_context.variable_name}} formában, vagy olvassa ki őket az Agent Run rekordjából a hívás befejezése után.
Több Agent Node használata
Bontsa fázisokra az összetett beszélgetéseket. Minden Agent Node a folyamat egy részét kezeli. Egy adósságbehajtási workflow például három Agent Node-ot láncolhat: a személyazonosság-ellenőrzést, az ajánlatok bemutatását és a kifogáskezelést.
A Node-ok automatikusan továbbadják a beszélgetési kontextust, a kinyert változókat azonban nem illesztik be a későbbi Promptokba. Az egyes Node-ok által kinyert értékeket a rendszer a gathered_context objektumban egyesíti. Erre csak a Webhook Node payloadjában vagy a hívás után az Agent Run rekordjában hivatkozhat. Ha egy későbbi Agent Node-nak egy korábban elhangzott információra kell reagálnia, ezt a Prompt utasításaiban és a beszélgetési kontextus alapján kell kezelnie, nem {{gathered_context...}} hivatkozással.
Gyakori hibák
Nincsenek kimenő Edge-ek. Minden Agent Node-nak szüksége van legalább egy Edge-re. A zsákutcában lévő Node-nak nincs kilépési útvonala, és csapdába ejti a hívást.
Globális utasítások elhelyezése az Agent promptban. A teljes workflow-ra érvényes szabályok – személy, hang, megfelelőségi védőkorlátok – a Globális Node részei, nem ismétlődnek meg minden ügynök Node-ban.
Homályos Edge-feltételek. Az LLM kiválasztja a beszélgetés állapotának leginkább megfelelő Edge-et. A túlságosan tág feltételek kiszámíthatatlan útválasztást okoznak a Node-ok között.
Következő lépések
Fejezze be a beszélgetést egy záró üzenettel.
Írjon megosztott utasításokat, amelyek minden Node-ra vonatkoznak.
Ismerje meg, hogyan épül fel a gathered_context, és hol lehet rá hivatkozni.
Minden hívás után automatikusan értékelje az ügynök teljesítményét.