OpenAI Agents API vs Agents SDK vs Responses API: Na čemu bi trebalo da gradite u 2026?

OpenAI-jev stek za agente značajno se promenio u septembru 2026. Novi Agents API uveo je upravljani Codex harness za trajne cloud agente, dok je stariji Agents SDK prešao u fazu održavanja sa zaokruženim funkcionalnostima. Responses API ostaje interfejs nižeg nivoa za aplikacije koje žele direktne pozive modela ili da same upravljaju petljom agenta. Ovo nisu tri međusobno zamenljiva omotača oko iste stvari: oni postavljaju granicu runtime-a na različita mesta.

Arhitektura se promenila: izaberite granicu runtime-a, a ne biblioteku

Važna odluka više nije jednostavno „Koji SDK treba da instaliram?” Reč je o tome ko kontroliše harness, petlju agenta, trajno stanje sesije, sažimanje konteksta, oporavak, izvršno okruženje i životni ciklus aplikacije.

OpenAI-jev trenutni pregled za Agents jasno definiše ovu granicu. Agents API pokreće hostovani Codex harness i upravlja orkestracijom, kao i trajnim stanjem sesije. Responses API pruža odgovore modela i hostovane mogućnosti, dok vaša aplikacija upravlja okolnom petljom agenta. Agents SDK pokreće petlju u vašoj aplikaciji i sada je zaokružen po pitanju funkcionalnosti, te više ne predstavlja pravac za razvoj novih velikih mogućnosti za agente.

Kratko poređenje

1. Agents API: upravljani harness, trajni cloud agent

Agents API izlaže Codex harness kroz servis kojim upravlja OpenAI. OpenAI upravlja sesijama, orkestracijom, sažimanjem konteksta i oporavkom. Vaša aplikacija i dalje obezbeđuje alate i bira izvršno okruženje.

Ta poslednja razlika je važna. „Upravljani agent” ne znači nužno da se „svo računanje odvija unutar OpenAI-ja”. Arhitektura Agents API-ja podržava rad bez okruženja, okruženje koje hostuje OpenAI, ili okruženje na sopstvenom hostingu povezano sa hostovanim harness-om. Sa okruženjem na sopstvenom hostingu, vaša aplikacija upravlja provizionisanjem, ponovnim povezivanjem, gašenjem i trajnim datotekama, dok harness ostaje pod upravljanjem OpenAI-ja.

Agents API je stoga runtime servis, a ne samo format zahteva. Sesije mogu biti trajne, strimovati napredak, primati dodatne zadatke, koristiti alate, raditi sa datotekama i oporavljati se tokom dugotrajnog rada.

Šta dobijate uz Agents API

• Upravljani Codex harness umesto da sami gradite i upravljate glavnom petljom agenta.
• Trajne sesije za rad koji obuhvata više koraka i dugotrajne zadatke.
• Upravljanu orkestraciju, sažimanje konteksta i oporavak.
• Izvršna okruženja koja hostuje OpenAI ili okruženja na sopstvenom hostingu, u zavisnosti od zahteva radnog opterećenja.
• Strimovanje i veb-hukove za praćenje napretka i događaja životnog ciklusa.
• Strateški pravac platforme koji OpenAI izričito preporučuje za nove agentske aplikacije.

Šta i dalje ostaje pod vašom kontrolom

• Vaš proizvod i aplikativni server.
• Implementacije funkcija-alata i poslovna logika.
• Odluke o autorizaciji i polisama koje se odnose na vaše sopstvene sisteme.
• Životni ciklus izvršnog okruženja kada se odlučite za računarske resurse na sopstvenom hostingu.
• Evaluacija, kriterijumi prihvatanja, specifični zaštitni mehanizmi za domen i odluka o tome šta je agentu dozvoljeno da radi.

2. Responses API: upravljajte petljom, koristite primitive platforme

Responses API je izbor nižeg nivoa kada želite mogućnosti OpenAI modela i alata bez delegiranja celokupnog radnog okruženja (runtime) agenta. OpenAI opisuje Responses kao preporučeni API primitiv za nove projekte i kao evoluciju Chat Completions-a sa ugrađenim alatima, opcijama stanja kroz više krugova razgovora, multimodalnim unosom i agentskim korišćenjem alata.

Sam Responses zahtev može pozivati alate, ali vaša aplikacija ostaje odgovorna za širi radni tok kada gradite agenta oko njega. To znači da vaš kod odlučuje o tome kako perzistirati stanje aplikacije, kada nastaviti, kako se oporaviti od grešaka, kako koordinisati specijaliste, kako sažeti dugu istoriju i kako predstaviti rad koji se može nastaviti.

Ovo nije suštinski lošije rešenje. To je prava granica kada ponašanje agenta mora biti duboko integrisano u postojeću logiku aplikacije, kada vam je potreban prilagođeni model stanja ili kada bi upravljani okvir (managed harness) sakrio kontrolu koja vam je zapravo potrebna.

3. Agents SDK: podržan, ali više nije podrazumevani put za budući razvoj

Agents SDK ostaje radni okvir otvorenog koda za pokretanje radnih tokova agenata u vašoj aplikaciji. Pruža definicije agenata, alate, primopredaje (handoffs), zaštitne ograde (guardrails), praćenje (tracing), sesije i petlju izvršavanja u TypeScript-u i Python-u.

Ali njegov strateški status se promenio. OpenAI sada označava Agents SDK kao funkcionalno završen (feature complete): održavanje, bezbednosne ispravke, kritične ispravke grešaka i rad na kompatibilnosti se nastavljaju, ali nove veće funkcionalnosti nisu planirane. OpenAI preporučuje Agents API za nove aplikacije.

To ne znači da postojeću SDK aplikaciju treba odmah ponovo napisati. To znači da arhitektura treba da prestane da pretpostavlja da je SDK mesto na koje će stići sledeće velike mogućnosti radnog okruženja za agente.

Gde se uklapa Codex SDK

Trenutni izbor nije jednostavno trostruko grananje. OpenAI-jev pregled radnih okruženja uključuje Codex SDK kao opciju za pokretanje Codex okvira u infrastrukturi kojom sami upravljate. To se arhitektonski razlikuje i od hostovanog Agents API-ja i od Agents SDK-a.

Ako je vaš stvarni zahtev „Želim Codex okvir, ali moram sam njime da upravljam”, Codex SDK je rešenje koje treba proceniti. Ako je vaš zahtev „Želim da upravljam petljom oko poziva modela”, procenite Responses. Ako je vaš zahtev „Već imam funkcionalnu Agents SDK aplikaciju”, postojeći SDK može ostati validan dok pravite planove u skladu sa njegovim statusom održavanja.

Test vlasništva nad radnim okruženjem

Korisna arhitektonska odluka počinje definisanjem onoga što vaš tim mora da poseduje. Ocenite svaki zahtev kao: mora kontrolisati, poželjno kontrolisati ili poželjno upravljano.

Stablo odlučivanja za nove sisteme

Šta ne bi trebalo da vodi donošenje odluke

Migracija je arhitektonska promena, a ne preimenovanje uvoza

Prelazak sa Agents SDK na Agents API menja vlasništvo. U SDK-u, petlja se izvršava u vašoj aplikaciji. U Agents API-ju, OpenAI upravlja okvirom i sesijom, dok se vaša aplikacija integriše putem zadataka, događaja, alata i granica okruženja.

Pravi plan migracije stoga mora da mapira stanje sesije, prilagođenu orkestraciju, prenošenje zadataka, izvršavanje alata, odobrenja, skladištenje, praćenje, ponovne pokušaje, oporavak od grešaka, životni ciklus okruženja i sve apstrakcije specifične za provajdera. Obim koda može se smanjiti dok se operativne pretpostavke menjaju.

Popis elemenata za migraciju

• Definicije agenata i vlasništvo nad instrukcijama.
• Definicije alata i lokacija gde se svaki alat izvršava.
• Prenošenje zadataka, obrasci menadžera/specijaliste i ponašanje podagenata.
• Identifikatori sesije, stanje razgovora, mogućnost nastavka i zadržavanje istorije.
• Ljudska odobrenja i semantika prekida.
• Prilagođena logika za skraćivanje ili zbijanje konteksta.
• Praćenje, evaluacije, opservabilnost i otklanjanje grešaka u produkciji.
• Samostalno hostovane datoteke, kontejneri, pristup privatnoj mreži ili druge zavisnosti izvršavanja.
• Apstrakcija provajdera ili zavisnosti od modela koji nisu OpenAI.
• Pretpostavke o ponovnim pokušajima, vremenskom isteku, idempotentnosti, oporavku i životnom ciklusu.

Javna beta menja model rizika

Agents API je preporučeni smer za nove agentske aplikacije, ali je takođe u javnoj beta verziji. Te činjenice nisu u suprotnosti. Strateški smer odgovara na pitanje „kuda platforma ide?”, dok beta status odgovara na pitanje „koliko promena interfejsa i operativnih promena treba planirati u budžetu?”

Za produkcione sisteme, izolujte integraciju iza granice aplikacije. Držite stanje domena, dozvole, revizorske podatke i poslovna pravila van objekata sesije specifičnih za dobavljača gde god je to moguće. Ovo olakšava prilagođavanje evoluciji API-ja bez pretvaranja izvršnog okruženja agenta u izvor istine za ceo vaš proizvod.

Praktična podrazumevana arhitektura

Za mnoge nove izvorne OpenAI aplikacije, razuman podrazumevani izbor za 2026. godinu jeste: Agents API za upravljani okvir i trajnu sesiju, domenski servisi i autorizacija u vlasništvu aplikacije, eksplicitni alati funkcija za poslovne akcije, i izvršavanje hostovano od strane OpenAI-ja ili samostalno, u zavisnosti od zahteva za podacima i računarskim resursima.

To održava izvršno okruženje agenta moćnim, a da ono ne postane vlasnik poslovne istine. Aplikacija i dalje odlučuje šta korisnik sme da uradi, koji su podaci merodavni, koje akcije zahtevaju odobrenje i kako se rezultati validiraju.

Šta bi promenilo ovaj odgovor?

Preporuka se menja ako Agents API doda ili ukloni mogućnosti, izađe iz beta verzije sa drugačijim ugovorima, promeni granice okruženja ili cene, ili uvede alate za migraciju koji smanjuju razlike u vlasništvu. Takođe se menja ako vaša aplikacija zavisi od prenosivosti među provajderima, prilagođene semantike orkestracije, isključivo lokalnog izvršavanja ili mogućnosti koju hostovani okvir ne može da podrži.

Za postojeću aplikaciju zasnovanu na Agents SDK-u, odgovor se takođe menja sa troškovima migracije. Ako je sistem stabilan, dobro evaluiran i nije blokiran statusom SDK-a koji označava završetak razvoja novih funkcija, trenutna migracija može stvoriti više rizika nego vrednosti. Ako plan razvoja proizvoda zavisi od mogućnosti koje dolaze isključivo u Agents API, odlaganje migracije može stvoriti drugačiju vrstu tehničkog duga.

Ograničenja

Ovo poređenje se fokusira na vlasništvo nad izvršnim okruženjem i navedeni pravac platforme kompanije OpenAI. Ono ne meri kašnjenje, kvalitet ili ukupne troškove za specifično radno opterećenje. Ta svojstva zavise od izbora modela, korišćenja alata, okruženja, dužine zadatka, keširanja, upotrebe sandbox okruženja i arhitekture aplikacije.

Agents API je takođe dovoljno nov da se produkciono iskustvo još uvek prikuplja. Zbog toga bi dizajn trebalo validirati reprezentativnim radnim opterećenjima, a ne birati ga isključivo na osnovu pozicioniranja proizvoda.

Zaključak

Odluka o OpenAI agentima za 2026. godinu u osnovi se svodi na vlasništvo nad runtime-om. Agents API znači da OpenAI poseduje veći deo harness-a i mehanizama za trajne sesije. Responses znači da vaša aplikacija poseduje petlju oko primitivnih elemenata platforme. Agents SDK ostaje validan za postojeće sisteme, ali više nije podrazumevano odredište za važne nove funkcije agent runtime-a.

Za novu aplikaciju, pratite smer platforme osim ako vas stvarni zahtev ne natera da se spustite niže u steku. Počnite sa Agents API-jem, pređite na Responses kada vam je potrebno da sami kontrolišete petlju, razmotrite Codex SDK kada vam je potreban harness u sopstvenoj infrastrukturi, i zadržite Agents SDK tamo gde to opravdavaju postojeća ulaganja ili privremeni nedostaci u mogućnostima.

Česta pitanja

Rečnik pojmova

Primarni izvori i dodatna literatura