Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Programski klic orodij: orodja, usklajena z modelom

Lekcija 5 od 12 Posodobljeno 5. november 2026 Srednje napredni
Na tej strani
  1. Kaj se spremeni
  2. Vklop v API-ju Responses
  3. Kaj prejme tvoja aplikacija
  4. Prepoznavanje nalog, ki imajo od tega korist
  5. Preizkusi sam
  6. Ključne ugotovitve

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.

Kdo kaj izvrši Trije koraki: model napiše program JavaScript, ki ga OpenAI izvrši v izoliranem okolju; tvoja aplikacija izvrši klice funkcij iz tega programa in vrne rezultate z nespremenjenim poljem caller; program dostavi reduciran rezultat v program_output. PROGRAMSKI KLIC ORODIJ Kdo kaj izvrši 1 Program Napisal model 2 Tvoje funkcije Izvršiš ti 3 Rezultat Reduciran program_output JavaScript teče pri OpenAI, nikoli na tvoji strani. Občutljiva pisanja ostanejo neposredni klici.
Na podlagi vodnika za programski klic orodij v dokumentaciji API-ja OpenAI (november 2026).

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_calling in poljem allowed_callers na vsakem orodju
  • Tvoja aplikacija izvrši le svoje funkcije in vrne polje caller nedotaknjeno
  • Uporabi ga za filtriranje, agregiranje ali veriženje predvidljivih klicev; neposredno klicanje ostaja pravilo za pisanje in odobritve