OpenAI
Kaca iki diterjemahake nganggo mesin. Deleng artikel asli basa Inggris.

Pitakon Umum babagan Agents API (beta)

Miwiti nganggo sesi agen sing dikelola, lingkungan eksekusi, panggunaan, lan kontrol data.

Pembaruan: 16 days ago

Ringkesan

Agents API kasedhiya ing versi beta. Kanthi API iki, pangembang bisa nggawe aplikasi nganggo agen Codex sing dikelola dening OpenAI, sing bisa nggarap pirang-pirang langkah lan nerusake pakaryan ing sesi sing padha.

Aplikasi sampeyan nyedhiyakake tugas, alat, lan konfigurasi. OpenAI ngelola sesi agen lan koordinasi antarane model lan alate.

Apa wae sing bisa ditindakake agen?

Gumantung saka alat lan lingkungan eksekusine, agen bisa nglakokake kode, nyunting file, nggunakake sambungan MCP, lan ngasilake file kanggo aplikasi sampeyan. Sampeyan bisa ngirim instruksi tambahan utawa nerusake tugas liyane ing sesi sing padha.

Deleng ringkesan Agents API kanggo katrangan babagan kemampuan sing didhukung lan tuladha panggunaane.

Kepiye carane miwiti?

  1. Gawe kunci API aplikasi ing proyek OpenAI Platform sampeyan. Wenehana idin api.agents.read lan api.agents.write kanggo sesi, sarta api.responses.write kanggo panjaluk menyang model.

  2. Tindakake pandhuan miwiti cepet kanggo ngatur konfigurasi agen, nggawe sesi, lan ngirim tugas.

  3. Pantau prastawa ing sesi kanggo mriksa kemajuan lan asile. Simpen ID sesi yen sampeyan pengin nerusake pakaryan kasebut.

Simpen kunci API sampeyan ing njaba sandbox agen. Panjaluk mbutuhake header OpenAI-Beta: agents=v1. SDK OpenAI nambahake header iki kanthi otomatis.

Apa agenku butuh sandbox?

Pilih lingkungan sing cocog karo tugase:

  • Tanpa lingkungan: Agen mangsuli pitakon utawa nggunakake alat eksternal tanpa mbutuhake prentah shell bawaan utawa file papan kerja.

  • Sandbox sing di-host dening OpenAI: Agen kudu nglakokake skrip utawa ngolah file, lan sampeyan pengin OpenAI sing ngelola sandbox kasebut.

  • Sandbox sing di-host dhewe: Sampeyan butuh infrastruktur, piranti lunak, utawa jaringan pribadi dhewe. Aplikasi sampeyan sing ngelola siklus urip lingkungan kasebut.

Deleng arsitektur Agents API kanggo rincian konfigurasi.

Ing ngendi aku bisa mriksa sesi?

Bukak Log ing dasbor Platform, pilih Agen, banjur goleki ID sesi. Sampeyan bisa mriksa giliran, panggilan alat, lan aktivitas subagen.

Pandhuan observabilitas uga nerangake carane mriksa panggunaan token sing kacathet.

Kepiye yen sambungan aliran prastawa pedhot?

Jupuk sesi sing wis ana lan item sing kasimpen ing sesi kasebut sadurunge nyoba maneh. Iki mbantu sampeyan mriksa apa sing wis kedadeyan sadurunge ngirim tugas maneh.

Giliran sing wis rampung ora ateges saben alat kasil. Priksa asil sing dilapurake. Sesi sing lagi nganggur wae durung mbuktekake yen tugas wis rampung kanthi sukses.

Kepiye panggunaan ditagih?

Panjaluk menyang model dikenani tarif API model sing dipilih. Alat OpenAI lan sandbox sing di-host dening OpenAI dikenani tarif alat lan kontainer sing ditrapake.

Deleng rega API kanggo tarif saiki.

Kepiye data lan file sesi dikelola?

Agents API nyimpen status sesi supaya pakaryan bisa diterusake ing giliran sabanjure. Sampeyan bisa mbusak sesi lan artefak sing wis diterbitake yen wis ora dibutuhake maneh. Simpen kabeh file sing sampeyan butuhake sadurunge mbusak sesi.

Saiki Agents API mung ndhukung domisili data ing Amerika Serikat. Agents API ora ndhukung retensi data nol, kalebu nalika sampeyan nggunakake sandbox sing di-host dhewe. Deleng dokumentasi Agents API kanggo rincian kontrol data.

Apa artikel iki migunani kanggo sampeyan?