Debugger Agen AI Apidog tersedia di klien Apidog terbaru di semua paket, termasuk paket Gratis. Debugger ini memungkinkan Anda menjalankan agen AI terhadap model OpenAI dan Anthropic, menghubungkan server MCP, memeriksa setiap panggilan model dan pemanggilan alat di panel Jejak, serta melacak biaya per eksekusi.
Artikel ini membahas siapa yang dapat menggunakan Debugger Agen AI, apa saja yang didukungnya, apa yang tidak didukungnya, cara mengaktifkannya, dan apa saja yang tetap sama pada proyek Apidog Anda yang sudah ada.
Apa yang tersedia
Debugger Agen AI disertakan dalam klien Apidog standar. Tidak ada lisensi terpisah, tidak ada paket tambahan, dan tidak ada biaya per-kursi.
- Paket Gratis, Dasar, Profesional, dan Perusahaan semuanya menyertakan Debugger Agen AI.
- Fitur ini diaktifkan secara default; tidak perlu diubah.
- Anda harus menggunakan versi klien Apidog terbaru. Klien lama tidak memiliki tab Debugger Agen AI.
Penyedia model yang didukung
| Penyedia | Status | Model |
|---|---|---|
| OpenAI | Didukung | GPT-5.5, GPT-5.5 Instant, seri-o, dan model apa pun di akun OpenAI |
| Anthropic | Didukung | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Endpoint khusus yang kompatibel dengan OpenAI | Didukung melalui penggantian URL Dasar | Penyedia apa pun yang menyediakan API yang kompatibel dengan OpenAI |
| Penyedia lain (Google, Mistral, xAI) | Dalam rencana pengembangan | Saat ini bukan prioritas utama |
Metode koneksi server MCP
Debugger ini berbicara dengan Protokol Konteks Model secara asli. Tiga transportasi didukung:
- STDIO. Subproses lokal. Terbaik untuk server MCP yang sedang dalam pengembangan aktif.
- HTTP Streamable. Server MCP yang dihosting dan dapat dijangkau melalui HTTP.
- SSE. Server-Sent Events lama. Masih umum; didukung untuk kompatibilitas mundur.
Autentikasi untuk server MCP mencakup dua pola: header standar (kunci API) dan OAuth 2.0 (pertukaran token penuh).
Apa yang dicakup oleh debugger
Debugger ini menangkap seluruh rantai eksekusi dari jalannya agen:
- Panggilan model dengan payload permintaan dan respons lengkap.
- Jejak pemikiran model, saat model mengungkapkannya (seri-o OpenAI, pemikiran diperpanjang Anthropic).
- Pemanggilan alat dengan nilai parameter dan data pengembalian.
- Lalu lintas server MCP, tercantum dalam panel Jejak seperti panggilan alat lainnya.
- Alat bawaan:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Metrik kinerja per eksekusi: waktu respons, token input, token output, perkiraan biaya.
- Keterampilan: bundel tersimpan dari prompt sistem + daftar alat + parameter untuk menjalankan ulang skenario.
Apa yang tidak dicakup oleh debugger
- Observabilitas produksi. Gunakan alat observabilitas khusus untuk pencatatan lalu lintas jangka panjang.
- Pengujian regresi otomatis. Untuk kisi-kisi prompt terhadap fixture, gunakan harness seperti Promptfoo.
- Lalu lintas protokol Agent-to-Agent (A2A). Untuk A2A, gunakan Debugger A2A Apidog yang terpisah.
- Validasi server MCP secara terpisah. Untuk menguji alat dan sumber daya server MCP tunggal tanpa loop agen, gunakan alur pengujian server MCP Apidog.
Cara mengaktifkannya
- Perbarui Apidog ke versi terbaru.
- Buka Apidog dan klik AI Agent Debugger di bilah tab atas.
- Pilih penyedia model dan model.
- Konfirmasikan URL Dasar (terisi otomatis dari penyedia) atau ganti untuk endpoint kustom.
- Tempel kunci API Anda.
- Klik Jalankan pada utas kosong untuk mengonfirmasi koneksi.
Tidak diperlukan konfigurasi tingkat proyek. Debugger berjalan di ruang kerjanya sendiri.
Apa yang tetap sama
- Proyek Apidog yang ada, definisi API, dan suite pengujian tidak terpengaruh.
- Alur pengujian server MCP dan Debugger A2A terus berfungsi secara paralel.
- Debugging endpoint API, server mock, dan pengeditan OpenAPI tidak berubah.
- Penagihan dan tingkatan paket tidak berubah; Debugger Agen AI tidak mengonsumsi kredit baru.
Anda membayar untuk panggilan API model dasar sesuai dengan tagihan akun OpenAI atau Anthropic Anda. Apidog tidak membebankan biaya tambahan untuk penggunaan.
Untuk admin Tim dan Perusahaan
- Debugger Agen AI diaktifkan per pengguna. Setiap anggota menggunakan kunci API penyedia mereka sendiri.
- Kunci API yang dimasukkan ke debugger disimpan secara lokal di klien setiap pengguna. Kunci tersebut tidak dikirimkan ke server Apidog.
- Pemilik ruang kerja dapat mengelola endpoint server MCP bersama secara terpusat melalui variabel lingkungan Apidog standar.
- Kontrol audit dan akses untuk server MCP mengikuti model autentikasi server MCP itu sendiri (header atau OAuth 2.0).
Keterbatasan yang diketahui
- Perluasan penyedia di luar OpenAI dan Anthropic sedang dalam rencana pengembangan; sementara itu, gunakan penggantian URL Dasar untuk penyedia yang kompatibel dengan OpenAI.
- Berbagi jejak hanya bersifat lokal. Untuk berbagi jejak, salin JSON tampilan Mentah atau tangkap layar panel.
- Estimasi biaya adalah perkiraan lokal berdasarkan harga model yang dipublikasikan; lihat dasbor penggunaan penyedia Anda untuk penagihan.