Ugrás a fő tartalomhoz

HTTP API

A HTTP API Toolokkal külső REST API-hívásokat rendelhetsz közvetlenül a workflow Node-jaihoz. A Voice Agent így élő beszélgetés közben, az LLM döntése és a prompt utasításai alapján bármilyen belső vagy külső rendszert meghívhat. A működés az ügynökplatformok függvényhívásához hasonló, teljesen nyílt forráskódú és testreszabható.

Videós útmutató​

Mi az a HTTP API Tool?​

A HTTP API Tool olyan REST API-definíció, amelyet az LLM futásidőben meghívhat.

Gyakori felhasználási esetek:

  • Saját backend endpointok meghívása.
  • n8n-automatizálások indítása.
  • Adatok szinkronizálása CRM-rendszerrel.
  • Adatok lekérése külső API-kból, például időjárásról, árakról vagy elérhetőségről.
  • Adatok létrehozása, frissítése és lekérése REST API-val.

Az LLM dönti el:

  • melyik Toolt hívja meg;
  • mikor hívja meg;
  • milyen paramétereket küldjön.

A döntés alapja:

  • a promptok, vagyis a Node egyszerű nyelven megadott utasításai;
  • a Tool neve;
  • a Tool leírása;
  • a paraméterek definíciói.

HTTP API Tool meghatározása​

1. A Tool neve​

  • Legyen egyértelmű és műveletközpontú.
  • Példák: capture_lead_interest, fetch_weather, create_crm_contact.

2. A Tool leírása​

  • Kiemelten fontos.
  • Az LLM ebből állapítja meg, mikor használja a Toolt.
  • Írd le világosan és egyértelműen.

Rossz példa:

„API adatok rögzítéséhez”

Jó példa:

„Ez a Tool rögzíti az érdeklődést. Akkor használd, ha a felhasználó egyértelműen érdeklődik a termék iránt, vagy kapcsolatfelvételt kér.”

Példa a Tool leírására

3. Endpoint beállítása​

  • Teljes URL, amelynek tartalmaznia kell a http:// vagy https:// előtagot.
  • Támogatja a REST metódusokat.

4. Hitelesítés és fejlécek​

  • Egyéni hitelesítés adható meg.
  • Egyéni fejlécek állíthatók be.
  • Belső szolgáltatásokkal és külső API-kkal is működik.

5. Paraméterek​

Minden paraméterhez add meg:

  • a nevet;
  • a típust;
  • a leírást;
  • hogy kötelező vagy opcionális.

A paraméterleírás gyakran fontosabb, mint maga a típus.

Irányelvek:

  • Lehetőség szerint kezdd szöveges paraméterekkel.
  • Pontosan írd le, mit jelent az érték.
  • Csak a valóban nélkülözhetetlen mezőket jelöld kötelezőnek.

Példa:

  • interest (string): „Legyen true, ha a felhasználó egyértelmű vásárlási szándékot jelez vagy visszahívást kér. Ellenkező esetben false.”

Példa paraméterre


Toolok hozzárendelése workflow Node-okhoz​

  • Egy Node-hoz több Tool is rendelhető.
  • Az összes létrehozott Tool kiválasztható a Node-ban.
  • Egy Tool csak akkor hívható meg, ha hozzá van rendelve az adott Node-hoz.
  • Az LLM választja ki, melyiket hívja meg.

A Node-ban egyszerű, egyértelmű utasítással vezesd az LLM-et.

Példa:

„Ha a felhasználó értékesítővel szeretne beszélni vagy visszahívást kér, azonnal hívd meg a capture_lead_interest Toolt, és állítsd az interest értékét true-ra.”

Ez az utasítás gyakran meghatározó a Tool helyes használatához.

Példa Tool hozzárendelésére


A Tool Call logikája​

Az LLM a következőket veszi figyelembe:

  • a felhasználó kimondott szándékát;
  • a Node promptjának utasításait;
  • a Tool nevét és leírását;
  • a paraméterek leírását.

Ha ezek összhangban vannak és egyértelműek, a Tool automatikusan meghívódik.

A rossz elnevezés vagy homályos leírás következménye lehet:

  • elmaradó Tool Call;
  • hibás paraméterek;
  • kitalált értékek.

Legfontosabb bevált gyakorlatok​

  • Adj egyértelmű nevet a Tooloknak.
  • Írj részletes, műveletközpontú leírásokat.
  • Kezdetben tartsd egyszerűen a paramétereket.
  • Az URL-ekben mindig szerepeljen a http:// vagy https:// előtag.
  • Adj világos utasításokat a Node promptjában.
  • Csak a releváns Toolokat rendeld az egyes Node-okhoz.

Jól meghatározott Toolok + egyértelmű promptok = megbízható, production használatra alkalmas Voice Agentek.