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

Programmaatiline tööriistade kutsumine: mudeli orkestreeritud tööriistad

Õppetund 5 / 12 Värskendatud 5. november 2026 Kesktase
Sellel lehel
  1. Mis muutub
  2. Selle lubamine Responses API-s
  3. Mida sinu rakendus vastu saab
  4. Ülesannete tuvastamine, mis sellest võidavad
  5. Proovi ise
  6. Peamised punktid

Seisuga 5. november 2026. GPT-6 perekond pärib GPT-5.6 API võimalused, sealhulgas programmeeritava tööriistade kutsumise. Agents API lubab selle vaikimisi (tund 10). OpenAI soovitab enne selle lubamist kontrollida mudeli kirjeldust (model card).

Et mõista, mida programmeeritav tööriistade kutsumine (Programmatic Tool Calling) kaasa toob, pead esmalt vaatama klassikalise funktsioonide kutsumise kulu. Mudel taotleb tööriista käivitamist, sinu kood viib selle täide ja tulemus saadetakse mudelile tagasi, mis loeb seda ja otsustab järgmise sammu üle. Üks päringutsükkel pole suur probleem. Kümme tsüklit ühe ülesande jaoks on aga teine lugu: iga samm lisab viivet ja iga vahepealne tulemus – isegi kui see on mahukas või lõppvastuse seisukohalt ebaoluline – liigub tagasi mudeli konteksti ja seda arvestatakse tokenite kaupa. Tööriistarohkete ülesannete puhul domineerivad need tsüklid nii viite kui ka kulu osas.

Mis muutub

Programmeeritav tööriistade kutsumine jõudis kohale GPT-5.6-ga 9. juulil 2026 Responses API-s. Selle asemel, et küsida tööriistu ükshaaval, kirjutab mudel nende koordineerimiseks väikese JavaScripti programmi. See saab käivitada väljakutseid paralleelselt, kasutada tsükleid ja tingimusi ning hoida vahepealsed tulemused täitmiskeskkonnas. Konteksti tagastatakse ainult redutseeritud tulemus – see, mis on järgmise sammu jaoks oluline.

Vaatle näiteks lehekülgedega API-d (paginated API). Klassikalises funktsioonide kutsumises läbib iga tulemuste leht konteksti, et mudel saaks otsustada, kas küsida järgmist. Programmeeritava tööriistade kutsumise korral kirjutab mudel tsükli, mis iteratsioonib läbi lehekülgede, liidab kokku vajaliku ja teatab tagasi ainult summad: vähem tokeneid, väiksem viide ja vähem orkestreerimiskoodi, mida sul tuleb hallata.

OpenAI käivitab iga programmi värskes, isoleeritud V8 keskkonnas. Node.js-i pole, pakettide paigaldamine puudub, otsest võrguühendust pole, üldist failisüsteemi pole ja programmide vahel olekut ei säilitata. Programm suhtleb maailmaga ainult sinu poolt sellele avaldatud tööriistade kaudu. Responses API puhul on see käitumine ühilduv nullandmete säilitamisega (Zero Data Retention – ZDR), eeldusel et ZDR on organisatsiooni või projekti jaoks lubatud.

Selle lubamine Responses API-s

Piisab kahest seadistusest. Lisad päringusse hostitud tööriista programmatic_tool_calling ja määrad seejärel allowed_callers abil, kes võib iga sobivat tööriista kutsuda: ["direct"] (vaikimisi käitumine, kus mudel kutsub tööriista ise), ["programmatic"] (seda võib kutsuda ainult programm) või mõlemat. Dokumentatsioon soovitab samuti kirjeldada iga funktsiooni väljundit output_schema abil, et genereeritud kood saaks tugineda selle väljadele.

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,
)

Programmist kutsutavate tööriistade tüüpide hulka kuuluvad funktsioonid ja kohandatud tööriistad, MCP tööriistad, apply_patch, kohalik või hostitud shell ja koodi interpretaator. Heakskiitu nõudva MCP tööriista puhul programm peatub, kuni annad nõusoleku.

Mida sinu rakendus vastu saab

Vastus jääb standardseks Responses objektiks, milles tuleb ära tunda kolme tüüpi elemendid. Element program sisaldab genereeritud JavaScripti. Elemendid function_call vastavad selle programmi tehtud funktsioonikutsungitele; nende väli caller tuvastab kutsuva programmi. Lõpuks edastab element program_output programmi lõpptulemuse olekuga completed või incomplete.

Sinu rakendus ei käivita kunagi JavaScripti; seda teeb OpenAI. Sa viid täide ainult oma funktsioonid ja tagastad iga tulemuse function_call_output kaudu, kopeerides välja caller muutmatult, et õige programm saaks jätkata. Kordad seda tsüklit seni, kuni vastuses pole enam täidetavaid kutseid.

Kes mida täidab Kolm sammu: mudel kirjutab JavaScripti programmi, mille OpenAI käivitab isoleeritud keskkonnas; sinu rakendus viib täide selle programmi funktsioonikutsed ja tagastab tulemused välja caller muutmatult; programm edastab redutseeritud tulemuse program_outputis. PROGRAMMEERITAV TÖÖRIISTADE KUTSUMINE Kes mida täidab 1 Programm Kirjutatud mudeli poolt 2 Sinu funktsioonid Sinu poolt täidetud 3 Tulemus Redutseeritud program_output JavaScript jookseb OpenAI-s, mitte kunagi sinu poolt. Tundlikud kirjutamised jäävad otsesteks kutseteks.
Põhineb OpenAI API dokumentatsiooni programmeeritava tööriistade kutsumise juhendil (november 2026).

Ülesannete tuvastamine, mis sellest võidavad

Mitte iga tööriistade integratsioon ei võida migreerimisest. OpenAI juhend pakub selget reeglit: programmeeritav tööriistade kutsumine sobib sammude jaoks, kus voog on ennustatav ja kood saab tagastada väiksema, struktureeritud tulemuse. See on mõeldud mitme tulemuse filtreerimiseks, liitmiseks, sorteerimiseks, dubleerimiste eemaldamiseks, agregeerimiseks või valideerimiseks või sõltuvate kutsete aheldamiseks, kus andmevoog on ennustatav. Otsene kutsumine jääb eelistatuks üksiku otsingu või toimingu korral, adaptiivsete otsingute puhul, kus iga tulemus peab suunama järgmist otsust, ning lõpliku tsiteerimise valideerimisel. Samuti jääb see vaikimisi valikuks kirjutamiste ja heakskiitu nõudvate toimingute jaoks, et säilitada selge autoriseerimispiir.

Otsustuskriteerium taandub ühele küsimusele: kus sinu agent aega veedab? Kui vastus on „ootab tööriistade päringutsükleid“, on programmeeritav tööriistade kutsumine esimene hindamisvaldkond. Kui sinu tööriistakutsed on haruldased ja nende tulemused lühikesed, säilita oma praegune arhitektuur ja suuna jõupingutused mujale.

Proovi ise

Tuvasta kandidaat. Võta oma agendis ette voog, mis kutsub mitut tööriista. Märgi iga sammu puhul üles kutsete arv, vahepealsete tulemuste suurus ja see, kas tegemist on lugemise või kirjutamisega. Klassifitseeri iga samm ülaltoodud reegli alusel. Kõige paljutõotavama sammu jaoks kirjuta prompt, mis määrab lubatud tööriistad, oodatava tulemuse vormingu, lõpetamistingimuse, maksimaalse katsete arvu ja selle, mis jääb otseseks kutseks.

Ametlikud allikad: Programmeeritav tööriistade kutsumine · GPT-6 kasutamine (OpenAI API dokumentatsioon) · GPT-5.6 teadaanne (OpenAI, 9. juuli 2026)

Peamised punktid

  • Mudel kirjutab ja käivitab JavaScripti, et koordineerida oma tööriistu OpenAI hallatavas isoleeritud keskkonnas
  • Luba see tööriista programmatic_tool_calling ja iga tööriista välja allowed_callers abil
  • Sinu rakendus viib täide ainult oma funktsioonid ja tagastab välja caller muutmatult
  • Eelista seda filtreerimisel, agregeerimisel või ennustatavate kutsete aheldamisel; otsene kutsumine jääb reegliks kirjutamiste ja heakskiitude puhul