GPT-d összekapcsolása külső API-kkal
Ezen az oldalon
Á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.
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