Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

GPT-d összekapcsolása külső API-kkal

9. lecke 17 közül Frissítve 2026. november 5. Középhaladó
Ezen az oldalon
  1. Túl a standalone GPT-n
  2. Mi az a művelet (Action)?
  3. Az OpenAPI séma
  4. Művelet konfigurálása a GPT szerkesztőben
  5. Rajtad a sor: Egy nyilvános API
  6. Főbb megállapítások

Állapot 2026. november 5-én: A GPT-k az utolsó hetüket élik. Az OpenAI 2026. december 11-én (bizonyos mentességgel rendelkező Enterprise munkaterületeken 2027. február 11-én) megszünteti az egyéni GPT-ket. A személyes, ingyenes, Go, Plus és Pro fiókok már nem hozhatnak létre vagy tehetnek közzé új GPT-ket; a Business, Enterprise és Edu munkaterületeken a létrehozás a beállításoktól függ, és az érintett Enterprise munkaterületeken 2026. október 26-án megszűnt. A meglévő GPT-k a nyugdíjazásig használhatók és szerkeszthetők maradnak, ha a csomagod ezt lehetővé teszi; a velük folytatott beszélgetéseid ezt követően is elérhetők maradnak. A migráció (Migrate to plugin, a Saját GPT-k menüben) az utasításokat készséggé, a tudásbázist hivatkozási fájlokká, a csatlakoztatott alkalmazásokat pedig alkalmazásokká alakítja; az egyéni műveletek nem kerülnek át. Ez a lecke elmagyarázza, hogyan működnek a GPT-k, hogy segítsen karbantartani őket, migrálni őket, és elveiket egy bővítményre (bővítményekre) alkalmazni (15–17. leckék).

Túl a standalone GPT-n

Eddig a GPT-d elszigetelten működött: az utasításai határozzák meg a viselkedését, a Tudásbázis pedig a dokumentumaidat biztosítja. Ez erőteljes, de el van vágva az élő világtól. Nem tudja valós időben ellenőrizni a CRM-edet, naptáreseményt létrehozni vagy lekérdezni az adatbázisodat – csak azt tudja, amit feltöltöttél, mégpedig a feltöltés időpontjában befagyott állapotban. A Műveletek (Actions) megszüntetik ezt a korlátot: lehetővé teszik, hogy a GPT-d beszélgetés közben külső API-kat hívjon meg, hogy adatokat olvasson és írjon az eszközeidbe.

Mi az a művelet (Action)?

A művelet egy kapcsolat a GPT-d és egy külső szolgáltatás között annak API-ján keresztül. A folyamat mindig ugyanaz: a felhasználó feltesz egy kérdést vagy utasítást ad, a GPT felismeri, hogy külső adatokra van szüksége a válaszadáshoz, meghívja a szolgáltatás API-ját, majd megkapja a választ, és beépíti azt a végső válaszába. Vegyünk egy CRM-hez kapcsolódó értékesítési GPT-t: amikor a felhasználó azt kérdezi: „Mi a Dupont-ügyfél státusza?“, a GPT lekérdezi a CRM API-t, lekéri az ügyfélrekordot, és a mai adatokkal válaszol – nem pedig egy három hónappal ezelőtt feltöltött fájl emlékével. Mindez a felhasználó számára átláthatóan történik, aki egyszerűen úgy érzi, jól informált asszisztenssel beszélget.

Az OpenAPI séma

Ahhoz, hogy a GPT hívni tudjon egy API-t, le kell írnod azt. Erre szolgál az OpenAPI séma (korábban Swagger), egy JSON vagy YAML fájl, amely az API használati utasításaként funkcionál. Leírja a végpontokat (endpointok) – azokat az URL-címeket, amelyeket a GPT meghívhat –, a hozzájuk tartozó metódusokat (GET az olvasáshoz, POST a létrehozáshoz, PUT a frissítéshez, DELETE a törléshez), az egyes végpontok által várt paramétereket, valamint a visszaküldött válaszok formátumát. E dokumentum alapján a GPT a beszélgetés során önállóan dönti el, melyik végpontot hívja meg és milyen paraméterekkel.

Íme egy minimális séma egy kitalált időjárás-API-hoz:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Jó hír: szinte soha nem kell nulláról megírnod ezt a fájlt. Sok szolgáltatás közvetlenül közzéteszi az OpenAPI sémáját az API dokumentációjában. Ha nem, olyan eszközök, mint a Swagger Editor – vagy maga a ChatGPT, ha leírod neki az API-t – képesek generálni azt. Ha pedig a technikai csapatod Postmant használ, annak gyűjteményei OpenAPI formátumba exportálhatók.

Művelet konfigurálása a GPT szerkesztőben

A beállítás a webes GPT szerkesztődben történik: menj a Műveletek (Actions) szakaszra, kattints az Új művelet létrehozása gombra, illeszd be az OpenAPI sémádat a megfelelő mezőbe, állítsd be a hitelesítést (erről a következő leckében lesz szó), majd teszteld a műveletet az előnézeti panelről.

A sémád minősége meghatározza a hívások minőségét. Tartsd szem előtt ezt a három szokást. Először is, adj explicit neveket az operationId értékeknek: a GPT ezekre támaszkodik, hogy eldöntse, melyik műveletet hívja meg, és a getForecast sokkal jobban irányítja, mint az op_42. Ezután írj világos leírásokat minden végponthoz és paraméterhez – természetes nyelven, mintha egy kollégádnak magyaráznád az API-t. Végül csak azokat a végpontokat tedd közzé, amelyekre valóban szükséged van: ha a GPT-dnek csak két-három útvonalra van szüksége, ne tegyél közzé negyven útvonalat a teljes API-ból. Minden közzétett végpont helyet foglal el a GPT kontextusában, és növeli annak kockázatát, hogy rosszat választ.

Egy művelet négy lépésben Négy lépés: írd le az API-t egy JSON vagy YAML formátumú OpenAPI sémával; válaszd ki a hitelesítést (nincs, kulcs vagy OAuth); teszteld az előnézetben; a GPT ezután szükség esetén meghívja az API-t. API KAPCSOLÁSA Egy művelet négy lépésben 1 Séma OpenAPI, JSON vagy YAML 2 Hozzáférés Nincs, kulcs vagy OAuth 3 Teszt Az előnézetben 4 Használat A GPT meghívja az API-t Nincsenek műveletek Pro módban, és a műveletek nem kerülnek át egy bővítménybe.
Az „Actions konfigurálása GPT-kben“ című cikk alapján az OpenAI Súgóközpontjából (2026. november).

Rajtad a sor: Egy nyilvános API

Az első műveleted, vagy annak terve. A legjobb gyakorlóterep egy ingyenes, nyilvános API – időjárás, árfolyamok, hírek –, amely nem igényel összetett hitelesítést. Válassz egyet, szerezd be vagy hozd létre az OpenAPI sémáját, és add hozzá műveletként a GPT-dhez. Ne felejtsd el összekapcsolni a műveletet az utasításaiddal azzal, hogy meghatározod, mikor kell használni: „Ha a felhasználó időjárást kér, használd a getForecast műveletet.“ Ezután teszteld több különböző megfogalmazással, hogy ellenőrizd: a GPT a megfelelő időben indítja-e el a hívást.

Néhány buktató vár az első próbálkozásokra. Egy rosszul formázott séma – egyetlen hiányzó vessző a JSON-ban – mindent blokkol: mindig érvényesítsd a sémádat a Swagger Editorban, mielőtt beillesztenéd. A hiányzó leírások vakon hagyják a GPT-t: nélkülük nem tudja, mikor releváns egy művelet. Tervezd meg az API-hibák kezelését is, amelyek előbb-utóbb bekövetkeznek: határozd meg a viselkedést az utasításaidban, például: „Ha az API nem válaszol, kérd meg a felhasználót, hogy próbálja meg később“ – ellenkező esetben a GPT rögtönözni fog, néha adatokat találgatva. És ne támaszkodj kizárólag az előnézeti panelre: tesztelj valós körülmények között, valós adatokkal és valós felhasználói megfogalmazásokkal.

Ismerj meg két korlátot, mielőtt belevágsz: egy GPT vagy csatlakoztatott alkalmazásokat, vagy műveleteket használ, mindkettőt nem; a műveletek pedig nem működnek Pro módban. Ami a legfontosabb: az egyéni műveletek nem kerülnek át egy bővítménybe a migráció során: először ellenőrizd, hogy a bővítménykönyvtár kínál-e már alkalmazást a célzott szolgáltatáshoz; ha nem, újra kell építened az integrációt, például egy MCP szerverrel.

Hivatalos források: Műveletek konfigurálása GPT-kben (OpenAI Súgóközpont: hitelesítés, OpenAPI séma, tesztelés, korlátok) · Egyéni GPT megszüntetése és migrációs GYIK (a műveletek nem kerülnek át) · OpenAPI Specifikáció (séma formátum)

Főbb megállapítások

  • A műveletek összekapcsolják a GPT-det külső szolgáltatásokkal azok API-in keresztül
  • Biztosítanod kell egy OpenAPI sémát, amely leírja az elérhető végpontokat
  • A sémában lévő leírások elengedhetetlenek – a GPT ezeket használja annak eldöntésére, melyik műveletet hívja meg
  • Kezdj egy ingyenes nyilvános API-val, hogy megismerkedj a folyamattal
  • Korlátozd a közzétett végpontokat a szigorú minimumra az esetedben