Skip to main content
Az API-kapcsolatok egyedi HTTP-funkciók, amelyeket az ügynökei hívás közben használhatnak — 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 háttérrendszeréből. A végpontot egyszer határozza meg a Kapcsolatok → API-k alatt (/dashboard/api-connections); azok az ügynökök, amelyekhez a kapcsolat csatolva van, akkor hívhatják meg, amikor a beszélgetés ezt igényli. Kétféleképpen hozhat létre kapcsolatot: illesszen be valamit, amit a varázsló elemezni tud, vagy állítsa be a kapcsolatot manuálisan.

​
A gyors út: beillesztés és elemzés

1

Kattintson az Új API-kapcsolat lehetőségre

A párbeszédablak a varázslón 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 lehetőségre

A ThunderPhone a beillesztett tartalom alapján kikövetkezteti a teljes kapcsolatot — az URL-t, a metódust, a fejléceket, valamint az általa talált lekérdezési paraméterekből és kéréstörzsből származtatott paramétersémát. A beillesztett fejlécek (beleértve a hitelesítési fejléceket 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 felülvizsgálathoz kiemelt feltételezett mezőkkel nyílik meg. 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 funkciót — a modell a leírást olvassa.
4

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

A mentés először élő tesztkérést futtat a végpontja ellen. Ha a kérés sikertelen, a rendszer nem menti a kapcsolatot — 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 mentésre.
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 → lehetőségre (vagy a visszalépéshez az Azt szeretné, hogy az AI következtesse ki? Próbálja ki a varázslót → lehetőségre). A manuális szerkesztő két szerkesztőt tartalmaz:
  • Vizuális — űrlapmezők a megjelenítési névhez, a funkciónévhez, a kérés URL-jéhez, metódusához (POST, GET, PUT, PATCH, DELETE), egyéni fejlécekhez és a paramétersémához (Tulajdonság hozzáadása minden 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.
Egy opcionális Tesztkérés panel 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 és 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.
Adjon a paramétereknek közérthető leírásokat (“Az ügyfél e-mail-címe, pl. jane@example.com”). Az ügynök ezekből a leírásokból választja ki az argumentumokat valós időben, hívás közben.

​
Kapcsolatok kezelése

Minden kapcsolatsor megjeleníti az érvényesítési állapotát — Érvényesítve, Nem tesztelt vagy Hiba —, a funkciónevét és 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 megkettőzi a kapcsolatot (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 eltávolítja innen; előfordulhat, hogy az azt használó ügynököket újra kell konfigurálni.
  • Törlés — végleges; a kapcsolatot használó ügynököket újra kell konfigurálni.

​
Csatolja ü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, 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

Eszközintegrációk API-n keresztül

Hozza létre és kezelje programozottan ugyanazokat a kapcsolatokat.

Alkalmazások csatlakoztatása

Előre elkészített Google-, Slack-, HubSpot-, Salesforce- és Cal.com-kapcsolatok.

MCP-szerver hozzáadása

Tegyen elérhetővé egy teljes eszközszervert az ügynökei számára.

Integrációk API-referenciája

Az integrációs erőforrás minden mezője.