> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API-kapcsolatok

> Alakítson bármely HTTP API-t olyan függvénnyé, amelyet ügynöke a beszélgetés közben meghívhat — illesszen be egy cURL-parancsot, a varázsló pedig elvégzi a többit.

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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="É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.
  </Step>
</Steps>

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.

<Tip>
  Adjon a paramétereknek közérthető leírásokat ("Az ügyfél e-mail-címe, pl. [jane@example.com](mailto: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.
</Tip>

## 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](/hu/guides/build-an-agent)). 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

<CardGroup cols={2}>
  <Card title="Eszközintegrációk API-n keresztül" icon="code" href="/hu/guides/build-tool-integration">
    Hozza létre és kezelje programozottan ugyanazokat a kapcsolatokat.
  </Card>

  <Card title="Alkalmazások csatlakoztatása" icon="cable" href="/hu/guides/connect-apps">
    Előre elkészített Google-, Slack-, HubSpot-, Salesforce- és Cal.com-kapcsolatok.
  </Card>

  <Card title="MCP-szerver hozzáadása" icon="server" href="/hu/guides/mcp-servers">
    Tegyen elérhetővé egy teljes eszközszervert az ügynökei számára.
  </Card>

  <Card title="Integrációk API-referenciája" icon="book" href="/api-reference/integrations">
    Az integrációs erőforrás minden mezője.
  </Card>
</CardGroup>