Menyiapkan tugas browser Agents API dengan penggunaan komputer OpenAI

Pada 29 September, dalam rangkuman DevDay OpenAI mengumumkan penggunaan komputer di Agents API. Panduan peluncuran DevDay kami membahas peluncuran yang lebih luas. Bagi pengembang, tugas langsungnya lebih terbatas daripada agen browser umum: membuka halaman publik, mengambil jawaban tertentu, dan mencatat apa yang diakses browser. Panduan penggunaan komputer OpenAI yang diperiksa pada 30 September menjelaskan alur ini melalui sesi browser yang dihosting. BIG CHANGE telah meninjau dokumentasinya, bukan menjalankan API.

Aplikasi membuat sesi, mengirim masukan, mengikuti peristiwa, menampilkan permintaan asal situs web kepada pengguna, memeriksa jawaban, lalu membersihkan sesi. Agen dapat mengoperasikan browser di dalam lingkungan yang dihosting. Selesainya satu giliran tidak membuktikan bahwa informasi yang diminta benar.

Perubahan besar

Jalur penggunaan komputer baru di OpenAI Agents API memberi pengembang sesi browser yang dihosting, aliran peristiwa, keputusan pengguna tentang asal situs web, catatan aktivitas browser, dan pembersihan melalui API. Untuk tugas terbatas di halaman publik, integrasi praktisnya adalah menangani setiap tahap secara eksplisit dan memverifikasi judul serta URL yang dikembalikan. Akses ke suatu asal, selesainya giliran, dan ketepatan jawaban adalah tiga pengamatan yang berbeda.

Mulai dengan kunci API dan sesi browser

OpenAI panduan mulai cepat Agents API meminta kunci API aplikasi di proyek OpenAI Platform. Panduan itu menetapkan api.agents.read dan api.agents.write untuk operasi sesi, serta api.responses.write untuk inferensi model. Ekspor kunci sebagai OPENAI_API_KEY di lingkungan aplikasi dan simpan di luar sandbox agen. Gunakan OpenAI SDK terkini dengan Agents API beta; panduan JavaScript di panduan penggunaan komputer memakai openai dan prompt-sync. Alternatif cURL memerlukan Bash, jq dan header eksplisit OpenAI-Beta: agents=v1.

Konfigurasi sesi yang didokumentasikan menempatkan { "type": "computer_use" } di dalam agent.tools, menetapkan environment.type ke openai_hosted, dan mengaktifkan environment.desktop.enabled. Contoh halaman publik juga mengaktifkan akses jaringan dan menetapkan include_screenshots: true pada alat. Pembuatan sesi mengembalikan ID untuk permintaan peristiwa dan item berikutnya; tindakan itu tidak memulai tugas browser. Simpan ID sebelum melanjutkan. Contoh dalam panduan meminta agen menemukan halaman mulai cepat Agents API dan mengembalikan judul serta URL-nya, tanpa masuk atau mengubah data situs.

Ikuti tugas dan tentukan situs yang boleh diakses

Buka aliran peristiwa sesi sebelum mengirim masukan tugas agar aplikasi dapat menerima peristiwa awal. Masukan yang didokumentasikan adalah agent.session.input.message. Saat aliran melaporkan agent.session.requires_action, ambil required_actions sesi saat ini dan temukan catatan computer_use_approval_request yang masih tertunda. Untuk permintaan browser_origin_access, tampilkan asal yang diminta dan alasan yang dicantumkan kepada pengguna. Kirim keputusan pengguna berupa approve, deny, atau cancel sebagai agent.session.input.computer_use_approval_request_result dengan request_id yang cocok.

Keputusan itu menyangkut akses ke asal situs web, termasuk situs publik. Menetapkan network.access ke enabled tidak memberikan persetujuan. Persetujuan asal juga tidak mengonfirmasi setiap tindakan browser berikutnya. OpenAI menyarankan aplikasi yang memerlukan konfirmasi pasti sebelum pembelian atau perubahan destruktif agar membatasi browser yang dihosting ke sumber daya yang tidak dapat melakukan tindakan tersebut, atau menggunakan runtime browser yang mereka kendalikan. Teks situs web adalah masukan yang tidak tepercaya dan tidak dapat mengizinkan akses atau mengesampingkan instruksi pengguna.

Panduan halaman publik membatalkan permintaan browser_authentication yang terpisah. Tugas yang memerlukan akun memiliki alur masuk tersendiri; penyiapan hanya-baca ini tidak membahasnya. OpenAI juga mencatat bahwa membatalkan permintaan persetujuan tidak membatalkan tugas. Respons persetujuan yang diterima berarti keputusan telah diterima, bukan berarti navigasi sudah selesai.

Periksa hasil, tinjau aktivitas, lalu hapus sesi

Aliran peristiwa dapat memberikan teks jawaban di agent.session.turn.output_text.done. Tunggu agent.session.turn.completed untuk giliran utama, dan tangani peristiwa kegagalan serta pembatalan secara terpisah. Untuk tugas yang didokumentasikan, periksa apakah jawaban benar-benar memuat judul dan URL halaman mulai cepat. Aliran yang tertutup saja tidak membuktikan bahwa giliran telah berakhir; OpenAI menyarankan pengembang memulihkan sesi yang sama setelah koneksi terputus atau hasilnya tidak pasti.

Item sesi memberikan sudut pandang lain atas pekerjaan browser. Item computer_use_call mencakup judul aktivitas, ID giliran, dan status. Jika tangkapan layar diaktifkan, suatu item mungkin memuat URL gambar computer_screenshot; beberapa operasi tetap tidak menghasilkan gambar. Item tersebut menunjukkan operasi browser, bukan keputusan akhir atas tugas. Tinjau item yang tersimpan dan hasil atau tangkapan layar yang diperlukan aplikasi sebelum menghapus sesi untuk meminta pembersihan lingkungan. Tangkapan layar dapat berisi informasi sensitif tentang halaman atau akun, sehingga dokumentasi menyarankan agar akses dibatasi kepada pihak berwenang dan isinya tidak dimasukkan ke log aplikasi.

Akses dan biaya adalah keputusan yang terpisah

Dalam rangkuman DevDay OpenAI menyatakan bahwa penggunaan komputer tersedia melalui API serta di Codex dan ChatGPT Work pada paket Pro 500 dan Enterprise. Panduan ini membahas jalur API yang memerlukan kredensial dan izin Platform. Pernyataan tentang paket produk tidak memberikan akses API atau mencakup biaya penggunaan API.

Menurut ikhtisar Agents API, penggunaan model ditagihkan sesuai tarif API model yang dipilih, sedangkan sandbox yang dihosting OpenAI menggunakan tarif kontainer standar. Halaman yang ditinjau tidak menyebut biaya terpisah untuk alat penggunaan komputer; itu bukan berarti sesi browser yang dihosting gratis. Periksa harga model dan kontainer terkini sebelum menyusun anggaran. Contoh menggunakan metode API beta yang dapat berubah. Tidak ada sesi API, tugas browser, atau SDK yang dijalankan untuk artikel ini.

Sumber dan bacaan lanjutan

• OpenAI, “Computer use”, diakses 30 September 2026. Rujukan utama untuk konfigurasi browser, nama peristiwa, permintaan asal dan autentikasi, pemeriksaan hasil, aktivitas, dan penghapusan. Halaman tersebut tidak menampilkan tanggal publikasi.
• OpenAI, “Agents API quickstart”, diakses 30 September 2026. Menetapkan izin kunci Platform, header beta, dan prasyarat SDK; contoh pemrograman umumnya berbeda dari panduan penggunaan komputer.
• OpenAI, “Agents API” dan “OpenAI-hosted sandboxes”, diakses 30 September 2026. Menjelaskan model sesi dan pemisahan biaya model serta kontainer yang dihosting. Kedua halaman tidak mencantumkan tanggal publikasi.
• Harga OpenAI API, diakses 30 September 2026. Tarif model yang dipilih dan kontainer yang dihosting perlu diperiksa; tidak ada perkiraan biaya untuk satu kali proses di sini.
• OpenAI, “DevDay 2026 Recap”, diterbitkan 29 September 2026. Sumber untuk peluncuran dan pernyataan terpisah OpenAI tentang ketersediaan melalui API serta paket Pro 500 dan Enterprise Codex/ChatGPT Work.