Knihovna openai-python dostala 42 nových koncových bodů pod Agents API

Oficiální klient OpenAI pro Python vydal mezi 9. a 10. zářím 2026 čtyři verze. Poslední dvě dělí na PyPI dvě hodiny a devět minut: 3.12.0 se nahrálo 10. září v 17.29 UTC, 3.13.0 v 19.38 UTC. V té druhé přibylo do knihovny Agents API a s ním rozhraní, které dosud v klientovi nemělo obdobu.

Soupis cest narostl o šestinu

Repozitář vede v souboru api.md strojově generovaný seznam všech metod klienta a u každé uvádí i cestu, na kterou míří. Ve značce v3.12.0 je v něm 263 záznamů, ve v3.13.0 jich je 306. Verze 3.11.0 měla týchž 263, takže celý rozdíl padá na jedno vydání.

Rozdíl je 43 řádků, ale nových cest je 42. Třiatřicet z nich začíná na /agents a devět na /vaults. Zbylý řádek nový koncový bod není, o tom níž. Kolo ke stažení tomu odpovídá: 1,75 MB u verze 3.11.0, 1,86 MB u 3.12.0 a 2,01 MB u 3.13.0.

Agent dostane sezení, prostředí a podagenty

Pět cest obsluhuje samotné agenty, tedy jejich založení, čtení, úpravu, výpis a smazání. Zbytek je stavba kolem nich. Sezení má vlastní pětici a k ní proud událostí přes GET /agents/sessions/{session_id}/events. Prostředí, ve kterém agent pracuje, umí přebírat soubory a má vlastní šablony s pěti cestami. Výstupy sezení se čtou jako artefakty, u kterých je i samostatná cesta na stažení obsahu.

Nejhlouběji zanořená cesta v celém soupisu vede na /agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}/items. Agent tedy smí založit podagenta, ten má svá kola a každé kolo své položky. Mezi datovými typy, které vydání přidalo, je i agent_command_execution_item – záznam o spuštěném příkazu.

Že jde o beta rozhraní, není jen věc pojmenování. Metody sedí v klientovi pod client.beta.agents a zdrojový soubor agents.py ke každému volání přibaluje hlavičku OpenAI-Beta: agents=v1. Rychlý start v dokumentaci to potvrzuje z druhé strany: kdo volá rozhraní ručně přes cURL, musí hlavičku přidat sám, protože ji sady nástrojů doplňují za něj.

Tentýž návod říká, na čem to běží. Agenta obsluhuje podle něj Codex harness spravovaný OpenAI a příklad zakládá prostředí typu openai_hosted s modelem gpt-6-astra. Klíč k rozhraní potřebuje oprávnění api.agents.read a api.agents.write, k tomu api.responses.write na vlastní běh modelu. Dokumentace k tomu přidává větu, kterou stojí za to číst pomalu: klíč patří mimo sandbox agenta. O tom, jak Codex zachází se shrnutím konverzace, jsme psali dřív.

Trezor stojí mimo cestu agentů

Devět cest na přihlašovací údaje je v klientovi zařazených pod client.beta.agents.vaults, jenže v adresách žádné agenty nemají. Vedou na /vaults a /vaults/{vault_id}/credentials, tedy do kořene rozhraní. Trezor se dá založit, přečíst, vypsat a smazat; uvnitř něj se totéž dělá s jednotlivými údaji.

Je to drobnost v pojmenování, která ale něco říká o záměru. Kdyby byl trezor součástí agenta, patřil by pod jeho cestu. Takhle vypadá jako zásobárna, ke které se agent připojuje – a kterou může sdílet víc sezení. Dokumentace k trezoru samostatnou stránku nemá; guides/agents-api/vaults.md vrací 404 a jediné, co je o něm veřejně k dispozici, je právě soupis cest v klientovi.

Live API přišlo o dvě hodiny dřív

Vydání 3.12.0 přidalo hlasové rozhraní, ale v počtu 263 se to neprojevilo. Jeho koncové body totiž nejsou v hlavním soupisu, mají vlastní soubor src/openai/resources/live/api.md. Ve značce v3.11.0 ten soubor neexistuje vůbec, ve 3.12.0 má sedm cest a ve 3.13.0 tentýž počet.

Sedmičku tvoří založení sezení a za ním accept, content, fork, hangup, refer a reject. Přijmout hovor, odmítnout ho, zavěsit a přepojit jinam – slovník telefonní ústředny, ne chatovacího rozhraní. Sedí to k tomu, co průvodce GPT-Live popisuje: model vede mluvenou konverzaci, umí poslouchat a mluvit zároveň, a práci předává na pozadí jinému modelu nebo agentovi.

Ceník je u něj postavený na čase, ne na tokenech. Karta modelu gpt-live-1 uvádí 0,05 USD za minutu hlasového sezení s účtováním po sekundách a s výslovnou poznámkou, že se délka nezaokrouhluje nahoru na celé minuty. Práce modelu na pozadí se počítá zvlášť běžnou sazbou. Tatáž karta uvádí, že model neobsluhuje /v1/responses, /v1/chat/completions ani /v1/realtime – jedinou podporovanou cestou je /v1/live/sessions.

Jeden ze 43 řádků nový není

Zbývá dopočítat rozdíl. Třiatřicet cest pod agenty a devět pod trezory dá 42, kdežto soupis vyrostl o 43 řádků. Ten jedenačtyřicátý druhý řádek navíc není nová funkce: oddíl Safety je ve značce v3.13.0 vysázený dvakrát. Na řádku 438 a znovu na 452 stojí týž nadpis, týž datový typ SafetyAlert a táž cesta GET /safety/alerts/{id}. Ve verzi 3.12.0 je tentýž oddíl jen jednou.

Je to vada generovaného soupisu, ne klienta – zdvojený blok odkazuje na tentýž soubor v src. Pro čtenáře dokumentace je to kosmetika. Pro každého, kdo počítá velikost rozhraní z toho souboru, je to jeden koncový bod navíc, který neexistuje.

Mezi 3.11.0 a 3.13.0 je tedy skoro všechno nové schované ve dvou vydáních za jediný den. Verze 3.11.0 z 9. září proti tomu nese jedinou položku, a to nastavení expirace u klíčů servisních účtů.

Zdroje

• openai-python 3.13.0 – vydání, které přidalo Agents API
• Soupis koncových bodů ve v3.13.0 – cesty pod /agents a /vaults i zdvojený oddíl Safety
• Rychlý start Agents API – hlavička beta, oprávnění klíče a prostředí openai_hosted
• Karta modelu gpt-live-1 – sazba za minutu a seznam podporovaných cest
• Historie vydání na PyPI – časy nahrání a velikosti jednotlivých kol