Programski klic orodij: orodja, usklajena z modelom
Na tej strani
Stanje na dan 5. novembra 2026. Družina GPT-6 podeduje zmožnosti API-ja različice GPT-5.6, vključno s programskim klicem orodij. API za agente to omogoča privzeto (lekcija 10). OpenAI priporoča preverjanje kartice modela pred vklopom te funkcije.
Da bi razumel, kaj prinaša programski klic orodij, moraš najprej pogledati stroške klasičnega klicanja funkcij. Model zahteva izvedbo orodja, tvoja koda ga izvrši, rezultat pa se vrne modelu, ki ga prebere in odloči o naslednjem koraku. En krožni promet ni velik problem. Deset krožnih prometov za eno samo nalogo pa je druga zgodba: vsak korak doda zakasnitev, vsak vmesni rezultat – tudi če je obsežen ali nepomemben za končni odgovor – potuje nazaj skozi kontekst modela in se zaračuna v žetonih. Pri nalogah z veliko orodji ti krožni prometi prevladujejo tako pri zakasnitvi kot pri stroških.
Kaj se spremeni
Programski klic orodij je prišel z različico GPT-5.6 9. julija 2026 v API-ju Responses. Namesto da bi zahteval orodja eno za drugim, model napiše majhen program JavaScript za njihovo usklajevanje. Lahko sproži klice vzporedno, uporabi zanke in pogoje ter ohrani vmesne rezultate znotraj izvedbenega okolja. V kontekst se vrne le reducirani rezultat – tisti, ki je pomemben za naslednji korak.
Razmisli o API-ju s paginacijo. Pri klasičnem klicanju funkcij vsaka stran rezultatov potuje skozi kontekst, da se lahko model odloči, ali naj zahteva naslednjo. S programskim klicem orodij model napiše zanko, ki iterira skozi strani, sešteje, kar je treba sešteti, in poroča nazaj le vsote: manj žetonov, manj zakasnitve in manj kode za usklajevanje, ki jo moraš vzdrževati.
OpenAI vsak program izvrši v svežem, izoliranem okolju V8. Ni Node.js, ni nameščanja paketov, ni neposrednega dostopa do omrežja, ni splošnega datotečnega sistema in med programi ni ohranjenega stanja. Program komunicira s svetom le prek orodij, ki mu jih izpostaviš. Za API Responses je to vedenje združljivo z ničelnim zadrževanjem podatkov (ZDR), pod pogojem, da je ZDR omogočen za organizacijo ali projekt.
Vklop v API-ju Responses
Dovolj sta dve nastavitvi. V zahtevo dodaš gostovano orodje programmatic_tool_calling, nato pa z allowed_callers določiš, kdo lahko kliče vsako upravičeno orodje: ["direct"] (privzeto vedenje, kjer model sam kliče orodje), ["programmatic"] (kliče ga lahko le program) ali oboje. Dokumentacija prav tako priporoča opis izhoda vsake funkcije z output_schema, da se lahko generirana koda zanaša na njena polja.
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,
)
Vrste orodij, ki jih lahko kliče program, vključujejo funkcije in prilagojena orodja, orodja MCP, apply_patch, lokalno ali gostovano lupino in interpreter kode. Za orodje MCP, ki zahteva odobritev, se program zaustavi, dokler ne podeliš soglasja.
Kaj prejme tvoja aplikacija
Odgovor ostaja standardni objekt Responses s tremi vrstami elementov, ki jih moraš prepoznati. Element program vsebuje generirani JavaScript. Elementi function_call ustrezajo klicem tvojih funkcij, ki jih je opravil ta program; njihovo polje caller identificira klicni program. Nazadnje, element program_output dostavi končni rezultat programa s statusom completed ali incomplete.
Tvoja aplikacija nikoli ne izvrši JavaScripta; to stori OpenAI. Izvršiš le svoje funkcije, nato pa vsak rezultat vrneš v function_call_output tako, da polje caller kopiraš nespremenjeno, da lahko pravilen program nadaljuje. Tako ponavljaš, dokler odgovor ne vsebuje več klicev za izvršitev.
Prepoznavanje nalog, ki imajo od tega korist
Ni vsaka integracija orodij koristna za selitev. Vodnik OpenAI ponuja jasno pravilo: programski klic orodij ustreza korakom, kjer je tok predvidljiv in koda lahko vrne manjši, strukturiran rezultat. Zasnovan je za filtriranje, združevanje, razvrščanje, odstranjevanje duplikatov, agregiranje ali validacijo več rezultatov ali za veriženje odvisnih klicev, kjer je pretok podatkov predvidljiv. Neposredno klicanje ostaja preferable za enojno iskanje ali dejanje, za prilagodljiva iskanja, kjer mora vsak rezultat voditi naslednjo odločitev, in za končno validacijo citatov. Prav tako ostaja privzeta izbira za pisanje in dejanja, ki zahtevajo odobritev, da se ohrani jasna meja avtorizacije.
Merilo za odločitev se skrči na eno vprašanje: kje tvoj agent porabi svoj čas? Če je odgovor „čakanje na krožne promete orodij”, je programski klic orodij prvo področje za evalvacijo. Če so tvoji klici orodij redki in njihovi rezultati kratki, obdrži svojo trenutno arhitekturo in svoje napore usmeri drugam.
Preizkusi sam
Identificiraj kandidata. Vzemi tok v svojem agentu, ki kliče več orodij. Za vsak korak zabeleži število klicev, velikost vmesnih rezultatov in ali gre za branje ali pisanje. Vsak korak razvrsti z uporabo zgornjega pravila. Za najbolj obetaven korak napiši poziv, ki določa dovoljena orodja, pričakovano obliko rezultata, pogoj zaustavitve, največje število poskusov in kaj ostane neposreden klic.
Uradni viri: Programski klic orodij · Uporaba GPT-6 (dokumentacija API-ja OpenAI) · Napoved GPT-5.6 (OpenAI, 9. julij 2026)
Ključne ugotovitve
- Model napiše in izvrši JavaScript za usklajevanje svojih orodij v izoliranem okolju, ki ga upravlja OpenAI
- Omogočiš ga z orodjem
programmatic_tool_callingin poljemallowed_callersna vsakem orodju - Tvoja aplikacija izvrši le svoje funkcije in vrne polje
callernedotaknjeno - Uporabi ga za filtriranje, agregiranje ali veriženje predvidljivih klicev; neposredno klicanje ostaja pravilo za pisanje in odobritve