Connect tools & data

API-kapcsolatok

Alakítson bármely HTTP API-t az ügynöke által beszélgetés közben meghívható funkcióvá: illesszen be egy cURL-parancsot, és a varázsló létrehozza az eszközdefiníciót, a paramétereket és a hitelesítést.

Az API-kapcsolatok egyedi HTTP-függvények, amelyeket az ügynökei egy beszélgetés során hívhatnak meg — például rendelés lekérdezésére, hibajegy létrehozására vagy fiókállapot lekérésére a saját backendjéből. Az végpontot egyszer határozza meg a Kapcsolatok → API-k alatt (/dashboard/api-connections); azok az ügynökök, amelyekhez a kapcsolat hozzá van rendelve, akkor hívhatják meg, amikor a beszélgetés ezt igényli.

Kétféleképpen hozhat létre ilyet: beilleszthet valamit, amit a varázsló elemezni tud, vagy manuálisan állíthatja be a kapcsolatot.

A gyors megoldás: beillesztés és elemzés#

1. Kattintson az Új API-kapcsolat elemre

   A párbeszédablak a varázslóval nyílik meg. Illesszen be a mezőbe egy minta cURL-parancsot, OpenAPI/Swagger-specifikációt, Postman-exportot, TypeScript-interfészt vagy Zod-sémát.

2. Kattintson az Elemzés elemre

   A ThunderPhone a beillesztett tartalom alapján kikövetkezteti a teljes kapcsolatot — az URL-t, a metódust, a fejléceket, valamint a megtalált lekérdezési paraméterekből és kérelemtörzsből származtatott paramétersémát. A beillesztett fejlécek, köztük a hitelesítési fejlécek is, bekerülnek a végpont konfigurációjába.

3. Erősítse meg a kiemelt mezőket

   A kikövetkeztetett konfiguráció a feltételezett mezők kiemelésével nyílik meg ellenőrzésre. Módosítsa a neveket, leírásokat és paramétertípusokat, hogy az ügynök megértse, mikor és hogyan kell meghívnia a függvényt — a modell a leírást olvassa.

4. Érvényesítés és mentés

   Mentéskor a rendszer először élő tesztkérést futtat a végpontja ellen. Ha a kérés sikertelen, a kapcsolat nem kerül mentésre — javítsa az URL-t, a hitelesítési fejléceket vagy a törzset, majd próbálja újra. Siker esetén a kapcsolat Érvényesítve jelvénnyel kerül tárolásra.

Ha a varázsló nem talál kérési URL-t a beillesztett tartalomban, ezt jelzi — adjon meg egy teljes http(s) végpontot, majd próbálja újra.

Manuális beállítás#

Kattintson a varázslóban a Manuális beállítás → elemre (vagy a visszalépéshez a Szeretné, hogy az AI kikövetkeztesse? Próbálja ki a varázslót → elemre). A manuális szerkesztő két szerkesztőt tartalmaz:

• Vizuális — űrlapmezők a megjelenítési névhez, a függvénynévhez, a kérési URL-hez, a metódushoz (POST, GET, PUT, PATCH, DELETE), az egyedi fejlécekhez és a paramétersémához (Tulajdonság hozzáadása minden olyan argumentumhoz, amelyet az ügynök megadhat).
• JSON — ugyanaz a definíció nyers JSON-ként, eszközspecifikáció közvetlen beillesztéséhez vagy finomhangolásához.

A Tesztkérés panel (opcionális) lehetővé teszi a konfigurált kérés elküldését mentés előtt, és megjeleníti az állapotot, a késleltetést, valamint a válasz előnézetét. Az Érvényesítés és mentés mindig lefuttatja ezt a tesztet, és csak siker esetén ment.

Kapcsolatok kezelése#

Minden kapcsolati sor megjeleníti az érvényesítési állapotát — Érvényesítve, Nem tesztelt vagy Hiba —, a függvénynevét, valamint azt, hogy mely ügynökök használják. A sor műveleti menüjéből a következőket teheti:

• Szerkesztés — újra megnyitja a konfigurációt.
• Klónozás — kiindulópontként lemásolja (a másolat Nem tesztelt állapotban indul).
• Verzióelőzmények — megtekintheti a korábbi verziókat, és visszaállíthat egyet a szerkesztőbe.
• Átvitel — átmásolhatja vagy áthelyezheti a kapcsolatot egy másik szervezetbe, amelynek tagja. Az áthelyezés innen eltávolítja; az azt használó ügynökök újrakonfigurálást igényelhetnek.
• Törlés — végleges; a kapcsolatot használó ügynököket újra kell konfigurálni.

Csatlakoztatás ügynökhöz#

Adja hozzá a kapcsolatot egy ügynökhöz a szerkesztő API-kapcsolatok szakaszában (Ügynök létrehozása). A lista megjeleníti, hogy mely ügynökök használják az egyes kapcsolatokat, így egy pillantással láthatja, mire van hatással egy módosítás.

Következő lépések#