OpenAI Agents SDK: Čo dokáže a kedy sa hodí

OpenAI Agents SDK je odľahčený open-source framework (licencia MIT) na tvorbu AI agentov so zámerne malým počtom abstrakcií. Je dostupný v Pythone a TypeScripte, považuje sa za produkčne pripraveného nástupcu experimentu Swarm a spája päť základných primitív: Agents, Handoffs, Guardrails, Sessions a Tracing. Aktualizácia z 15. apríla 2026 pridala natívne vykonávanie v sandboxe, model-native harness a podporu MCP a AGENTS.md (stav 2026).

• Čo to je: agentový framework od OpenAI s nízkou mierou abstrakcie, prvýkrát zverejnený 11. marca 2025, aktuálne vo verzii 0.14.x alebo vyššej (stav k 04/2026).
• Na čo sa hodí: nasadenia zamerané na GPT, rýchla iterácia a najkratší čas do prvého dema, vrátane vizuálneho Agent Buildera z AgentKitu.
• Kde sú hranice: stále API vo verzii v0.x, menej vyspelé multiagentové vzory ako pri LangGraphe a výrazná väzba na modely OpenAI.

Prehľad základných primitív

Dizajn sa riadi princípom „minimal abstractions“: namiesto ťažkého grafového modelu alebo modelu posádky (crew) ponúka hŕstku skladateľných stavebných blokov.

• Agents: Jednotka, ktorú tvoria inštrukcie, nástroje a model. Nástroje siahajú od prístupu k súborom a shellu cez apply-patch až po vykonávanie v sandboxe, ktoré je dostupné od apríla 2026.
• Handoffs: Agent odovzdá konverzáciu inému, špecializovanému agentovi. Je to ústredný vzor pre multiagentové procesy. Alternatívne možno agentov zapojiť ako nástroje („Agents as Tools“), ak si má volajúci agent ponechať kontrolu.
• Guardrails: Validačná a bezpečnostná vrstva, ktorá kontroluje vstupy a výstupy skôr, než sa ďalej spracujú.
• Sessions: Konfigurovateľná krátkodobá a dlhodobá pamäť; s aktualizáciou z apríla 2026 pribudli Memory a Snapshots.
• Tracing: Zabudovaná pozorovateľnosť cez OpenAI Traces UI, doplnená o export cez OpenTelemetry, napríklad do Logfire alebo AgentOps.

Týchto päť primitív pokrýva štyri zo šiestich stavebných blokov, ktoré tvoria plnohodnotný agentový framework (abstrakcia agenta, vrstva nástrojov, správa stavu, orchestrácia), a dopĺňa ich o pozorovateľnosť (observability) a produkčné hooky.

Od experimentu Swarm k produkčnému SDK

Swarm bol skorý, zámerne experimentálny pokus OpenAI o multiagentové systémy, bez produkčného nároku a bez oficiálnej podpory. Agents SDK preberá jeho hlavné myšlienky, predovšetkým jednoduché handoffy medzi agentmi, a pretavuje ich do podporovaného frameworku. Cesta k zrelosti je viditeľná od spustenia: na konferencii DevDay 6. októbra 2025 predstavila spoločnosť OpenAI v rámci AgentKitu vizuálny Agent Builder, Connector Registry a ChatKit. Aktualizácia z 15. apríla 2026 potom priniesla vykonávanie v sandboxe, model-native harness pre dlhodobo bežiace úlohy a plnohodnotnú podporu protokolu Model Context Protocol (MCP) a konvencie repozitárov AGENTS.md.

Dôležité pre plánovanie: spoločnosť OpenAI v auguste 2025 ohlásila ukončenie podpory staršieho Assistants API. Ako dátum vypnutia uvádza prehľad ukončovaných rozhraní OpenAI 26. august 2026. Nové projekty stavajú priamo na Agents SDK a Responses API, existujúce workloady na Assistants API treba presunúť na Responses API a Conversations API (stav k októbru 2026).

Silné stránky v ekosystéme OpenAI

Najväčšie výhody vznikajú, keď už aj tak pracuješ v stacku OpenAI:

• Natívna optimalizácia pre modely GPT: SDK je úzko zladené s modelmi OpenAI, takže volanie nástrojov (tool calling) a uvažovanie (reasoning) môžeš využiť priamo.
• Najkratší čas do dema: Málo abstrakcií znamená málo boilerplate kódu. Funkčný agent je hotový rýchlo.
• Vizuálna vrstva cez AgentKit: Agent Builder znižuje vstupnú bariéru aj pre menej technicky zdatné zainteresované strany.
• Otvorené protokoly: MCP a AGENTS.md sú od apríla 2026 natívne podporované, čo štandardizuje pripájanie nástrojov a konvencie repozitárov.
• Dosah na ďalších poskytovateľov (s hviezdičkou): Podľa OpenAI možno SDK cez endpointy kompatibilné s Chat Completions prevádzkovať s viac ako 100 LLM. Ide však o tvrdenie dodávateľa a v praxi to závisí od kompatibility konkrétneho endpointu.

V produkcii SDK nasadzujú okrem iných Ramp, Bain & Company, Canva a LY Corporation.

Hranice a viazanosť na poskytovateľa

Odvrátenú stranu minimalizmu treba jasne pomenovať:

• Väzba na OpenAI: Aj keď je SDK open source, API modelov zostáva proprietárne. Natívna optimalizácia pre modely OpenAI projekty fakticky viaže na GPT.
• Stále v0.x: API nie je finálne; spätne nekompatibilné zmeny sú možné.
• Menej vyspelé multiagentové vzory: Pre zložitú, dlhodobo bežiacu orchestráciu, ktorá podlieha auditu, je LangGraph so svojím grafovým modelom a s LangSmithom alebo Microsoft Agent Framework spoľahlivejšou voľbou.
• Nútená migrácia z Assistants API: Assistants API má ukončenú podporu, dátum jeho vypnutia bol 26. august 2026. Existujúce workloady treba presunúť na Responses API a Conversations API.
• Dátová rezidencia v regióne DACH: Bez výberu regiónu OpenAI negarantuje, kde sa požiadavky na API spracúvajú. Pre modely OpenAI s dátovou rezidenciou v EÚ existujú dve cesty: európsky región OpenAI API (ukladanie a spracovanie v EHP a vo Švajčiarsku, len po schválení zo strany OpenAI) alebo Azure OpenAI s nasadením v regiónoch EÚ (napríklad Frankfurt, West Europe, Sweden Central). Diskusia o zákone CLOUD Act pri amerických dodávateľoch pretrváva. Ide o informatívny prehľad, ktorý nenahrádza právne poradenstvo.

Porovnanie s alternatívami

Rozhodovaciu logiku možno zhrnúť stručne: výhradne GPT a najrýchlejšia cesta k demu hovoria v prospech OpenAI Agents SDK. Povinnosť auditu, dlhodobo bežiace a výrazne stavové workloady hovoria v prospech LangGraphu alebo Microsoft Agent Frameworku. Povinný .NET vedie k Microsoft Agent Frameworku, pri strategickej voľbe Anthropic je to Claude Agent SDK.

Krátky príklad: triáž s handoffom

Typickým vzorom je triážny agent, ktorý prichádzajúce požiadavky posúva špecializovaným agentom. Ako pseudokód:

```python
from agents import Agent, Runner

billing_agent = Agent(
name="Billing",
instructions="Odpovedaj na otázky o faktúrach a platbách."
)

tech_agent = Agent(
name="Technika",
instructions="Rieš technické problémy s produktom."
)

triage = Agent(
name="Triage",
instructions="Postúp požiadavku vhodnému agentovi.",
handoffs=[billing_agent, tech_agent]
)

result = Runner.run_sync(triage, "Platbu za faktúru mi strhli z účtu dvakrát.")
print(result.final_output)
```

Triážny agent rozpozná tému fakturácie a cez handoff odovzdá konverzáciu agentovi Billing, ktorý odpovie s vlastným kontextom. Guardrails môžu vstup vopred skontrolovať, Sessions uchovávajú priebeh rozhovoru a každý krok sa automaticky zapíše do tracingu. Konkrétne to znamená: namiesto údržby jedného monolitického promptu so všetkými prípadmi rozdelíš logiku medzi špecializovaných agentov. To znižuje komplexnosť promptov a zdroje chýb sa dajú dohľadať v rozhraní Traces.

Pre agentúry a B2B manažérov s rozhodovacou právomocou

Pre marketingové agentúry a B2B tímy v regióne DACH je OpenAI Agents SDK najvhodnejším nástrojom, keď rozhodujú rýchle prototypy postavené na GPT a krátke iteračné cykly, napríklad pri triáži požiadaviek na podporu, obsahových pipelinoch alebo interných asistenčných systémoch. Kto dlhodobo stavia na suverenite, auditovateľnosti alebo nezávislosti od poskytovateľa, mal by s väzbou na dodávateľa vedome počítať, dátovú rezidenciu v EÚ zabezpečiť cez európsky región OpenAI API alebo cez Azure OpenAI a prompty, nástroje a sady evaluácií držať nezávislé od frameworku, aby neskôr mohol bez problémov prejsť na LangGraph alebo inú platformu. Blck Alpaca sprevádza tento výber architektúry a nástrojov v rámci integrácie AI agentov od prvej štúdie uskutočniteľnosti až po produkčnú prevádzku v súlade s GDPR.