Ringkasan

Agents API tersedia dalam versi beta. API ini memungkinkan pengembang membangun aplikasi dengan agen Codex yang dikelola OpenAI, yang dapat mengerjakan berbagai langkah dan melanjutkan pekerjaan dalam sesi yang sama.

Aplikasi Anda menyediakan tugas, alat, dan konfigurasi. OpenAI mengelola sesi agen dan koordinasi antara model dan alatnya.

Apa yang bisa dilakukan agen?

Bergantung pada alat dan lingkungan eksekusinya, agen dapat menjalankan kode, mengedit file, menggunakan koneksi MCP, dan menghasilkan file untuk aplikasi Anda. Anda dapat mengirim instruksi tambahan atau melanjutkan dengan tugas lain dalam sesi yang sama.

Lihat ringkasan Agents API untuk mengetahui kemampuan yang didukung beserta contohnya.

Bagaimana cara memulai?

1. Buat kunci API aplikasi di proyek OpenAI Platform Anda. Berikan izin api.agents.read dan api.agents.write untuk sesi, serta api.responses.write untuk permintaan ke model.

2. Ikuti panduan mulai cepat untuk mengonfigurasi agen, membuat sesi, dan mengirimkan tugas.

3. Pantau peristiwa dalam sesi untuk meninjau kemajuan dan hasil. Simpan ID sesi jika Anda ingin melanjutkan pekerjaan.

Simpan kunci API Anda di luar sandbox agen. Permintaan memerlukan header OpenAI-Beta: agents=v1. SDK OpenAI menambahkan header ini secara otomatis.

Apakah agen saya memerlukan sandbox?

Pilih lingkungan yang sesuai dengan tugas:

• Tanpa lingkungan: Agen menjawab pertanyaan atau menggunakan alat eksternal tanpa memerlukan perintah shell bawaan atau file ruang kerja.

• Sandbox yang dihosting oleh OpenAI: Agen perlu menjalankan skrip atau bekerja dengan file, dan Anda ingin OpenAI mengelola sandbox-nya.

• Sandbox yang dihosting sendiri: Anda memerlukan infrastruktur, perangkat lunak, atau jaringan privat milik sendiri. Aplikasi Anda mengelola siklus hidup lingkungan tersebut.

Lihat arsitektur Agents API untuk detail konfigurasi.

Di mana saya bisa meninjau sesi?

Buka Log di dasbor Platform, pilih Agen, lalu cari ID sesi. Anda dapat memeriksa giliran, pemanggilan alat, dan aktivitas subagen.

Panduan observabilitas juga menjelaskan cara meninjau penggunaan token yang tercatat.

Bagaimana jika koneksi aliran peristiwa terputus?

Ambil sesi yang ada beserta item-item yang tersimpan di dalamnya sebelum mencoba lagi. Ini membantu Anda memeriksa apa yang terjadi sebelum mengirimkan pekerjaan tambahan.

Giliran yang selesai tidak berarti semua alat berhasil dijalankan. Tinjau hasil yang dilaporkan. Sesi yang sedang tidak aktif saja belum membuktikan bahwa tugas berhasil diselesaikan.

Bagaimana biaya penggunaan dihitung?

Permintaan ke model dikenai tarif API untuk model yang dipilih. Alat OpenAI dan sandbox yang dihosting oleh OpenAI dikenai tarif alat dan kontainer yang berlaku.

Lihat harga API untuk tarif terbaru.

Bagaimana data sesi dan file ditangani?

Agents API menyimpan status sesi agar pekerjaan dapat dilanjutkan dari satu giliran ke giliran berikutnya. Anda dapat menghapus sesi dan artefak yang telah dipublikasikan ketika tidak lagi diperlukan. Simpan semua file yang Anda perlukan sebelum menghapus sesi.

Agents API saat ini hanya mendukung residensi data di Amerika Serikat. API ini tidak mendukung retensi data nol, termasuk saat Anda menggunakan sandbox yang dihosting sendiri. Lihat dokumentasi Agents API untuk detail kontrol data.