Apžvalga

Prieinama „Agents API“ beta versija. Ji leidžia kūrėjams kurti programas su „OpenAI“ valdomu „Codex“ agentu, kuris gali atlikti kelių žingsnių užduotis ir tęsti darbą tame pačiame seanse.

Jūsų programa pateikia užduotį, įrankius ir konfigūraciją. „OpenAI“ valdo agento seansą ir koordinuoja jo modelio bei įrankių sąveiką.

Ką gali daryti agentas?

Priklausomai nuo turimų įrankių ir vykdymo aplinkos, agentas gali vykdyti kodą, redaguoti failus, naudoti MCP ryšius ir kurti failus jūsų programai. Tame pačiame seanse galite siųsti papildomas instrukcijas arba tęsti darbą su kita užduotimi.

Palaikomas galimybes ir pavyzdžius rasite „Agents API“ apžvalgoje.

Kaip pradėti?

1. Savo projekte „OpenAI“ platformoje sukurkite programos API raktą. Suteikite api.agents.read ir api.agents.write teises seansams bei api.responses.write teisę modelio užklausoms.

2. Vadovaudamiesi trumpuoju pradžios vadovu, sukonfigūruokite agentą, sukurkite seansą ir pateikite užduotį.

3. Stebėkite seanso įvykius, kad galėtumėte įvertinti eigą ir rezultatus. Jei norite tęsti darbą, išsaugokite seanso ID.

API raktą laikykite už agento izoliuotos aplinkos ribų. Užklausoms būtina antraštė OpenAI-Beta: agents=v1. „OpenAI“ SDK šią antraštę prideda automatiškai.

Ar mano agentui reikia izoliuotos aplinkos?

Pasirinkite užduočiai tinkamą aplinką:

• Be aplinkos: agentas atsako į klausimus arba naudoja išorinius įrankius, jam nereikia integruotų komandų interpretatoriaus komandų ar darbo erdvės failų.

• Izoliuota aplinka „OpenAI“ infrastruktūroje: agentui reikia vykdyti scenarijus arba dirbti su failais, o jūs norite, kad jo izoliuotą aplinką valdytų „OpenAI“.

• Izoliuota aplinka jūsų infrastruktūroje: jums reikia savo infrastruktūros, programinės įrangos arba privataus tinklo. Aplinkos gyvavimo ciklą valdo jūsų programa.

Išsamesnės informacijos apie konfigūravimą rasite „Agents API“ architektūros apraše.

Kur galiu peržiūrėti seansą?

Atidarykite žurnalus platformos valdymo skydelyje, pasirinkite Agentai ir ieškokite pagal seanso ID. Galite peržiūrėti žingsnius, įrankių iškvietimus ir pagalbinių agentų veiklą.

Stebėsenos vadove taip pat paaiškinta, kaip peržiūrėti užfiksuotas žetonų sąnaudas.

Ką daryti, jei nutrūksta įvykių srautas?

Prieš bandydami dar kartą, gaukite esamą seansą ir išsaugotus jo elementus. Tai padės patikrinti, kas įvyko, prieš pateikiant daugiau užduočių.

Užbaigtas žingsnis nereiškia, kad visi įrankiai suveikė sėkmingai. Peržiūrėkite pateiktą rezultatą. Vien tai, kad seansas yra neveiklus, nepatvirtina, jog užduotis sėkmingai atlikta.

Kaip apmokestinamas naudojimas?

Modelio užklausoms taikomi pasirinkto modelio API įkainiai. „OpenAI“ įrankiams ir „OpenAI“ infrastruktūroje veikiančioms izoliuotoms aplinkoms taikomi atitinkami įrankių ir konteinerių įkainiai.

Dabartinius įkainius rasite API kainodaros puslapyje.

Kaip tvarkomi seanso duomenys ir failai?

„Agents API“ išsaugo seanso būseną, kad darbą būtų galima tęsti kitais žingsniais. Seansus ir paskelbtus artefaktus galite ištrinti, kai jų nebereikia. Prieš ištrindami seansą, išsaugokite visus reikalingus failus.

Šiuo metu vienintelė „Agents API“ palaikoma duomenų saugojimo vieta yra Jungtinės Amerikos Valstijos. Nulinis duomenų saugojimas nepalaikomas, net jei naudojate savo infrastruktūroje veikiančią izoliuotą aplinką. Išsamesnės informacijos apie duomenų valdymą rasite „Agents API“ dokumentacijoje.