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

Keempat nama ini berada pada lapisan yang berbeda, dan satu pertanyaan memisahkan mereka: siapa yang menjalankan *agent loop*? Responses API adalah panggilan model, dan kode Anda menjalankan *loop* di sekitarnya. Agents SDK adalah pustaka TypeScript dan Python yang *runner*-nya mengeksekusi *loop* di dalam aplikasi Anda. Agents API, dalam beta publik sejak 10 September 2026, menjalankan *Codex harness* OpenAI untuk Anda dan menjaga sesi serta, secara opsional, *sandbox*. AgentKit adalah paket Oktober 2025 yang terdiri dari Agent Builder, ChatKit, Connector Registry, dan Evals, dan Agent Builder dijadwalkan untuk dihentikan pada 30 November 2026.

DevDay pada 29 September menambahkan penggunaan komputer ke Agents API (lihat rangkuman DevDay 2026), yang membuat pertanyaan penamaan semakin sulit diabaikan. Di bawah ini: perbandingan *side-by-side* mengenai *loop*, komputasi, *state*, harga dan kematangan, tabel keputusan, dan jalur migrasi dari *loop* Responses yang dibuat secara manual. Untuk panduan praktis sesi dan persetujuan, baca panduan OpenAI Agents API. Apapun pilihan Anda, antarmuka HTTP dapat diuji di Apidog.

Pilihan agen OpenAI secara berdampingan

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

Siapa yang menjalankan *loop*

Ini adalah poros yang menentukan sebagian besar baris lainnya.

Responses API: Anda yang menjalankannya. Alat-alat yang di-hosting seperti pencarian web, pencarian file, *code interpreter*, dan MCP jarak jauh dapat menjalankan beberapa panggilan dalam satu permintaan, tetapi fungsi Anda sendiri akan kembali kepada Anda. Ketika model memanggil salah satunya, Anda mendapatkan item function_call, menjalankannya, dan mengirim function_call_output dengan call_id yang sama di permintaan berikutnya. Anda memutuskan kapan harus berhenti, bagaimana menyimpan riwayat (respons disimpan secara *default*; store: false menonaktifkannya), dan kapan harus memadatkan konteks panjang dengan context_management dan compact_threshold. Panduan Responses API dan panduan *function calling* mencakup *loop* tersebut.

Agents SDK: proses Anda yang menjalankannya. Dokumentasi OpenAI menyatakan bahwa *runner* SDK "menangani *agent loop* dan serah terima," sementara server Anda memiliki penyebaran, implementasi alat, penyimpanan *state*, dan keputusan persetujuan. Dengan Sandbox Agents, *harness* dapat tetap berada di infrastruktur Anda sementara perintah berjalan di *workspace* Unix-lokal, Docker, atau penyedia hosting, sehingga otentikasi, log audit, dan tinjauan manusia tetap berada di luar kontainer.

Agents API: OpenAI yang menjalankannya. *Harness* terkelola menangani sesi, orkestrasi, pemadatan konteks, dan pemulihan, serta menambahkan *subagent*, pencarian alat, dan panggilan alat secara terprogram. Server MCP jarak jauh dipanggil langsung oleh OpenAI. Kode Anda masih menangani alat fungsi: ketika sesi melaporkan function_call di required_actions, Anda mengembalikan *event* agent.session.input.tool_result dengan turn_id dan call_id.

Tugas yang sama, dengan dua cara:

# Responses API: satu panggilan model; kode Anda yang 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 yang tahan lama; OpenAI yang 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; mereka tidak menyebutkan apakah model lain diterima, jadi periksa sebelum Anda mengganti dengan gpt-6.1-sol.

Komputasi, *state*, dan biaya

Komputasi. Agents API dapat menyediakan dan mengelola *sandbox* untuk seluruh sesi: atur environment.type ke openai_hosted, self_hosted, atau none. Dengan SDK, Anda memilih dan membayar penyedia *sandbox*. Dengan Responses, kode berjalan di mana Anda menjalankannya, terlepas dari alat-alat yang di-hosting.

*State*. Sesi Agents API menyimpan konfigurasi, giliran, dan item di sisi OpenAI, sehingga tindak lanjut adalah satu *event* pada ID sesi yang sama. Dengan Responses, Anda merangkai previous_response_id atau menggunakan Conversations. Dengan SDK, *state* berada di penyimpanan Anda atau sesi SDK.

Biaya. Harga token identik di mana pun, karena setiap opsi memanggil model yang sama. Agents API mengenakan "tanpa biaya tambahan," tetapi kontainer yang di-hosting berharga $0,03 (1 GB) hingga $0,48 (16 GB) per sesi 20 menit. Biaya tambahan SDK adalah hosting Anda sendiri. AgentKit tidak memiliki langganan terpisah, sesuai penjelasan AgentKit kami.

Data. Agents API hanya mendukung residensi data AS dan tidak mendukung Zero Data Retention (ZDR), bahkan dengan *sandbox* yang di-hosting sendiri. Halaman kontrol data OpenAI mencantumkan /v1/agents sebagai tidak memenuhi syarat ZDR, dengan *state* disimpan hingga dihapus, sementara /v1/responses memenuhi syarat ZDR dengan batasan dan tersedia di *endpoint* regional seperti eu.api.openai.com. Jika ZDR atau residensi UE adalah persyaratan, itu menyingkirkan Agents API untuk saat ini.

AgentKit di akhir 2026: apa yang tersisa

AgentKit diluncurkan pada 6 Oktober 2025 sebagai empat bagian. Berikut adalah posisi masing-masing:

• Agent Builder: penghentian diumumkan 3 Juni 2026; penjadwalan penutupan 30 November 2026. Panduan migrasi OpenAI mengekspor alur kerja sebagai kode Agents SDK, atau membuatnya ulang sebagai ChatGPT Workspace Agent di Business, Enterprise, atau Edu.
• Evals: *eval* yang ada menjadi hanya-baca pada 31 Oktober 2026, dan *dashboard* serta API dijadwalkan untuk ditutup pada 30 November.
• ChatKit: tetap tersedia untuk *chat* yang disematkan.
• Connector Registry: panel admin untuk konektor dan server MCP di seluruh produk OpenAI.

Seperti yang dijelaskan panduan AgentKit kami, jalur *code-first* yang tahan lama melalui AgentKit adalah Agents SDK.

Mana yang akan digunakan

Di AWS, Bedrock Managed Agents, didukung oleh OpenAI, membawa kapabilitas inti Agents API untuk berjalan secara *native* di AWS. Untuk pengkabelan MCP di jalur *code-first* mana pun, lihat server MCP dengan agen OpenAI.

Beralih dari *loop* Responses Anda sendiri ke Agents API

Jika Anda telah membangun *loop* pada Responses dan ingin OpenAI menjalankannya:

1. Petakan bagian-bagiannya. Instruksi, model, dan alat pindah ke agent; kontainer Anda menjadi environment; penyimpanan percakapan Anda menjadi ID sesi.
2. Pindahkan server MCP jarak jauh ke agent.tools. Tempatkan token mereka di *vault* yang terpasang dengan vault_ids, bukan di *prompt*.
3. Tulis ulang penanganan fungsi. Ganti *loop* function_call_output Anda dengan *handler* untuk agent.session.requires_action (*stream*) atau agent.session.action_required (*webhook*) yang mengembalikan agent.session.input.tool_result. *Subagent* tidak dapat memanggil alat fungsi, jadi pertahankan itu pada agen utama.
4. Hapus kode pemadatan Anda. *Harness* memadatkan konteks secara otomatis.
5. Beralih ke *event*. *Stream* hasil giliran (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled) atau gunakan *webhook*. Sesi yang tidak aktif tidak berarti sukses.
6. Periksa batasannya. Hanya residensi AS, tanpa ZDR, dan *beta header*.

Pertahankan keduanya dalam satu proyek Apidog

Sebelum Anda beralih, jalankan yang lama dan yang baru secara berdampingan. Dalam satu proyek Apidog, buat folder Responses dan folder Agents API yang berbagi lingkungan dengan {{OPENAI_API_KEY}} dan variabel model. Kirim *prompt* yang sama melalui keduanya, pastikan kode status dan *field output* yang diperlukan, dan buka *stream* Agents API sebagai permintaan SSE untuk melihat *event* giliran. Simpan jalannya sebagai skenario pengujian dan jalankan di CI dengan Apidog CLI, sehingga perubahan beta akan muncul sebagai pemeriksaan yang gagal. Panduan keandalan agen AI produksi mencakup apa yang harus dipastikan. Unduh Apidog untuk mengaturnya.

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 yang berbeda.

Apakah OpenAI AgentKit dihentikan? Sebagian. Agent Builder dan Evals dijadwalkan untuk ditutup pada 30 November 2026; ChatKit tetap tersedia.

Apakah Agents SDK menggunakan Agents API? Tidak. SDK berjalan di aplikasi Anda; Agents API menjalankan *harness* terkelola di layanan OpenAI.

Apa yang terjadi dengan Assistants API? Halaman depresiasi OpenAI menetapkan penghapusannya pada 26 Agustus 2026, dan mengarahkan pengembang ke Responses dan Conversations API.

Opsi mana yang termurah? Harga token sama di antara semuanya. Perbedaannya adalah kontainer yang di-hosting pada Agents API versus hosting Anda sendiri dengan SDK atau Responses.

Pilih satu jalur minggu ini

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