Edisi Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Menyiapkan tugas browser Agents API dengan penggunaan komputer OpenAI

> Panduan berbasis dokumentasi untuk membuat sesi browser OpenAI Agents API, menangani permintaan asal situs web, memeriksa hasil, lalu menghapus sesi.

By BIG CHANGE Editorial

Published: 2026-09-30T01:36:49.389Z
Updated: 2026-09-30T01:36:49.389Z
Canonical: https://bigchange.ai/blog/openai-agents-api-computer-use-browser-guide

![Conceptual illustration of a developer viewing a generic public webpage on one desktop display and three browser activity images on another.](https://bigchange.ai/api/media/file/agents-computer-use-browser-review-hero-v1.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

Pada 29 September, dalam [rangkuman DevDay](https://openai.com/index/devday-2026-recap/) OpenAI mengumumkan penggunaan komputer di Agents API. [Panduan peluncuran DevDay](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide) 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](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) 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](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites) 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](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in) 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](https://openai.com/index/devday-2026-recap/) 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](https://developers.openai.com/api/docs/guides/agents-api/overview), penggunaan model ditagihkan sesuai [tarif API](https://developers.openai.com/api/docs/pricing) model yang dipilih, sedangkan sandbox yang dihosting OpenAI menggunakan [tarif kontainer](https://developers.openai.com/api/docs/pricing#built-in-tools) 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”](https://developers.openai.com/api/docs/guides/agents-api/tools/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”](https://developers.openai.com/api/docs/guides/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”](https://developers.openai.com/api/docs/guides/agents-api/overview) dan [“OpenAI-hosted sandboxes”](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted), diakses 30 September 2026. Menjelaskan model sesi dan pemisahan biaya model serta kontainer yang dihosting. Kedua halaman tidak mencantumkan tanggal publikasi.
- [Harga OpenAI API](https://developers.openai.com/api/docs/pricing), 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”](https://openai.com/index/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.

## Sources

- [Computer use | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) — Rujukan utama tugas browser untuk lingkungan yang dihosting, nama peristiwa dan persetujuan, verifikasi hasil, aktivitas, tangkapan layar, dan penghapusan. Ini dokumentasi, bukan pengujian BIG CHANGE.
- [Agents API quickstart | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/quickstart) — Izin kunci aplikasi Platform, penyiapan SDK, header beta, dan siklus hidup sesi. Contoh pemrograman umum berbeda dari panduan penggunaan komputer.
- [Agents API | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/overview) — Mendokumentasikan model sesi terkelola serta biaya terpisah untuk penggunaan model, alat OpenAI, dan sandbox yang dihosting.
- [OpenAI-hosted sandboxes | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — Mengonfirmasi tarif kontainer standar untuk sandbox yang dihosting OpenAI, penagihan model terpisah, dan penghapusan untuk meminta pembersihan lingkungan.
- [Pricing | OpenAI API](https://developers.openai.com/api/docs/pricing) — Tarif model dan kontainer terkini. Halaman yang ditinjau tidak menyebut biaya terpisah untuk alat penggunaan komputer; tidak ada perkiraan biaya per proses.
- [DevDay 2026 Recap | OpenAI](https://openai.com/index/devday-2026-recap/) — Pengumuman vendor tentang penggunaan komputer Agents API dan ketersediaan terpisah melalui API serta paket Pro 500 dan Enterprise Codex/ChatGPT Work.