Yhdistä GPT:si ulkoisiin rajapintoihin
Tällä sivulla
Tilanne 5.11.2026: GPT:t ovat viimeisillä viikoillaan. OpenAI poistaa mukautetut GPT:t käytöstä 11.12.2026 (tietyissä Enterprise-työtiloissa, joille on myönnetty poikkeus, päivämäärä on 11.2.2027). Henkilökohtaisilla, Free-, Go-, Plus- ja Pro-tileillä ei voi enää luoda eikä julkaista uusia GPT:itä. Business-, Enterprise- ja Edu-työtiloissa luominen riippuu asetuksista, ja se loppui 26.10.2026 niissä Enterprise-työtiloissa, joita asia koskee. Olemassa olevat GPT:t pysyvät käytettävissä ja muokattavissa, jos tilauksesi sen sallii, aina poistopäivään saakka; keskustelusi niiden kanssa pysyvät saatavilla myös tämän jälkeen. Siirtymä (Migrate to plugin, kohdassa My GPTs) muuntaa ohjeet taidoksi, tietopohjan viitetiedostoiksi ja yhdistetyt sovellukset sovelluksiksi; mukautettuja toimintoja ei siirretä. Tämä oppitunti selittää, miten GPT:t toimivat, jotta osaat ylläpitää niitä, siirtää ne ja soveltaa niiden periaatteita lisäosaan (oppitunnit 15–17).
Siirtyminen erillisestä GPT:stä eteenpäin
Tähän asti GPT:si on toiminut eristyneenä: sen ohjeet määrittävät sen käyttäytymisen, ja tietopohja tarjoaa dokumenttisi. Se on tehokasta, mutta järjestelmä pysyy irrallaan reaaliaikaisesta maailmasta. Se ei voi tarkistaa CRM-järjestelmääsi reaaliajassa, luoda kalenteritapahtumaa eikä kysyä tietokannaltasi – se tietää vain sen, mitä olet ladannut, ja tieto on jäädytetty lataushetkelle. Toiminnot poistavat tämän rajoituksen: niiden avulla GPT:si voi kutsua ulkoisia rajapintoja lukeakseen ja kirjoittaakseen dataa työkaluihisi keskustelun aikana.
Mikä on toiminto?
Toiminto on yhteys GPT:si ja ulkoisen palvelun välillä sen rajapinnan kautta. Kulku on aina sama: käyttäjä esittää kysymyksen tai antaa ohjeen, GPT tunnistaa tarvitsevansa ulkoista dataa vastatakseen, se kutsuu palvelun rajapintaa, saa vastauksen ja integroi sen lopulliseen vastaukseensa. Ajattele myyntiin keskittyvää GPT:tä, joka on yhdistetty CRM-järjestelmään: kun käyttäjä kysyy “Mikä on Dupont-tiedoston tila?”, GPT kysyy CRM-rajapinnalta, hakee asiakastietueen ja vastaa tämän päivän tiedoilla – ei muistilla tiedostosta, joka ladattiin kolme kuukautta sitten. Kaikki tämä tapahtuu käyttäjälle läpinäkyvästi; hän kokee vain keskustelevansa hyvin perillä olevan avustajan kanssa.
OpenAPI-määrittely
Jotta GPT voi kutsua rajapintaa, sinun on kuvailtava se. Tässä tulee avuksi OpenAPI-määrittely (aiemmin Swagger), joka on JSON- tai YAML-tiedosto ja toimii rajapinnan käyttöohjeena. Se kuvaa päätepisteet (endpoints) – URL-osoitteet, joita GPT:si voi kutsua – niihin liittyvät metodit (GET lukemiseen, POST luomiseen, PUT päivittämiseen, DELETE poistamiseen), kunkin päätepisteen odottamat parametrit ja palautettavien vastausten muodon. Tämän dokumentin perusteella GPT päättää itse keskustelun aikana, mitä päätepistettä kutsua ja millä parametreilla.
Tässä on minimaalinen määrittely kuvitteelliselle säärajapinnalle:
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
Hyviä uutisia: sinun ei lähes koskaan tarvitse kirjoittaa tätä tiedostoa alusta alkaen. Monet palvelut julkaisevat OpenAPI-määrittelynsä suoraan rajapintadokumentaatioissaan. Jos näin ei ole, työkalut kuten Swagger Editor – tai itse ChatGPT, jos kuvailet sille rajapinnan – voivat generoida sen. Jos tekninen tiimisi käyttää Postmania, sen kokoelmat voi viedä OpenAPI-muodossa.
Toiminnon määrittäminen GPT-muokkaimessa
Asennus tapahtuu GPT-muokkaimessa verkossa: siirry kohtaan Actions, napsauta Create new action, liitä OpenAPI-määrittelysi annettuun kenttään, määritä todennus (käsitellään seuraavassa oppitunnissa) ja testaa toiminto esikatselupaneelista.
Määrittelysi laatu ratkaisee kutsujen laadun. Pidä mielessäsi kolme tapaa. Ensinnäkin anna operationId-arvoille selkeät nimet: GPT luottaa niihin päättäessään, mitä toimintoa kutsua, ja getForecast ohjaa sitä huomattavasti paremmin kuin op_42. Toiseksi kirjoita jokaiselle päätepisteelle ja parametrille selkeät kuvaukset luonnollisella kielellä, ikään kuin selittäisit rajapintaa kollegalle. Kolmanneksi paljasta vain ne päätepisteet, joita todella tarvitset: jos GPT:si tarvitsee vain kaksi tai kolme reittiä, älä paljasta koko rajapinnan kaikkia neljääkymmentä reittiä. Jokainen paljastettu päätepiste vie tilaa GPT:n kontekstista ja kasvattaa riskiä, että se valitsee väärän.
Vuorosi: julkinen rajapinta
Ensimmäinen toimintosi tai sen suunnitelma. Paras harjoittelualusta on ilmainen, julkinen rajapinta – sää, valuuttakurssit, uutiset – joka ei vaadi monimutkaista todennusta. Valitse yksi, hae tai luo sen OpenAPI-määrittely ja lisää se GPT:si toimintona. Muista linkittää toiminto ohjeisiisi määrittämällä, milloin sitä käytetään: “Kun käyttäjä kysyy säätä, käytä getForecast-toimintoa.” Testaa sitten useilla eri formuloinneilla varmistaaksesi, että GPT laukaisee kutsun oikeaan aikaan.
Ensimmäisiä yrityksiä vaanii muutama sudenkuoppa. Väärin muotoiltu määrittely – yksi puuttuva pilkku JSONissa – estää kaiken: validoi määrittelysi aina Swagger Editorissa ennen liittämistä. Puuttuvat kuvaukset jättävät GPT:n sokeaksi: ilman niitä se ei tiedä, milloin toiminto on relevantti. Suunnittele myös rajapintavirheet, joita ennemmin tai myöhemmin tapahtuu: määritä käyttäytyminen ohjeissasi, esimerkiksi “Jos rajapinta ei vastaa, kehota käyttäjää yrittämään myöhemmin” – muuten GPT improvisoi, joskus keksimällä dataa. Älä luota pelkkään esikatselupaneeliin: testaa todellisissa olosuhteissa, oikealla datalla ja oikeilla käyttäjäformuloinneilla.
Tunne kaksi rajoitusta ennen aloitusta: GPT käyttää joko yhdistettyjä sovelluksia tai toimintoja, ei molempia, eikä toimintoja voi käyttää Pro-tilassa. Tärkeintä on, että mukautetut toiminnot eivät siirry lisäosaan migraation yhteydessä: tarkista ensin, tarjoaako lisäosahakemisto jo sovelluksen kohdepalvelullesi; jos ei, sinun on rakennettava integraatio uudelleen, esimerkiksi MCP-palvelimella.
Viralliset lähteet: Configuring actions in GPTs (OpenAI Help Center: todennus, OpenAPI-määrittely, testaus, rajoitukset) · Custom GPT retirement and migration FAQ (toimintoja ei siirretä) · OpenAPI Specification (määrittelyn muoto)
Keskeiset asiat
- Toiminnot yhdistävät GPT:si ulkoisiin palveluihin niiden rajapintojen kautta
- Sinun on toimitettava OpenAPI-määrittely, joka kuvaa käytettävissä olevat päätepisteet
- Määrittelyn kuvaukset ovat välttämättömiä – GPT käyttää niitä päättääkseen, mitä toimintoa kutsua
- Aloita ilmaisella julkisella rajapinnalla päästäksesi kärryille prosessista
- Rajoita paljastetut päätepisteet käyttötapauksesi kannalta ehdottomaan minimiin