Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Programatické volanie nástrojov: Nástroje orchestrované modelom

Lekcia 5 z 12 Aktualizované 5. novembra 2026 Mierne pokročilý
Na tejto strane
  1. Čo sa mení
  2. Povolenie v Responses API
  3. Čo tvoja aplikácia dostane
  4. Identifikácia úloh, ktoré z toho ťažia
  5. Vyskúšaj si to sám
  6. Kľúčové poznatky

Stav k 5. novembru 2026. Rodina GPT-6 dedí schopnosti API od GPT-5.6, vrátane programatického volania nástrojov. Agents API to umožňuje predvolene (Lekcia 10). OpenAI odporúča pred povolením tejto funkcie skontrolovať kartu modelu (model card).

Aby si pochopil, čo prináša programatické volanie nástrojov, musíš sa najprv pozrieť na cenu klasického volania funkcií. Model požiada o vykonanie nástroja, tvoj kód ho spustí a výsledok sa vráti modelu, ktorý si ho prečíta a rozhodne o ďalšom kroku. Jedna spätná väzba (round trip) nie je veľký problém. Desať spätných väzieb pre jednu úlohu je však iná situácia: každý krok pridáva oneskorenie a každý priebežný výsledok – aj keď je objemný alebo irelevantný pre konečnú odpoveď – prechádza späť cez kontext modelu a je fakturovaný v tokenoch. Pri úlohách náročných na nástroje dominujú tieto spätné väzby oneskoreniu aj nákladom.

Čo sa mení

Programatické volanie nástrojov prišlo s GPT-5.6 dňa 9. júla 2026 v Responses API. Namiesto požiadaviek na nástroje jeden po druhom model napíše malý JavaScriptový program na ich koordináciu. Môže spúšťať volania paralelne, používať slučky a podmienky a udržiavať priebežné výsledky vo vykonávacom prostredí. Do kontextu sa vráti iba zredukovaný výsledok – ten, ktorý záleží pre ďalší krok.

Zober si stránkované API. Pri klasickom volaní funkcií prechádza každá stránka výsledkov kontextom, aby sa model mohol rozhodnúť, či má požiadať o ďalšiu. Pri programatickom volaní nástrojov model napíše slučku, ktorá iteruje cez stránky, sčíta to, čo treba sčítať, a nahlási späť iba súčty: menej tokenov, menšie oneskorenie a menej koordinačného kódu, ktorý musíš udržiavať.

OpenAI vykonáva každý program v novom, izolovanom prostredí V8. Nie je tu Node.js, žiadna inštalácia balíkov, žiadny priamy prístup k sieti, žiadny všeobecný súborový systém a medzi programami sa neuchováva žiadny stav. Program komunikuje so svetom iba prostredníctvom nástrojov, ktoré mu exposeuješ. Pre Responses API je toto správanie kompatibilné so zásadou Zero Data Retention (ZDR), za predpokladu, že je ZDR povolená pre organizáciu alebo projekt.

Povolenie v Responses API

Stačia dve nastavenia. Do požiadavky pridáš hostovaný nástroj programmatic_tool_calling a potom pomocou allowed_callers určíš, kto môže volať každý oprávnený nástroj: ["direct"] (predvolené správanie, kde model volá nástroj sám), ["programmatic"] (môže ho volať iba program) alebo obe možnosti. Dokumentácia tiež odporúča popísať výstup každej funkcie pomocou output_schema, aby sa na jej polia mohol spolahnúť generovaný kód.

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

Medzi typy nástrojov, ktoré možno volať z programu, patria funkcie a vlastné nástroje, nástroje MCP, apply_patch, lokálny alebo hostovaný shell a interpretátor kódu. Pri nástroji MCP, ktorý podlieha schváleniu, sa program pozastaví, kým neudelíš súhlas.

Čo tvoja aplikácia dostane

Odpoveď zostáva štandardným objektom Responses s tromi typmi prvkov, ktoré treba rozpoznať. Prvok program obsahuje vygenerovaný JavaScript. Prvky function_call zodpovedajú volaniam tvojej funkcie vykonaným týmto programom; ich pole caller identifikuje volajúci program. Nakoniec prvok program_output doručí konečný výsledok programu so stavom completed alebo incomplete.

Tvoja aplikácia nikdy nevykonáva JavaScript; robí to OpenAI. Ty iba vykonáš svoje vlastné funkcie a potom vrátiš každý výsledok v function_call_output skopírovaním poľa caller nezmeneného, aby mohol správny program pokračovať. Takto cykluješ, kým odpoveď neobsahuje žiadne ďalšie volania na vykonanie.

Kto čo vykonáva Tri kroky: model napíše JavaScriptový program, ktorý OpenAI vykoná v izolovanom prostredí; tvoja aplikácia vykoná volania funkcií z tohto programu a vráti výsledky s nedotknutým poľom caller; program doručí zredukovaný výsledok v program_output. PROGRAMATICKÉ VOLANIE NÁSTROJOV Kto čo vykonáva 1 Program Napísaný modelom 2 Tvoje funkcie Vykonané tebou 3 Výsledok Zredukovaný program_output JavaScript beží u OpenAI, nikdy nie u teba. Citlivé zápisy zostávajú priame volania.
Na základe sprievodcu Programatické volanie nástrojov v dokumentácii OpenAI API (november 2026).

Identifikácia úloh, ktoré z toho ťažia

Nie každá integrácia nástrojov profituje z migrácie. Sprievodca OpenAI ponúka jasné pravidlo: Programatické volanie nástrojov sa hodí pre kroky, kde je tok predvídateľný a kód môže vrátiť menší, štruktúrovaný výsledok. Je navrhnuté na filtrovanie, spájanie, triedenie, odstraňovanie duplicit, agregáciu alebo validáciu viacerých výsledkov, alebo na reťazenie závislých volaní, kde je tok dát predvídateľný. Priame volanie zostáva vhodnejšie pre jednotlivé vyhľadávania alebo akcie, pre adaptívne vyhľadávania, kde každý výsledok musí viesť ďalšie rozhodnutie, a pre konečnú validáciu citácií. Zostáva tiež predvolenou voľbou pre zápisy a akcie vyžadujúce schválenie, aby sa zachovala jasná hranica autorizácie.

Rozhodovacie kritérium sa redukuje na jednu otázku: kde trávi tvoj agent najviac času? Ak je odpoveď „čakaním na spätné väzby nástrojov“, programatické volanie nástrojov je prvou oblasťou na vyhodnotenie. Ak sú tvoje volania nástrojov zriedkavé a ich výsledky krátke, ponechaj svoju aktuálnu architektúru a sústreď svoje úsilie inde.

Vyskúšaj si to sám

Identifikuj kandidáta. Vezmi tok vo svojom agentovi, ktorý volá viacero nástrojov. Pre každý krok si zaznamenaj počet volaní, veľkosť priebežných výsledkov a či ide o čítanie alebo zápis. Klasifikuj každý krok podľa vyššie uvedeného pravidla. Pre najsľubnejší krok napíš prompt, ktorý špecifikuje povolené nástroje, očakávaný formát výsledku, podmienku zastavenia, maximálny počet opakovaní a čo zostáva priamym volaním.

Oficiálne zdroje: Programatické volanie nástrojov · Používanie GPT-6 (dokumentácia OpenAI API) · Oznámenie GPT-5.6 (OpenAI, 9. júla 2026)

Kľúčové poznatky

  • Model píše a vykonáva JavaScript na koordináciu svojich nástrojov v izolovanom prostredí spravovanom OpenAI
  • Povolíš to pridaním nástroja programmatic_tool_calling a poľa allowed_callers pri každom nástroji
  • Tvoja aplikácia vykonáva iba svoje funkcie a vracia pole caller nedotknuté
  • Uprednostni to pri filtrovaní, agregácii alebo reťazení predvídateľných volaní; priame volanie zostáva pravidlom pre zápisy a schvaľovania