Pregled

Vmesnik Agents API je na voljo v različici beta. Razvijalcem omogoča izdelavo aplikacij z agentom Codex, ki ga upravlja OpenAI in ki lahko opravlja delo v več korakih ter nadaljuje v isti seji.

Vaša aplikacija zagotovi nalogo, orodja in konfiguracijo. OpenAI upravlja agentovo sejo ter usklajuje delovanje njegovega modela in orodij.

Kaj lahko počne agent?

Glede na svoja orodja in izvajalno okolje lahko agent izvaja kodo, ureja datoteke, uporablja povezave MCP in ustvarja datoteke za vašo aplikacijo. V isti seji lahko pošljete dodatna navodila ali nadaljujete z drugo nalogo.

Podprte zmožnosti in primere najdete v pregledu vmesnika Agents API.

Kako začnem?

1. V svojem projektu na platformi OpenAI ustvarite ključ API za aplikacijo. Dodelite dovoljenji api.agents.read in api.agents.write za seje ter api.responses.write za zahteve za model.

2. Sledite vodniku za hiter začetek, da konfigurirate agenta, ustvarite sejo in pošljete nalogo.

3. Spremljajte dogodke v seji, da preverite napredek in rezultate. Če želite nadaljevati delo, shranite ID seje.

Ključ API hranite zunaj agentovega peskovnika. Zahteve potrebujejo glavo OpenAI-Beta: agents=v1. Razvojni kompleti SDK OpenAI to glavo dodajo samodejno.

Ali moj agent potrebuje peskovnik?

Izberite okolje, ki ustreza nalogi:

• Brez okolja: Agent odgovarja na vprašanja ali uporablja zunanja orodja, ne da bi potreboval vgrajene ukaze lupine ali datoteke delovnega prostora.

• Pesковnik, ki ga gosti OpenAI: Agent mora izvajati skripte ali delati z datotekami, vi pa želite, da njegov peskovnik upravlja OpenAI.

• Pesковnik, ki ga gostite sami: Potrebujete lastno infrastrukturo, programsko opremo ali zasebno omrežje. Vaša aplikacija upravlja življenjski cikel okolja.

Podrobnosti o konfiguraciji najdete v opisu arhitekture vmesnika Agents API.

Kje lahko pregledam sejo?

Odprite Dnevnike na nadzorni plošči platforme, izberite Agenti in poiščite ID seje. Pregledate lahko izmenjave, klice orodij in dejavnost podagentov.

Vodnik za spremljanje delovanja pojasnjuje tudi, kako pregledati zabeleženo porabo žetonov.

Kaj storiti, če se povezava s tokom dogodkov prekine?

Pred ponovnim poskusom pridobite obstoječo sejo in njene shranjene elemente. Tako lahko preverite, kaj se je zgodilo, preden pošljete dodatne naloge.

Zaključena izmenjava ne pomeni, da so bila vsa orodja uspešna. Preglejte sporočeni rezultat. Samo to, da seja miruje, še ne potrjuje, da je bila naloga uspešno zaključena.

Kako se obračunava poraba?

Zahteve za model se obračunavajo po cenah API-ja za izbrani model. Za orodja OpenAI in peskovnike, ki jih gosti OpenAI, veljajo ustrezne cene orodij in vsebnikov.

Trenutne cene najdete v ceniku API-ja.

Kako se ravna s podatki sej in datotekami?

Vmesnik Agents API hrani stanje seje, tako da se delo lahko nadaljuje skozi več izmenjav. Seje in objavljene artefakte lahko izbrišete, ko jih ne potrebujete več. Preden izbrišete sejo, shranite vse datoteke, ki jih potrebujete.

Vmesnik Agents API trenutno podpira lokalno hrambo podatkov samo v Združenih državah Amerike. Ničelne hrambe podatkov ne podpira, niti pri uporabi peskovnika, ki ga gostite sami. Podrobnosti o nadzoru nad podatki najdete v dokumentaciji vmesnika Agents API.