Poveži svoj GPT z zunanjimi API-ji
Na tej strani
Stanje na dan 5. novembra 2026: GPT-ji so v svojih zadnjih tednih. OpenAI ukinja prilagojene GPT-je 11. decembra 2026 (11. februarja 2027 za določene delovne prostore Enterprise z izvzetjem). Osebni računi Free, Go, Plus in Pro ne morejo več ustvarjati ali objavljati novih GPT-jev; v delovnih prostorih Business, Enterprise in Edu je ustvarjanje odvisno od nastavk, v prizadetih delovnih prostorih Enterprise pa je prenehalo 26. oktobra 2026. Obstoječi GPT-ji ostanejo uporabni in uredljivi, če to vaš načrt dovoljuje, vse do ukinitve; vaši pogovori z njimi bodo dostopni tudi po tem datumu. Selitev (Migrate to plugin, v My GPTs) pretvori navodila v veščino, zbirko znanja v referenčne datoteke in povezane aplikacije v aplikacije; dejanja po meri se ne prenesejo. Ta lekcija razlaga delovanje GPT-jev, da jih boste lažje vzdrževali, selili in njihova načela prilagodili vtičniku (lekcije 15–17).
Onkraj samostojnega GPT-ja
Doslej je vaš GPT deloval v izolaciji: njegova navodila določajo njegovo obnašanje, njegovo znanje pa zagotavljajo vaši dokumenti. To je zmogljivo, a ostaja odrezano od živega sveta. Ne more preverjati vašega CRM-ja v realnem času, ustvarjati dogodkov v koledarju ali poizvedovati po vaši bazi podatkov – ve le tisto, kar ste naložili, zamrznjeno v času nalaganja. Dejanja odstranijo to omejitev: omogočajo vašemu GPT-ju, da med pogovorom kliče zunanje API-je za branje in zapisovanje podatkov v vaših orodjih.
Kaj je dejanje?
Dejanje je povezava med vašim GPT-jem in zunanjo storitvijo prek njenega API-ja. Potek je vedno enak: uporabnik zastavi vprašanje ali da navodilo, GPT prepozna, da potrebuje zunanje podatke za odgovor, pokliče API storitve, prejme odgovor in ga vključi v svoj končni odgovor. Pomislite na prodajni GPT, povezan s CRM-jem: ko uporabnik vpraša: „Kakšno je stanje spisa Dupont?”, GPT poizvede v API-ju CRM-ja, pridobi zapis o stranki in odgovori s podatki za danes – ne s spominom na datoteko, naloženo pred tremi meseci. Vse to se za uporabnika zgodi pregledno; ima le občutek, da govori z dobro obveščenim asistentom.
Shema OpenAPI
Da bi GPT lahko poklical API, ga morate opisati. To je vloga sheme OpenAPI (nekdanji Swagger), datoteke JSON ali YAML, ki služi kot navodila za uporabo API-ja. Opisuje končne točke (endpoints) – URL-je, ki jih lahko GPT kliče –, povezane metode (GET za branje, POST za ustvarjanje, PUT za posodobitev, DELETE za brisanje), parametre, ki jih pričakuje vsaka končna točka, in format odgovorov, ki jih vrne. Na podlagi tega dokumenta se GPT med pogovorom sam odloči, katero končno točko poklicati in s katerimi parametri.
Tako izgleda minimalna shema za izmišljen vremenski API:
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
Dobra novica: te datoteke skoraj nikoli ne boste morali pisati od začetka. Številne storitve objavljajo svojo shemo OpenAPI neposredno v dokumentaciji svojega API-ja. Če je ni, jo lahko ustvarite z orodji, kot je Swagger Editor, ali pa s pomočjo samega ChatGPT, če mu API opišete. In če vaša tehnična ekipa dela s Postmanom, se njegove zbirke izvozijo v format OpenAPI.
Konfiguracija dejanja v urejevalniku GPT
Namestitev poteka v spletnem urejevalniku GPT: pojdite v razdelek Actions, kliknite Create new action, prilepite svojo shemo OpenAPI v predvideno polje, konfigurirajte avtentikacijo (obravnavano v naslednji lekciji) in nato preizkusite dejanje iz plošče za predogled.
Kakovost vaše sheme določa kakovost klicev. Upoštevajte tri navade. Prvič, vrednostim operationId dajte eksplicitna imena: GPT se zanaša nanje pri odločitvi, katero dejanje poklicati, in getForecast ga vodi veliko bolje kot op_42. Nato napišite jasne opise za vsako končno točko in parameter – v naravnem jeziku, kot da bi API razlagali kolegu. Nazadnje, izpostavite le končne točke, ki jih dejansko potrebujete: če vaš GPT potrebuje le dve ali tri poti, ne izpostavljajte vseh štiridesetih poti celotnega API-ja. Vsaka izpostavljena končna točka zavzame prostor v kontekstu GPT-ja in poveča tveganje, da izbere napačno.
Vaša vaja: Javni API
Vaše prvo dejanje ali njegov načrt. Najboljše polje za vadbo je brezplačen, javni API – vremenski, menjalni tečaji, novice –, ki ne zahteva zapletene avtentikacije. Izberite enega, pridobite ali ustvarite njegovo shemo OpenAPI in jo dodajte kot dejanje v svoj GPT. Ne pozabite povezati dejanja s svojimi navodili z določitvijo, kdaj ga uporabiti: „Ko uporabnik vpraša za vreme, uporabi dejanje getForecast.” Nato preizkusite z več različnimi formulacijami, da preverite, ali GPT sproži klic ob pravem času.
Prve poskuse čakajo nekaj pasteh. Napačno oblikovana shema – ena sama manjkajoča vejica v JSON-u – blokira vse: shemo vedno potrdite v Swagger Editorju, preden jo prilepite. Manjkajoči opisi pustijo GPT slepega: brez njih ne ve, kdaj je dejanje relevantno. Načrtujte tudi napake API-ja, ki se bodo prej ali slej zgodile: v navodilih določite obnašanje, na primer: „Če API ne odgovori, uporabniku reci, naj poskusi kasneje” – sicer bo GPT improviziral, včasih z izmišljanjem podatkov. In ne zanašajte se zgolj na ploščo za predogled: preizkusite v realnih pogojih, z realnimi podatki in realnimi formulacijami uporabnikov.
Pred začetkom poznajte dve omejitvi: GPT uporablja povezane aplikacije ali dejanja, ne obojega hkrati, dejanja pa ne delujejo v načinu Pro. Najpomembneje: dejanja po meri se med selitvijo ne prenesejo v vtičnik: najprej preverite, ali imenik vtičnikov že ponuja aplikacijo za vašo ciljno storitev; če ne, boste morali integracijo obnoviti, na primer s strežnikom MCP.
Uradni viri: Configuring actions in GPTs (Center za pomoč OpenAI: avtentikacija, shema OpenAPI, testiranje, omejitve) · Custom GPT retirement and migration FAQ (dejanja se ne prenesejo) · OpenAPI Specification (format sheme)
Ključne ugotovitve
- Dejanja povežejo vaš GPT z zunanjimi storitvami prek njihovih API-jev
- Zagotoviti morate shemo OpenAPI, ki opisuje razpoložljive končne točke
- Opisi v shemi so bistveni – GPT jih uporablja za odločitev, katero dejanje poklicati
- Začnite z brezplačnim javnim API-jem, da se seznanite s postopkom
- Omejite izpostavljene končne točke na strogi minimum za vaš primer uporabe