Ülevaade

Agents API on saadaval beetaversioonina. See võimaldab arendajatel luua rakendusi OpenAI hallatava Codexi agendiga, mis suudab teha mitmeetapilist tööd ja jätkata samas seansis.

Sinu rakendus annab ülesande, tööriistad ja seadistuse. OpenAI haldab agendi seanssi ning koordineerib mudeli ja tööriistade koostööd.

Mida agent teha saab?

Olenevalt tööriistadest ja käivituskeskkonnast saab agent käivitada koodi, muuta faile, kasutada MCP-ühendusi ja luua sinu rakenduse jaoks faile. Saad saata lisajuhiseid või jätkata samas seansis teise ülesandega.

Toetatud võimalused ja näited leiad Agents API ülevaatest.

Kuidas alustada?

1. Loo oma OpenAI platvormi projektis rakenduse API-võti. Anna seansside jaoks õigused api.agents.read ja api.agents.write ning mudelipäringute jaoks api.responses.write.

2. Järgi kiirjuhendit, et seadistada agent, luua seanss ja saata ülesanne.

3. Edenemise ja tulemuste vaatamiseks jälgi seansi sündmusi. Kui soovid tööd jätkata, salvesta seansi ID.

Hoia oma API-võtit väljaspool agendi liivakasti. Päringud nõuavad päist OpenAI-Beta: agents=v1. OpenAI SDK-d lisavad selle päise automaatselt.

Kas minu agent vajab liivakasti?

Vali ülesandele sobiv keskkond:

• Ilma keskkonnata: agent vastab küsimustele või kasutab väliseid tööriistu ega vaja sisseehitatud kestakäske ega tööruumi faile.

• OpenAI majutatud liivakast: agent peab käivitama skripte või töötama failidega ning soovid, et OpenAI haldaks tema liivakasti.

• Enda majutatud liivakast: vajad oma taristut, tarkvara või privaatvõrku. Keskkonna elutsüklit haldab sinu rakendus.

Seadistamise üksikasjad leiad Agents API arhitektuuri juhendist.

Kust saan seansi üle vaadata?

Ava platvormi juhtpaneelil logid, vali Agendid ja otsi seansi ID-d. Saad vaadata voore, tööriistakutseid ja alamagentide tegevust.

Jälgitavuse juhend selgitab ka seda, kuidas vaadata registreeritud tokenikasutust.

Mis saab siis, kui sündmusvoo ühendus katkeb?

Enne uuesti proovimist hangi olemasolev seanss ja selle salvestatud üksused. Nii saad enne uute tööülesannete saatmist kontrollida, mis toimus.

Vooru lõppemine ei tähenda, et kõigi tööriistade töö õnnestus. Vaata tagastatud tulemus üle. Ainuüksi seansi jõudeolek ei kinnita, et ülesanne on edukalt lõpetatud.

Kuidas kasutuse eest tasu arvestatakse?

Mudelipäringutele kehtivad valitud mudeli API hinnad. OpenAI tööriistadele ja OpenAI majutatud liivakastidele kehtivad vastavad tööriista- ja konteinerihinnad.

Kehtivad hinnad leiad API hinnakirjast.

Kuidas seansi andmeid ja faile käideldakse?

Agents API säilitab seansi oleku, et tööd saaks jätkata järgmistes voorudes. Saad seansid ja avaldatud artefaktid kustutada, kui neid enam vaja pole. Salvesta vajalikud failid enne seansi kustutamist.

Agents API toetab praegu andmete asukohanõudeid ainult Ameerika Ühendriikides. See ei toeta sätet „andmeid ei säilitata“, ka siis, kui kasutad enda majutatud liivakasti. Andmehalduse üksikasjad leiad Agents API dokumentatsioonist.