Pārskats

Agents API ir pieejams beta versijā. Tas ļauj izstrādātājiem veidot lietotnes ar OpenAI pārvaldītu Codex aģentu, kas spēj veikt darbu vairākos soļos un turpināt to tajā pašā sesijā.

Jūsu lietotne nodrošina uzdevumu, rīkus un konfigurāciju. OpenAI pārvalda aģenta sesiju un koordinē tā modeļa un rīku mijiedarbību.

Ko aģents spēj paveikt?

Atkarībā no pieejamajiem rīkiem un izpildes vides aģents var izpildīt kodu, rediģēt failus, izmantot MCP savienojumus un izveidot failus jūsu lietotnei. Varat nosūtīt papildu norādījumus vai turpināt ar citu uzdevumu tajā pašā sesijā.

Atbalstītās iespējas un piemērus skatiet Agents API pārskatā.

Kā sākt darbu?

1. Savā OpenAI platformas projektā izveidojiet lietotnes API atslēgu. Piešķiriet sesijām atļaujas api.agents.read un api.agents.write, bet modeļa pieprasījumiem — api.responses.write.

2. Izpildiet ātrās darba sākšanas pamācību, lai konfigurētu aģentu, izveidotu sesiju un iesniegtu uzdevumu.

3. Sekojiet sesijas notikumiem, lai pārskatītu darba gaitu un rezultātus. Saglabājiet sesijas ID, ja vēlaties turpināt darbu.

Glabājiet API atslēgu ārpus aģenta smilškastes. Pieprasījumiem ir nepieciešama galvene OpenAI-Beta: agents=v1. OpenAI SDK šo galveni pievieno automātiski.

Vai manam aģentam ir vajadzīga smilškaste?

Izvēlieties uzdevumam piemērotu vidi:

• Bez vides: aģents atbild uz jautājumiem vai izmanto ārējus rīkus, un tam nav vajadzīgas iebūvētas čaulas komandas vai darbvietas faili.

• OpenAI mitināta smilškaste: aģentam jāizpilda skripti vai jāstrādā ar failiem, un jūs vēlaties, lai tā smilškasti pārvaldītu OpenAI.

• Pašu mitināta smilškaste: jums ir vajadzīga sava infrastruktūra, programmatūra vai privāts tīkls. Vides dzīves ciklu pārvalda jūsu lietotne.

Plašāku informāciju par konfigurēšanu skatiet Agents API arhitektūras aprakstā.

Kur varu pārskatīt sesiju?

Atveriet žurnālus platformas informācijas panelī, atlasiet Aģenti un meklējiet sesijas ID. Varat pārskatīt sarunas kārtas, rīku izsaukumus un apakšaģentu darbības.

Novērojamības ceļvedī ir arī izskaidrots, kā pārskatīt reģistrēto tekstvienību lietojumu.

Ko darīt, ja notikumu straumes savienojums pārtrūkst?

Pirms mēģināt vēlreiz, izgūstiet esošo sesiju un tajā saglabātos vienumus. Tas ļauj pārbaudīt, kas noticis, pirms iesniedzat jaunus uzdevumus.

Pabeigta sarunas kārta nenozīmē, ka visi rīki ir veiksmīgi izpildījuši savas darbības. Pārskatiet ziņoto rezultātu. Tas vien, ka sesija ir dīkstāvē, neapliecina, ka uzdevums ir veiksmīgi pabeigts.

Kā tiek aprēķināta maksa par lietojumu?

Modeļa pieprasījumiem tiek piemēroti izvēlētā modeļa API tarifi. OpenAI rīkiem un OpenAI mitinātām smilškastēm tiek piemēroti attiecīgie rīku un konteineru tarifi.

Aktuālos tarifus skatiet API cenu lapā.

Kā tiek apstrādāti sesijas dati un faili?

Agents API saglabā sesijas stāvokli, lai darbu varētu turpināt nākamajās sarunas kārtās. Varat dzēst sesijas un publicētos artefaktus, kad tie vairs nav vajadzīgi. Pirms sesijas dzēšanas saglabājiet visus vajadzīgos failus.

Agents API pašlaik atbalsta datu rezidences vietu tikai Amerikas Savienotajās Valstīs. Tas neatbalsta nulles datu saglabāšanu, arī tad, ja izmantojat pašu mitinātu smilškasti. Plašāku informāciju par datu pārvaldību skatiet Agents API dokumentācijā.