Műveletek

Élő adatok lekérése hívás közben

Hagyd, hogy az ügynök egy rendelésről, készletszintről vagy fiókról kérdezze a rendszeredet, amíg a hívó vár.

Az API eszköz RAG segítségével az ügynök a beszélgetés közepén élő adatokat kér a rendszeredtől — egy rendelés állapotát, egy termék készletét, egy fiók adatait —, és ezek alapján válaszol. Hogy mikor hívja meg, azt az ügynök a leírásod alapján dönti el.

Beállítás

1. Add hozzá az eszközt

   Nyisd meg az ügynököt → Műveletek → Eszköz hozzáadása → CRM és szolgáltatások → API eszköz RAG.

2. Írd le, és irányítsd a végpontodra

   Mező	Mit írj be
   Név	pl. Rendeléskeresés
   Általános feltétel	Mikor használja, pl. az ügyfél egy rendelés állapotáról kérdez
   API végpont URL	pl. https://api.yourshop.com/orders/{order_id} — a {placeholders} helyére az ügynök által összegyűjtött értékek kerülnek
   HTTP metódus	GET, POST, PUT, DELETE vagy PATCH
   Végrehajtási üzenet	Amit az ügynök mond, amíg vár, pl. Egy pillanat, ellenőrzöm a rendelését
   Kérés időtúllépés (ms)	Meddig várjon a válaszodra; alapértelmezés szerint 5000
   Fejlécek, Lekérdezési paraméterek	Opcionális fix értékek, pl. az API-kulcsod

3. Add meg, mit kell összegyűjtenie az ügynöknek

   A Paraméter-séma (JSON) felsorolja azokat az értékeket, amelyeket az ügynök a hívótól megtud és elküld — lásd lent. Ha egy kötelező érték hiányzik, az ügynök előbb rákérdez.

tanács

Mindig töltsd ki a Végrehajtási üzenet mezőt — a kérés alatti csend megszakadt hívásnak tűnik.

A paraméter-séma

Ez nem maga a kérés törzse, hanem az összegyűjtendő értékek JSON Schema leírása. Hová kerülnek:

Eset	Hová kerül az érték
Az URL tartalmazza a {name} részt	Az URL-be
GET, DELETE	A többi ?key=value formában
POST, PUT, PATCH	A többi JSON-törzsként

Rendeléskeresés szám alapján:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "A rendelés száma, amelyről az ügyfél kérdez, általában 6–10 számjegy. Ha nem adja meg, kérdezz rá."
    }
  },
  "required": ["order_id"]
}

Foglalás több értékkel:

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "Termékazonosító egy korábbi keresésből." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Hány darab. Alapértelmezés 1." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Hogyan szeretné az ügyfél átvenni." },
    "customer_email": { "type": "string", "format": "email", "description": "E-mail a visszaigazoláshoz. Ha nem adja meg, kérdezz rá." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Statikus végpont, pl. nyitvatartás: { "type": "object", "properties": {} }.

Jó sémák hanghoz:

• Maradjon lapos: 3–5 érték.
• Minden értékhez írj description leírást példákkal — ezek vezetik a legjobban az ügynököt.
• Rögzített választásokhoz használd az enum mezőt: az ügynök a „a kéket” választ blue értékre fordítja.
• Egy értéket csak akkor jelölj required-nek, ha nélküle a kérés nem működhet.
• Használj snake_case neveket, amelyek egyeznek az URL {placeholders} részeivel.

Felhasználási példák

• Rendelés állapota — „Hol tart a 482913-as rendelésem?”
• Elérhetőség — készlet vagy szabad asztal ellenőrzése a saját rendszeredben.
• Fiókkal kapcsolatos kérdések — egyenleg, szerződés vége, nyitott jegyek.

Gyakori problémák

Probléma	Mit ellenőrizz
Az ügynök sosem hívja meg	Az Általános feltétel nevezze meg a kérést
A végpontod üres értékeket kap	A séma neveinek pontosan egyezniük kell a {placeholders} részekkel
Az ügynök azt mondja, nem tudta ellenőrizni	A végpontod tovább tartott az időtúllépésnél, vagy hibával válaszolt

Kapcsolódó

• Ismerd meg a hívót, mielőtt a hívás elkezdődik — adatok a köszönés előtt
• MCP szerverek — sok eszköz egyetlen szerverről