Pregled

Agents API dostupan je u beta-verziji. Razvojnim programerima omogućuje izradu aplikacija s agentom Codex kojim upravlja OpenAI, a koji može raditi u više koraka i nastavljati rad u istoj sesiji.

Vaša aplikacija dostavlja zadatak, alate i konfiguraciju. OpenAI upravlja sesijom agenta i koordinacijom njegova modela i alata.

Što agent može raditi?

Ovisno o svojim alatima i izvršnom okruženju, agent može izvršavati kod, uređivati datoteke, upotrebljavati MCP veze i izrađivati datoteke za vašu aplikaciju. Možete poslati dodatne upute ili nastaviti s drugim zadatkom u istoj sesiji.

Podržane mogućnosti i primjere potražite u pregledu API-ja Agents.

Kako započeti?

1. Izradite API ključ za aplikaciju u svojem projektu na platformi OpenAI. Dodijelite dozvole api.agents.read i api.agents.write za sesije te api.responses.write za zahtjeve upućene modelu.

2. Slijedite vodič za brzi početak kako biste konfigurirali agenta, izradili sesiju i poslali zadatak.

3. Pratite događaje u sesiji kako biste pregledali napredak i rezultate. Spremite ID sesije ako želite nastaviti rad.

API ključ čuvajte izvan izoliranog okruženja agenta. Zahtjevi moraju sadržavati zaglavlje OpenAI-Beta: agents=v1. SDK-ovi tvrtke OpenAI automatski dodaju to zaglavlje.

Treba li mojem agentu izolirano okruženje?

Odaberite okruženje koje odgovara zadatku:

• Bez okruženja: Agent odgovara na pitanja ili upotrebljava vanjske alate, a pritom mu nisu potrebne ugrađene naredbe ljuske ni datoteke radnog prostora.

• Izolirano okruženje na infrastrukturi tvrtke OpenAI: Agent treba izvršavati skripte ili raditi s datotekama, a vi želite da OpenAI upravlja njegovim izoliranim okruženjem.

• Izolirano okruženje na vlastitoj infrastrukturi: Potrebna vam je vlastita infrastruktura, softver ili privatna mreža. Vaša aplikacija upravlja životnim ciklusom okruženja.

Pojedinosti o konfiguraciji potražite u arhitekturi API-ja Agents.

Gdje mogu pregledati sesiju?

Otvorite Zapisnike na nadzornoj ploči platforme, odaberite Agenti i potražite ID sesije. Možete pregledati korake interakcije, pozive alata i aktivnosti podagenata.

U vodiču za praćenje rada objašnjeno je i kako pregledati zabilježenu potrošnju tokena.

Što ako se prekine tok događaja?

Prije ponovnog pokušaja dohvatite postojeću sesiju i njezine spremljene stavke. Tako možete provjeriti što se dogodilo prije nego što pošaljete dodatne zadatke.

Dovršen korak interakcije ne znači da je svaki alat uspješno obavio svoj posao. Pregledajte prijavljeni rezultat. Sama činjenica da sesija miruje ne potvrđuje da je zadatak uspješno dovršen.

Kako se naplaćuje korištenje?

Zahtjevi upućeni modelu naplaćuju se prema cijenama API-ja za odabrani model. Alati tvrtke OpenAI i izolirana okruženja smještena na njezinoj infrastrukturi naplaćuju se prema odgovarajućim cijenama alata i kontejnera.

Aktualne cijene potražite u cjeniku API-ja.

Kako se postupa s podacima i datotekama sesije?

Agents API zadržava stanje sesije kako bi se rad mogao nastaviti kroz više koraka interakcije. Sesije i objavljene artefakte možete izbrisati kad vam više nisu potrebni. Prije brisanja sesije spremite sve datoteke koje su vam potrebne.

Agents API trenutačno podržava rezidentnost podataka samo u Sjedinjenim Američkim Državama. Ne podržava način rada bez zadržavanja podataka, čak ni kada upotrebljavate izolirano okruženje na vlastitoj infrastrukturi. Pojedinosti o kontrolama podataka potražite u dokumentaciji API-ja Agents.