Programatické volání nástrojů: Nástroje orchestrované modelem
Na této stránce
Stav k 5. listopadu 2026. Rodina GPT-6 dědí schopnosti API z GPT-5.6, včetně programatického volání nástrojů. Agents API to umožňuje ve výchozím nastavení (lekce 10). OpenAI doporučuje před povolením této funkce zkontrolovat kartu modelu.
Abys pochopil, co programatické volání nástrojů přináší, musíš se nejprve podívat na cenu klasického volání funkcí. Model požádá o provedení nástroje, tvůj kód jej spustí a výsledek se vrátí modelu, který si jej přečte a rozhodne o dalším kroku. Jedna zpáteční cesta není problém. Deset zpátečních cest pro jediný úkol je však jiná písnička: každý krok přidává latenci a každý průběžný výsledek – i když je objemný nebo pro konečnou odpověď irelevantní – prochází zpět kontextem modelu a je účtován v tocenech. U úloh náročných na nástroje dominují tyto zpáteční cesty jak latenci, tak nákladům.
Co se mění
Programatické volání nástrojů přišlo s modelem GPT-5.6 dne 9. července 2026 v rámci Responses API. Místo aby model požadoval nástroje jeden po druhém, napíše malý JavaScriptový program, který je koordinuje. Může spouštět volání paralelně, používat smyčky a podmínky a udržovat průběžné výsledky uvnitř执行ního prostředí. Do kontextu se vrací pouze redukovaný výsledek – ten, který záleží pro další krok.
Vezmi si například stránkované API. Při klasickém volání funkcí prochází kontextem každá stránka výsledků, aby se model mohl rozhodnout, zda požádat o další. S programatickým voláním nástrojů model napíše smyčku, která iteruje stránkami, sečte to, co je třeba sečíst, a nahlásí zpět pouze součty: méně tokenů, menší latence a méně orchestračného kódu, který musíš udržovat.
OpenAI spouští každý program v novém, izolovaném prostředí V8. Neexistuje zde Node.js, žádná instalace balíčků, žádný přímý přístup k síti, žádný obecný souborový systém a žádný stav zachovávaný mezi programy. Program komunikuje se světem pouze prostřednictvím nástrojů, které mu zpřístupníš. Pro Responses API je toto chování kompatibilní se zásadou Zero Data Retention (ZDR), pokud je ZDR povolena pro organizaci nebo projekt.
Povolení v Responses API
Stačí dvě nastavení. Do požadavku přidáš hostovaný nástroj programmatic_tool_calling a poté pomocí allowed_callers určíš, kdo může volat každý způsobilý nástroj: ["direct"] (výchozí chování, kdy nástroj volá samotný model), ["programmatic"] (může jej volat pouze program), nebo obojí. Dokumentace také doporučuje popsat výstup každé funkce pomocí output_schema, aby se generovaný kód mohl spolehnout na její pole.
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,
)
Mezi typy nástrojů, které lze volat z programu, patří funkce a vlastní nástroje, nástroje MCP, apply_patch, lokální nebo hostovaný shell a interpret kódu. U nástroje MCP podléhajícího schválení se program pozastaví, dokud neudělíš souhlas.
Co tvoje aplikace obdrží
Odpověď zůstává standardním objektem Responses se třemi typy prvků, které je třeba rozpoznat. Prvek program obsahuje vygenerovaný JavaScript. Prvky function_call odpovídají voláním tvých funkcí provedeným tímto programem; jejich pole caller identifikuje volající program. Nakonec prvek program_output doručí konečný výsledek programu se stavem completed nebo incomplete.
Tvoje aplikace nikdy nespouští JavaScript; to dělá OpenAI. Ty pouze执行íš své vlastní funkce a poté vrátíš každý výsledek v function_call_output tak, že pole caller zkopíruješ beze změny, aby mohl správný program pokračovat. Takto cykluješ, dokud odpověď neobsahuje žádná další volání k执行ění.
Identifikace úloh, kterým to prospěje
Ne každá integrace nástrojů těží z migrace. Průvodce OpenAI nabízí jasné pravidlo: Programatické volání nástrojů se hodí pro kroky, kde je tok předvídatelný a kód může vrátit menší, strukturovaný výsledek. Je navržen pro filtrování, spojování, řazení, odstraňování duplicit, agregaci nebo validaci více výsledků, případně pro řetězení závislých volání, kde je tok dat předvídatelný. Přímé volání zůstává výhodnější pro jednotlivé vyhledávání nebo akce, pro adaptivní vyhledávání, kde každý výsledek musí řídit další rozhodnutí, a pro konečnou validaci citací. Zůstává také výchozí volbou pro zápisy a akce vyžadující schválení, aby se udržela jasná hranice autorizace.
Rozhodovací kritérium se scvrkává na jednu otázku: kde tvůj agent tráví čas? Pokud je odpověď „čekáním na zpáteční cesty nástrojů“, je programatické volání nástrojů první oblastí k posouzení. Pokud jsou tvá volání nástrojů vzácná a jejich výsledky krátké, ponech svou současnou architekturu a soustřeď úsilí jinam.
Vyzkoušej si to sám
Identifikuj kandidáta. Vezmi tok ve svém agentovi, který volá více nástrojů. Pro každý krok zaznamenej počet volání, velikost průběžných výsledků a zda jde o čtení nebo zápis. Klasifikuj každý krok pomocí výše uvedeného pravidla. Pro nejslibnější krok napiš prompt, který specifikuje povolené nástroje, očekávaný formát výsledku, podmínku ukončení, maximální počet opakování a co zůstává přímým voláním.
Oficiální zdroje: Programatické volání nástrojů · Používání GPT-6 (dokumentace API OpenAI) · Oznámení GPT-5.6 (OpenAI, 9. července 2026)
Klíčové poznatky
- Model píše a执行í JavaScript pro koordinaci svých nástrojů v izolovaném prostředí spravovaném OpenAI
- Povolíš to pomocí nástroje
programmatic_tool_callinga poleallowed_callersu každého nástroje - Tvoje aplikace执行í pouze své funkce a vrací pole
callernedotčené - Upřednostni to pro filtrování, agregaci nebo řetězení předvídatelných volání; pro zápisy a schválení zůstává pravidlem přímé volání