Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ohjelmallinen työkalukutsu: mallin orkestroimat työkalut

Oppitunti 5 / 12 Päivitetty 5. marraskuuta 2026 Keskitasoinen
Tällä sivulla
  1. Mikä muuttuu
  2. Käyttöönotto Responses API:ssa
  3. Mitä sovelluksesi vastaanottaa
  4. Hyötyvien tehtävien tunnistaminen
  5. Kokeile itse
  6. Keskeiset asiat

Tilanne 5. marraskuuta 2026. GPT-6-perhe perii GPT-5.6:n API-ominaisuudet, mukaan lukien ohjelmallisen työkalukutsun. Agents API ottaa tämän käyttöön oletuksena (oppitunti 10). OpenAI suosittelee mallikortin tarkistamista ennen ominaisuuden aktivoimista.

Jotta ymmärtäisit, mitä ohjelmallinen työkalukutsu tuo pöytään, sinun on ensin tarkasteltava klassisen funktiokutsun kustannuksia. Malli pyytää työkalun suorittamista, koodisi ajaa sen, ja tulos palautetaan mallille, joka lukee sen ja päättää seuraavasta askeleesta. Yksi edestakainen viesti ei ole ongelma. Kymmenen edestakaista viestiä yhden tehtävän aikana on kuitenkin eri asia: jokainen askel lisää viivettä, ja jokainen välitulos – vaikka se olisi suurikokoinen tai merkityksetön lopullisen vastauksen kannalta – kulkee mallin kontekstin läpi ja laskutetaan tokenneina. Työkaluvaltaisissa tehtävissä nämä edestakaiset viestit dominoivat sekä viivettä että kustannuksia.

Mikä muuttuu

Ohjelmallinen työkalukutsu saapui GPT-5.6:n mukana 9. heinäkuuta 2026 Responses API:ssa. Työkalujen pyytämisen sijaan yksi kerrallaan malli kirjoittaa pienemmän JavaScript-ohjelman niiden koordinoimiseksi. Se voi käynnistää kutsuja rinnakkain, käyttää silmukoita ja ehtolauseita sekä pitää välitulokset suoritusympäristön sisällä. Vain pelkistetty tulos – se, joka on merkityksellinen seuraavaa askelta varten – palautetaan kontekstiin.

Tarkastele sivutettua APIa. Klassisessa funktiokutsussa jokainen tulosivu kulkee kontekstin läpi, jotta malli voi päättää, pyytääkö se seuraavaa. Ohjelmallisessa työkalukutsussa malli kirjoittaa silmukan, joka iteroi sivujen yli, laskee yhteen sen, mikä pitää laskea, ja raportoi takaisin vain summat: vähemmän tokeneita, vähemmän viivettä ja vähemmän orkestrointikoodia sinulle ylläpidettäväksi.

OpenAI suorittaa jokaisen ohjelman uudessa, eristetyssä V8-ympäristössä. Siellä ei ole Node.js:ää, ei pakettien asennusta, ei suoraa verkkoyhteyttä, ei yleistä tiedostojärjestelmää eikä tilaa, joka säilyisi ohjelmien välillä. Ohjelma vuorovaikuttaa maailman kanssa vain sinun sille paljastamiesi työkalujen kautta. Responses API:ssa tämä toiminta on yhteensopiva Zero Data Retentionin (ZDR) kanssa, edellyttäen että ZDR on otettu käyttöön organisaatiolle tai projektille.

Käyttöönotto Responses API:ssa

Kaksi asetusta riittää. Lisäät pyyntöön isännöidyn työkalun programmatic_tool_calling ja määrität sitten allowed_callers-kentällä, kuka voi kutsua kutakin kelvollista työkalua: ["direct"] (oletustoiminta, jossa malli kutsuu työkalua itse), ["programmatic"] (vain ohjelma voi kutsua sitä) tai molemmat. Dokumentaatio suosittelee myös kunkin funktion tulosteen kuvaamista output_schema-kentällä, jotta generoitu koodi voi luottaa sen kenttiin.

from openai import OpenAI

client = OpenAI()

tools = [
    {
        "type": "function",
        "name": "read_stock",
        "description": "Returns an object with sku (text) and units (number).",
        "parameters": {
            "type": "object",
            "properties": {"sku": {"type": "string"}},
            "required": ["sku"],
            "additionalProperties": False,
        },
        "output_schema": {
            "type": "object",
            "properties": {"sku": {"type": "string"}, "units": {"type": "number"}},
            "required": ["sku", "units"],
            "additionalProperties": False,
        },
        "allowed_callers": ["programmatic"],
    },
    {"type": "programmatic_tool_calling"},
]

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Check stock for SKUs A12, B07, and C33 and flag those under 10 units.",
    tools=tools,
)

Ohjelmasta kutsuttavia työkalutyyppejä ovat funktiot ja mukautetut työkalut, MCP-työkalut, apply_patch, paikallinen tai isännöity shell sekä koodintulkki. Jos MCP-työkalu vaatii hyväksynnän, ohjelma pysähtyy, kunnes myönnyt suostumuksen.

Mitä sovelluksesi vastaanottaa

Vastaus on edelleen vakio Responses-objekti, jossa on kolme tunnistettavaa elementtityyppiä. program-elementti sisältää generoidun JavaScript-koodin. function_call-elementit vastaavat kyseisen ohjelman tekemiä funktiokutsujasi; niiden caller-kenttä tunnistaa kutsuvan ohjelman. Lopuksi program_output-elementti toimittaa ohjelman lopullisen tuloksen, jonka tila on completed tai incomplete.

Sovelluksesi ei koskaan suorita JavaScriptiä; OpenAI hoitaa sen. Sinä suoritat vain omat funktiosi ja palautat sitten jokaisen tuloksen function_call_output-objektissa kopioimalla caller-kentän muuttumattomana, jotta oikea ohjelma voi jatkaa toimintaansa. Toistat tätä silmukkaa, kunnes vastauksessa ei ole enää suoritettavia kutsuja.

Kuka suorittaa mitä Kolme vaihetta: malli kirjoittaa JavaScript-ohjelman, jonka OpenAI suorittaa eristetyssä ympäristössä; sovelluksesi suorittaa ohjelman funktiokutsut ja palauttaa tulokset caller-kenttä koskemattomana; ohjelma toimittaa pelkistetyn tuloksen muodossa program_output. OHJELMALLINEN TYÖKALUKUTSU Kuka suorittaa mitä 1 Ohjelma Mallin kirjoittama 2 Funktiosi Sinun suorittamasi 3 Tulos Pelkistetty program_output JavaScript suoritetaan OpenAI:ssa, ei koskaan sinun puolellasi. Arkaluonteiset kirjoitukset pysyvät suorina kutsuina.
Perustuu OpenAI API -dokumentaation ohjelmallisen työkalukutsun oppaaseen (marraskuu 2026).

Hyötyvien tehtävien tunnistaminen

Kaikki työkaluintegraatiot eivät hyödy siirtymisestä. OpenAI:n opas tarjoaa selkeän säännön: ohjelmallinen työkalukutsu sopii vaiheisiin, joissa kulku on ennustettavaa ja koodi voi palauttaa pienemmän, jäsennellyn tuloksen. Se on suunniteltu suodattamaan, yhdistämään, lajittelemaan, poistamaan päällekkäisyyksiä, aggregoimaan tai validoimaan useita tuloksia tai ketjuttamaan riippuvaisia kutsuja, joissa datavirta on ennustettavaa. Suora kutsu on edelleen suositeltavaa yksittäiseen hakuun tai toimintoon, adaptiivisiin hakuihin, joissa jokaisen tuloksen on ohjattava seuraavaa päätöstä, sekä lopulliseen lähdevalidointiin. Se on myös oletusvalinta kirjoituksille ja toimille, jotka vaativat hyväksyntää selkeän valtuutusrajan ylläpitämiseksi.

Päätöskriteeri tiivistyy yhteen kysymykseen: missä agenttisi viettää aikansa? Jos vastaus on “odottaessa työkalujen edestakaisia viestejä”, ohjelmallinen työkalukutsu on ensimmäinen arvioitava alue. Jos työkalukutsusi ovat harvinaisia ja niiden tuloksia lyhyitä, pidä nykyinen arkkitehtuurisi ja keskity ponnistuksesi muualle.

Kokeile itse

Tunnista ehdokas. Ota agenttisi kulku, joka kutsuu useita työkaluja. Merkitse jokaiselle vaiheelle kutsujen määrä, välitulosten koko ja se, onko kyseessä luku- vai kirjoitustoiminto. Luokittele jokainen vaihe yllä olevan säännön avulla. Lupauksellisimmalle vaiheelle kirjoita kehote, joka määrittää sallitut työkalut, odotetun tulosmuodon, lopetusehdon, suurimman uudelleenyritysten määrän ja sen, mikä pysyy suorana kutsuna.

Viralliset lähteet: Programmatic Tool Calling · Using GPT-6 (OpenAI API -dokumentaatio) · GPT-5.6 Announcement (OpenAI, 9. heinäkuuta 2026)

Keskeiset asiat

  • Malli kirjoittaa ja suorittaa JavaScriptiä koordinoidakseen työkalujaan OpenAI:n hallinnoimassa eristetyssä ympäristössä
  • Ota se käyttöön programmatic_tool_calling-työkalulla ja allowed_callers-kentällä jokaisessa työkalussa
  • Sovelluksesi suorittaa vain funktionsa ja palauttaa caller-kentän koskemattomana
  • Suosi sitä suodatukseen, aggregointiin tai ennustettavien kutsujen ketjuttamiseen; suora kutsu pysyy sääntönä kirjoituksille ja hyväksynnän vaativille toiminnoille