Gambaran keseluruhan

API Agents tersedia dalam versi beta. API ini membolehkan pembangun membina aplikasi dengan ejen Codex yang diurus oleh OpenAI, yang boleh melaksanakan kerja berbilang langkah dan meneruskannya dalam sesi yang sama.

Aplikasi anda menyediakan tugas, alat dan konfigurasi. OpenAI mengurus sesi ejen dan penyelarasan antara model dengan alatnya.

Apakah yang boleh dilakukan oleh ejen?

Bergantung pada alat dan persekitaran pelaksanaannya, ejen boleh menjalankan kod, menyunting fail, menggunakan sambungan MCP dan menghasilkan fail untuk aplikasi anda. Anda boleh menghantar arahan tambahan atau meneruskan tugas lain dalam sesi yang sama.

Lihat gambaran keseluruhan API Agents untuk keupayaan yang disokong dan contoh.

Bagaimanakah saya boleh bermula?

1. Cipta kunci API aplikasi dalam projek Platform OpenAI anda. Berikan kebenaran api.agents.read dan api.agents.write untuk sesi, serta api.responses.write untuk permintaan model.

2. Ikuti panduan mula pantas untuk mengkonfigurasi ejen, mencipta sesi dan menghantar tugas.

3. Ikuti peristiwa sesi untuk menyemak kemajuan dan hasil. Simpan ID sesi jika anda mahu meneruskan kerja tersebut.

Simpan kunci API anda di luar kotak pasir ejen. Permintaan memerlukan pengepala OpenAI-Beta: agents=v1. SDK OpenAI menambahkan pengepala ini secara automatik.

Adakah ejen saya memerlukan kotak pasir?

Pilih persekitaran yang sesuai dengan tugas:

• Tiada persekitaran: Ejen menjawab soalan atau menggunakan alat luaran tanpa memerlukan perintah shell terbina dalam atau fail ruang kerja.

• Kotak pasir yang dihoskan oleh OpenAI: Ejen perlu menjalankan skrip atau mengendalikan fail, dan anda mahu OpenAI mengurus kotak pasirnya.

• Kotak pasir yang dihoskan sendiri: Anda memerlukan infrastruktur, perisian atau rangkaian peribadi anda sendiri. Aplikasi anda mengurus kitar hayat persekitaran tersebut.

Lihat seni bina API Agents untuk butiran konfigurasi.

Di manakah saya boleh menyemak sesi?

Buka Log dalam papan pemuka Platform, pilih Ejen, kemudian cari ID sesi. Anda boleh memeriksa giliran, panggilan alat dan aktiviti subejen.

Panduan kebolehcerapan juga menerangkan cara menyemak penggunaan token yang direkodkan.

Bagaimana jika strim peristiwa terputus?

Dapatkan semula sesi sedia ada dan item yang disimpan dalamnya sebelum mencuba lagi. Ini membantu anda menyemak perkara yang berlaku sebelum menghantar lebih banyak kerja.

Giliran yang selesai tidak bermakna setiap alat berjaya. Semak hasil yang dilaporkan. Sesi yang melahu sahaja tidak membuktikan bahawa tugas telah berjaya diselesaikan.

Bagaimanakah penggunaan dibilkan?

Permintaan model dicaj mengikut kadar API model yang dipilih. Alat OpenAI dan kotak pasir yang dihoskan oleh OpenAI dicaj mengikut kadar alat dan bekas yang berkenaan.

Lihat harga API untuk kadar semasa.

Bagaimanakah data dan fail sesi dikendalikan?

API Agents mengekalkan keadaan sesi supaya kerja boleh diteruskan merentas giliran. Anda boleh memadam sesi dan artifak yang diterbitkan apabila tidak lagi diperlukan. Simpan sebarang fail yang anda perlukan sebelum memadam sesi.

API Agents pada masa ini menyokong lokasi data di Amerika Syarikat sahaja. API ini tidak menyokong pengekalan data sifar, termasuk apabila anda menggunakan kotak pasir yang dihoskan sendiri. Lihat dokumentasi API Agents untuk butiran kawalan data.