Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Ühenda oma GPT väliste API-dega

Õppetund 9 / 17 Värskendatud 5. november 2026 Kesktase
Sellel lehel
  1. Liikumine eraldiseisvast GPT-st kaugemale
  2. Mis on tegevus?
  3. OpenAPI skeem
  4. Tegevuse seadistamine GPT redaktoris
  5. Sinu kord: avalik API
  6. Peamised punktid

Seisuga 5. november 2026: GPT-de eluiga lõpeb. OpenAI lõpetab kohandatud GPT-de toe 11. detsembril 2026 (teatud erandiga ettevõtete tööruumides 11. veebruaril 2027). Isiklikud, tasuta, Go, Plus ja Pro kontod ei saa enam uusi GPT-sid luua ega avaldada; äri-, ettevõtte- ja haridusasutuste tööruumides sõltub loomine seadistustest ning mõjutatud ettevõtete tööruumides peatus see 26. oktoobril 2026. Olemasolevaid GPT-sid saab kasutada ja muuta seni, kuni sinu plaan seda lubab; vestlused nendega jäävad ka pärast seda kättesaadavaks. Rändeprotsess (Migrate to plugin, menüüs My GPTs) teisendab juhised oskuseks, teadmistebaasi viitefailideks ja ühendatud rakendused rakendusteks; kohandatud tegevusi ei viida üle. See tund selgitab, kuidas GPT-d toimivad, et aidata sul neid hallata, migreerida ja nende põhimõtteid pistikprogrammis rakendada (tunnid 15–17).

Liikumine eraldiseisvast GPT-st kaugemale

Seni on sinu GPT tegutsenud isoleeritult: selle juhised määravad käitumise ja teadmistebaas pakub dokumente. See on võimas, kuid jääb reaalmaailmast lõigatuks. See ei saa reaalajas kontrollida sinu CRM-i, luua kalendrisündmust ega pärida andmebaasi – see teab ainult seda, mida oled üles laadinud, ja seda seisuga, mil fail üles laaditi. Tegevused (Actions) kõrvaldavad selle piirangu: need võimaldavad sinu GPT-l vestluse käigus kutsuda väliseid API-sid, et lugeda ja kirjutada andmeid sinu tööriistadesse.

Mis on tegevus?

Tegevus on seos sinu GPT ja välise teenuse vahel läbi selle API. Voog on alati sama: kasutaja esitab küsimuse või annab korralduse, GPT tuvastab, et vastamiseks on vaja väliseid andmeid, kutsub teenuse API, saab vastuse ja integreerib selle oma lõplikku vastusesse. Võta näiteks müügi-GPT, mis on ühendatud CRM-iga: kui kasutaja küsib „Mis on Dupont’i faili staatus?“, pärib GPT CRM-i API-st, toob kliendi kirje ja vastab tänaste andmetega – mitte mälestusega kolm kuud tagasi üles laaditud failist. Kõik see toimub kasutaja jaoks läbipaistvalt, kes tunneb lihtsalt, et vestleb hästi informeeritud assistendiga.

OpenAPI skeem

Selleks, et GPT saaks API-d kutsuda, pead sa seda kirjeldama. Selleks ongi mõeldud OpenAPI skeem (varem Swagger) – JSON- või YAML-fail, mis toimib API kasutusjuhendina. See kirjeldab lõpp-punkte (endpoints) – URL-e, mida sinu GPT saab kutsuda –, nendega seotud meetodeid (GET lugemiseks, POST loomiseks, PUT uuendamiseks, DELETE kustutamiseks), iga lõpp-punkti oodatavaid parameetreid ja tagastatavate vastuste vormingut. Selle dokumendi põhjal otsustab GPT vestluse käigus ise, millist lõpp-punkti ja milliste parameetritega kutsuda.

Siin on näide minimaalsest skeemist väljamõeldud ilmateenuse API jaoks:

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

Hea uudis: seda faili pead sa peaaegu kunagi nullist kirjutama. Paljud teenused avaldavad oma OpenAPI skeemi otse oma API dokumentatsioonis. Kui seda pole, saavad tööriistad nagu Swagger Editor – või isegi ChatGPT, kui sa talle API-d kirjeldad – selle genereerida. Ja kui sinu tehniline meeskond kasutab Postmani, saab selle kogumikud eksportida OpenAPI vormingusse.

Tegevuse seadistamine GPT redaktoris

Seadistamine toimub veebipõhises GPT redaktoris: mine jaotisse Actions, klõpsa Create new action, kleebi oma OpenAPI skeem ettenähtud väljale, seadista autentimine (seda käsitleme järgmises tunnis) ja testige tegevust eelvaate paneelist.

Sinu skeemi kvaliteet määrab kutsete kvaliteedi. Pea meeles kolm harjumust. Esiteks, anna operationId väärtustele selged nimed: GPT tugineb neile, otsustamaks, millist tegevust kutsuda, ja getForecast juhendab seda palju paremini kui op_42. Teiseks, kirjuta iga lõpp-punkti ja parameetri jaoks selged kirjeldused – loomulikus keeles, justkui selgitaksid API-d kolleegile. Lõpuks, avalda ainult need lõpp-punktid, mida tegelikult vajad: kui sinu GPT vajab vaid kahte või kolme teed, ära avalda kogu API neljakümmet teed. Iga avaldatud lõpp-punkt hõivab ruumi GPT kontekstis ja suurendab riski, et see valib vale.

Tegevus neljas sammus Neli sammu: kirjelda API-d OpenAPI skeemiga JSON-is või YAML-is; vali autentimine (puudub, võti või OAuth); testi eelvaates; seejärel kutsub GPT API-d, kui see on kasulik. ÜHENDA API Tegevus neljas sammus 1 Skeem OpenAPI, JSON või YAML 2 Ligipääs Puudub, võti või OAuth 3 Testi Eelvaates eelvaade 4 Kasutamine GPT kutsub API-d Pro režiimis tegevused puuduvad ja tegevusi ei viida pistikprogrammi üle.
Põhineb artiklil „Configuring actions in GPTs“ OpenAI abikeskusest (november 2026).

Sinu kord: avalik API

Sinu esimene tegevus või selle plaan. Parim harjutusväli on tasuta, avalik API – ilm, valuutakursid, uudised –, mis ei nõua keerukat autentimist. Vali üks, hangi või loo selle OpenAPI skeem ja lisa see oma GPT-sse tegevusena. Ära unusta seostada tegevust oma juhistega, täpsustades, millal seda kasutada: „Kui kasutaja küsib ilma, kasuta tegevust getForecast.“ Seejärel testi erinevate sõnastustega, et veenduda, kas GPT käivitab kutse õigel ajal.

Esimestel katsetel ootavad sind mõned lõksud. Vigane skeem – üksainus puuduv koma JSON-is – blokeerib kõik: valideeri oma skeem alati Swagger Editoris enne kleepimist. Kirjelduste puudumine jätab GPT pimedaks: ilma nendeta ei tea see, millal tegevus on asjakohane. Planeeri ette ka API vead, mis varem või hiljem juhtuvad: täpsusta käitumine oma juhistes, näiteks „Kui API ei vasta, palu kasutajal hiljem uuesti proovida“ – vastasel juhul improviseerib GPT, mõnikord andmeid välja mõeldes. Ja ära tugine ainult eelvaate paneelile: testi reaalsetes tingimustes, reaalsete andmete ja tegelike kasutajate sõnastustega.

Enne alustamist tea kahte piirangut: GPT kasutab kas ühendatud rakendusi või tegevusi, mitte mõlemat, ja tegevused ei tööta Pro režiimis. Kõige tähtsam on see, et kohandatud tegevusi ei viida pistikprogrammi rändamise käigus üle: kontrolli esmalt, kas pistikprogrammide kataloog pakub juba rakendust sinu sihtteenusele; kui mitte, pead integratsiooni uuesti looma, näiteks MCP serveriga.

Ametlikud allikad: Configuring actions in GPTs (OpenAI abikeskus: autentimine, OpenAPI skeem, testimine, piirangud) · Custom GPT retirement and migration FAQ (tegevusi ei viida üle) · OpenAPI Specification (skeemi vorming)

Peamised punktid

  • Tegevused ühendavad sinu GPT väliste teenustega läbi nende API-de
  • Pead esitama OpenAPI skeemi, mis kirjeldab saadaolevaid lõpp-punkte
  • Skeemis olevad kirjeldused on hädavajalikud – GPT kasutab neid otsustamaks, millist tegevust kutsuda
  • Alusta tasuta avaliku API-ga, et protsessiga harjuda
  • Piira avaldatud lõpp-punktid oma kasutusjuhu jaoks absoluutse miinimumini