Pregled

Agents API je dostupan u beta verziji. Omogućava programerima da razvijaju aplikacije s agentom Codex kojim upravlja OpenAI i koji može raditi u više koraka te nastaviti rad u istoj sesiji.

Vaša aplikacija dostavlja zadatak, alate i konfiguraciju. OpenAI upravlja sesijom agenta i koordinacijom između njegovog modela i alata.

Šta agent može raditi?

Zavisno od alata i okruženja za izvršavanje, agent može pokretati kôd, uređivati datoteke, koristiti MCP veze i kreirati datoteke za vašu aplikaciju. Možete poslati dodatne upute ili nastaviti s drugim zadatkom u istoj sesiji.

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

Kako da počnem?

1. Kreirajte API ključ za aplikaciju u svom 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. Pratite vodič za brzi početak da biste konfigurirali agenta, kreirali sesiju i poslali zadatak.

3. Pratite događaje u sesiji da biste vidjeli napredak i rezultate. Sačuvajte ID sesije ako želite nastaviti rad.

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

Treba li mom agentu izolirano okruženje?

Odaberite okruženje koje odgovara zadatku:

• Bez okruženja: Agent odgovara na pitanja ili koristi vanjske alate bez potrebe za ugrađenim komandama ljuske ili datotekama radnog prostora.

• Izolirano okruženje koje hostuje OpenAI: Agent treba pokretati skripte ili raditi s datotekama, a vi želite da OpenAI upravlja njegovim izoliranim okruženjem.

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

Detalje o konfiguraciji pogledajte u arhitekturi Agents API-ja.

Gdje mogu pregledati sesiju?

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

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

Šta ako se prekine tok događaja?

Prije ponovnog pokušaja dohvatite postojeću sesiju i njene sačuvane stavke. Tako možete provjeriti šta se dogodilo prije nego što pošaljete dodatne zadatke.

Završen ciklus ne znači da je svaki alat uspješno izvršen. Pregledajte prijavljeni rezultat. Samo to što sesija miruje ne potvrđuje da je zadatak uspješno završen.

Kako se naplaćuje korištenje?

Zahtjevi upućeni modelu naplaćuju se prema API cjenovniku odabranog modela. Za alate kompanije OpenAI i izolirana okruženja koja ona hostuje primjenjuju se odgovarajuće cijene alata i kontejnera.

Aktuelne cijene pogledajte u API cjenovniku.

Kako se postupa s podacima sesije i datotekama?

Agents API zadržava stanje sesije kako bi se rad mogao nastaviti kroz više ciklusa. Sesije i objavljene artefakte možete izbrisati kada vam više nisu potrebni. Prije brisanja sesije sačuvajte sve datoteke koje su vam potrebne.

Agents API trenutno podržava rezidentnost podataka samo u Sjedinjenim Američkim Državama. Ne podržava način rada bez zadržavanja podataka, čak ni kada koristite izolirano okruženje koje sami hostujete. Detalje o kontrolama podataka pogledajte u dokumentaciji za Agents API.