--- title: "API-kapcsolatok" description: "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 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**. 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. 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. 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. A fejlécértékek csak írhatók. Mentés után titkosítva lesznek, és többé nem jelennek meg sem az irányítópulton, sem az API-ban. Kapcsolat szerkesztésekor a mentett fejléc a nevét jeleníti meg, az érték helyén pontokkal és egy **Mentve** megjegyzéssel: hagyja változatlanul a mentett érték megtartásához, vagy írjon be újat a lecseréléséhez. A tesztkérések és az élő hívások a mentett értéket használják. A **Klónozás** a mentett értékeket az új kapcsolatba másolja. Adjon a paramétereknek közérthető leírásokat ("Ügyfél e-mail-címe, pl. jane@example.com"). Az ügynök valós időben, hívás közben ezekből a leírásokból választja ki az argumentumokat. ## 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](/hu/guides/build-an-agent)). 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 Hozza létre és kezelje ugyanezeket a kapcsolatokat programozott módon. Előre elkészített Google-, Slack-, HubSpot-, Salesforce- és Cal.com-kapcsolatok. Tegyen elérhetővé egy teljes eszközszervert az ügynökei számára. Az integrációs erőforrás minden mezője.