Walse

Posted on Oct 2 Originally published at apidog.com

OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit: Mana yang Terbaik untuk Pengembangan

Keempat nama ini berada pada lapisan yang berbeda. Cara tercepat memilihnya adalah menjawab satu pertanyaan: siapa yang menjalankan agent loop? Responses API adalah panggilan model dan kode Anda menjalankan loop di sekitarnya. Agents SDK adalah pustaka TypeScript dan Python dengan runner yang mengeksekusi loop di aplikasi Anda. Agents API, dalam beta publik sejak 10 September 2026, menjalankan Codex harness OpenAI, mengelola sesi, dan secara opsional menyediakan sandbox. AgentKit adalah paket Oktober 2025 yang mencakup Agent Builder, ChatKit, Connector Registry, dan Evals; Agent Builder dijadwalkan dihentikan pada 30 November 2026.

Coba Apidog hari ini

DevDay pada 29 September menambahkan penggunaan komputer ke Agents API (lihat rangkuman DevDay 2026). Artinya, perbedaan penamaan ini semakin penting saat Anda menentukan arsitektur agen. Artikel ini membandingkan loop, komputasi, state, biaya, kematangan, serta langkah migrasi dari loop Responses yang dibuat manual. Untuk implementasi sesi dan persetujuan, baca panduan OpenAI Agents API. Anda juga dapat menguji setiap antarmuka HTTP di Apidog.

Pilihan agen OpenAI secara berdampingan

	Agents API	Responses API	Agents SDK	AgentKit
Apa itu	Runtime agen terkelola pada Codex harness	Endpoint model: `POST /v1/responses`	Pustaka TypeScript dan Python	Bundel: Agent Builder, ChatKit, Connector Registry, Evals
*Siapa yang menjalankan loop***	OpenAI	Kode Anda	Runner SDK di aplikasi Anda	Alur kerja Agent Builder, diekspor ke kode SDK atau disematkan dengan ChatKit
Di mana komputasi berjalan	Sandbox yang di-hosting OpenAI, sandbox Anda sendiri, atau tidak ada	Lingkungan Anda, ditambah alat yang di-hosting	Runtime dan penyedia sandbox Anda	Tidak berlaku
*Di mana state* berada**	Sesi OpenAI: konfigurasi, giliran, item	Riwayat Anda, `previous_response_id`, atau Conversations API	Penyimpanan Anda, sesi SDK, atau state Responses	Alur kerja dan versi yang diterbitkan
Apa yang Anda bayar	Token, alat, dan kontainer yang di-hosting; tanpa biaya tambahan	Token dan alat	Token dan alat, ditambah hosting Anda	Penggunaan API yang mendasari; tanpa langganan terpisah
Upaya integrasi	Rendah	Tinggi	Sedang	Tidak dinilai
Status	Beta publik: `OpenAI-Beta: agents=v1`	Direkomendasikan untuk semua proyek baru	Saat ini	Agent Builder dan Evals dihentikan 30 November 2026; ChatKit tetap ada
Kontrol data	Hanya residensi data AS; tidak memenuhi syarat ZDR; state disimpan hingga dihapus	Memenuhi syarat ZDR dengan batasan; tersedia endpoint regional	Bergantung pada API yang dipanggil	Tidak berlaku

Sumber: perbandingan runtime agen OpenAI, ringkasan Agents API, dan halaman depresiasi.

Siapa yang menjalankan loop

Keputusan ini menentukan desain integrasi, lokasi state, persetujuan alat, dan kebutuhan infrastruktur Anda.

Responses API: kode Anda menjalankan loop

Gunakan Responses API jika Anda membutuhkan kontrol penuh atas setiap giliran. Alat yang di-hosting—seperti pencarian web, pencarian file, code interpreter, dan MCP jarak jauh—dapat melakukan beberapa panggilan dalam satu permintaan. Namun, untuk fungsi milik Anda sendiri, model akan mengembalikan item function_call.

Alur implementasinya:

Kirim prompt dan definisi alat ke POST /v1/responses.
Periksa apakah output berisi function_call.
Jalankan fungsi di server Anda.
Kirim function_call_output dengan call_id yang sama.
Ulangi hingga model menghasilkan jawaban akhir.

Anda juga menentukan kapan loop berhenti, cara menyimpan riwayat, dan strategi konteks panjang. Respons disimpan secara default; gunakan store: false untuk menonaktifkannya. Untuk konteks panjang, gunakan context_management dan compact_threshold.

Lihat panduan Responses API dan panduan function calling untuk detail implementasi loop.

Agents SDK: proses aplikasi Anda menjalankan loop

Pilih Agents SDK jika Anda ingin loop dikelola oleh runner SDK, tetapi tetap berjalan dalam proses dan infrastruktur aplikasi Anda. Dokumentasi OpenAI menyatakan bahwa runner SDK menangani agent loop dan serah terima.

Anda tetap bertanggung jawab atas:

penyebaran aplikasi;
implementasi alat;
penyimpanan state;
autentikasi;
log audit;
kebijakan persetujuan manusia.

Dengan Sandbox Agents, harness dapat tetap berada di infrastruktur Anda sementara perintah dieksekusi di workspace Unix lokal, Docker, atau penyedia hosting lain.

Agents API: OpenAI menjalankan loop

Pilih Agents API jika Anda ingin menyerahkan orkestrasi agent loop kepada OpenAI. Harness terkelola menangani sesi, orkestrasi, pemadatan konteks, dan pemulihan. API ini juga menambahkan subagent, pencarian alat, serta panggilan alat terprogram.

Server MCP jarak jauh dipanggil langsung oleh OpenAI. Untuk alat fungsi Anda sendiri, aplikasi tetap perlu menangani aksi yang diperlukan:

Pantau required_actions pada sesi.
Temukan item function_call.
Jalankan fungsi di backend Anda.
Kirim event agent.session.input.tool_result dengan turn_id dan call_id.

Berikut perbandingan permintaan awal untuk tugas yang sama:

# Responses API: satu panggilan model; kode Anda mengelola loop
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: sesi tahan lama; OpenAI mengelola loop
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-astra",
      "tools": [{"type": "web_search"}]
    },
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Contoh dokumentasi Agents API menggunakan gpt-6-astra. Dokumentasi tersebut tidak menyebutkan apakah model lain diterima, jadi verifikasi kompatibilitas sebelum menggantinya dengan gpt-6.1-sol.

Komputasi, state, dan biaya

Komputasi

Agents API dapat menyediakan dan mengelola sandbox untuk seluruh sesi. Tentukan environment.type sebagai salah satu nilai berikut:

openai_hosted untuk sandbox yang dikelola OpenAI;
self_hosted untuk sandbox milik Anda;
none jika agen tidak membutuhkan lingkungan eksekusi.

Dengan Agents SDK, Anda memilih serta membayar penyedia sandbox sendiri. Dengan Responses API, fungsi Anda berjalan di lingkungan tempat aplikasi Anda berjalan, terlepas dari alat yang di-hosting.

State

Sesi Agents API menyimpan konfigurasi, giliran, dan item di sisi OpenAI. Untuk mengirim tindak lanjut, gunakan ID sesi yang sama dan kirim event baru.

Pada Responses API, Anda perlu merangkai konteks menggunakan:

previous_response_id;
Conversations API; atau
penyimpanan riwayat milik Anda sendiri.

Pada Agents SDK, state berada di penyimpanan Anda, sesi SDK, atau state Responses, sesuai desain aplikasi.

Biaya

Harga token sama karena semua pilihan memanggil model yang sama. Agents API menyatakan “tanpa biaya tambahan”, tetapi kontainer yang di-hosting tetap memiliki biaya: $0,03 untuk 1 GB hingga $0,48 untuk 16 GB per sesi 20 menit.

Biaya tambahan pada Agents SDK adalah infrastruktur yang Anda operasikan sendiri. AgentKit tidak memiliki langganan terpisah, seperti dijelaskan dalam penjelasan AgentKit.

Data dan kepatuhan

Agents API hanya mendukung residensi data AS dan tidak mendukung Zero Data Retention (ZDR), termasuk saat memakai sandbox yang di-hosting sendiri.

Halaman kontrol data OpenAI mencantumkan /v1/agents sebagai tidak memenuhi syarat ZDR, dengan state disimpan hingga dihapus. Sebaliknya, /v1/responses memenuhi syarat ZDR dengan batasan dan tersedia pada endpoint regional seperti eu.api.openai.com.

Jika ZDR atau residensi data UE merupakan persyaratan, Agents API tidak cocok untuk kebutuhan tersebut saat ini.

AgentKit di akhir 2026: apa yang tersisa

AgentKit diluncurkan pada 6 Oktober 2025 sebagai paket empat bagian. Gunakan status berikut untuk menentukan jalur implementasi:

Agent Builder: penghentian diumumkan pada 3 Juni 2026 dan penutupan dijadwalkan pada 30 November 2026. Panduan migrasi OpenAI mendukung ekspor alur kerja menjadi kode Agents SDK atau pembuatan ulang sebagai ChatGPT Workspace Agent pada Business, Enterprise, atau Edu.
Evals: eval yang ada menjadi hanya-baca pada 31 Oktober 2026. Dashboard dan API dijadwalkan ditutup pada 30 November 2026.
ChatKit: tetap tersedia untuk menyematkan UI chat.
Connector Registry: panel admin untuk konektor dan server MCP di seluruh produk OpenAI.

Untuk jalur code-first yang tahan lama, gunakan Agents SDK, seperti dibahas dalam panduan AgentKit.

Mana yang akan digunakan

Pilih	Gunakan ketika
Agents API	Tugas berjalan selama beberapa menit, membutuhkan file, perintah, atau browser, dan Anda tidak ingin mengoperasikan loop, sandbox, atau penyimpanan sesi. Residensi AS dan beta header dapat diterima.
Responses API	Anda membuat panggilan tunggal, ingin mengendalikan setiap giliran, membutuhkan ZDR atau residensi data non-AS, atau sudah memiliki loop yang berfungsi.
Agents SDK	Aplikasi bertipe Anda membutuhkan alat, penyimpanan, persetujuan, dan serah terima, sementara loop harus berjalan di infrastruktur Anda.
ChatKit	Anda membutuhkan UI chat yang disematkan di produk.
Agent Builder	Jangan memulai proyek baru di sini. Ekspor alur kerja yang ada sebelum 30 November 2026.

Di AWS, Bedrock Managed Agents, didukung oleh OpenAI, menyediakan kapabilitas inti Agents API untuk berjalan secara native di AWS. Untuk menghubungkan MCP dalam jalur code-first, lihat server MCP dengan agen OpenAI.

Beralih dari loop Responses ke Agents API

Jika Anda sudah memiliki loop berbasis Responses dan ingin OpenAI mengelolanya, lakukan migrasi secara bertahap.

Petakan komponen yang ada.

Pindahkan instruksi, model, dan alat ke agent. Pindahkan konfigurasi kontainer ke environment. Ganti penyimpanan percakapan dengan ID sesi.
Pindahkan server MCP jarak jauh ke agent.tools.

Simpan token MCP dalam vault yang terpasang melalui vault_ids. Jangan menaruh token di dalam prompt.
Tulis ulang penanganan fungsi.

Ganti loop function_call_output dengan handler untuk:
- agent.session.requires_action pada stream; atau
- agent.session.action_required pada webhook.

Handler tersebut harus mengirim agent.session.input.tool_result. Sertakan turn_id dan call_id dari aksi yang diterima.

Pertahankan alat fungsi pada agen utama.

Subagent tidak dapat memanggil alat fungsi, jadi jangan memindahkan alat tersebut ke subagent.
Hapus kode pemadatan konteks manual.

Harness Agents API melakukan pemadatan konteks secara otomatis.
Beralih ke event status giliran.

Pantau event berikut saat memakai stream:
- agent.session.turn.completed
- agent.session.turn.failed
- agent.session.turn.cancelled

Anda juga dapat memakai webhook. Jangan menganggap sesi yang tidak aktif sebagai sesi yang sukses.

Verifikasi batasan sebelum produksi. Periksa residensi data AS, tidak adanya dukungan ZDR, serta kebutuhan header beta OpenAI-Beta: agents=v1.

Pertahankan keduanya dalam satu proyek Apidog

Sebelum memigrasikan seluruh aplikasi, jalankan implementasi lama dan baru secara berdampingan.

Dalam satu proyek Apidog:

Buat folder Responses.
Buat folder Agents API.
Gunakan lingkungan bersama dengan {{OPENAI_API_KEY}} dan variabel model.
Kirim prompt yang sama ke kedua API.
Verifikasi kode status serta field output yang diperlukan.
Buka stream Agents API sebagai permintaan SSE untuk melihat event per giliran.
Simpan setiap eksekusi sebagai skenario pengujian.
Jalankan skenario tersebut di CI menggunakan Apidog CLI.

Dengan pendekatan ini, perubahan beta dapat muncul sebagai pemeriksaan gagal sebelum mencapai produksi. Panduan keandalan agen AI produksi membahas hal yang perlu diverifikasi. Unduh Apidog untuk menyiapkannya.

FAQ

Apakah Agents API menggantikan Responses API?

Tidak ada penghentian yang diumumkan. Ringkasan agen OpenAI mencantumkan Agents API, Agents SDK, dan Responses API sebagai pilihan saat ini untuk kebutuhan berbeda.

Apakah OpenAI AgentKit dihentikan?

Sebagian. Agent Builder dan Evals dijadwalkan ditutup pada 30 November 2026, sedangkan ChatKit tetap tersedia.

Apakah Agents SDK menggunakan Agents API?

Tidak. SDK berjalan di aplikasi Anda, sedangkan Agents API menjalankan harness terkelola pada layanan OpenAI.

Apa yang terjadi dengan Assistants API?

Halaman depresiasi OpenAI menetapkan penghapusannya pada 26 Agustus 2026 dan mengarahkan pengembang ke Responses serta Conversations API.

Opsi mana yang termurah?

Harga token sama di antara semua pilihan. Perbedaan biaya berasal dari kontainer yang di-hosting pada Agents API dibandingkan hosting yang Anda operasikan sendiri dengan SDK atau Responses.

Pilih satu jalur minggu ini

Pilih berdasarkan siapa yang harus menjalankan loop, lalu buktikan keputusan tersebut dengan permintaan API sebelum menulis aplikasi penuh. Jika memulai dari awal, buat satu sesi Agents API dan bandingkan hasilnya dengan penyiapan Responses Anda saat ini di Apidog.

DEV Community