Koneksi API
Ubah API HTTP apa pun menjadi fungsi yang dapat dipanggil agen Anda di tengah percakapan: tempelkan perintah cURL, lalu panduan akan membuat definisi alat, parameter, dan autentikasi.
Koneksi API adalah fungsi HTTP kustom yang dapat dipanggil agen Anda selama
percakapan — mencari pesanan, membuat tiket, mengambil status akun
dari backend Anda sendiri. Anda menentukan endpoint sekali di bawah
Koneksi → API (/dashboard/api-connections); agen yang memiliki
koneksi terlampir kemudian dapat memanggilnya kapan pun percakapan
memerlukannya.
Ada dua cara untuk membuatnya: tempel sesuatu yang dapat dianalisis oleh Wizard, atau atur koneksi secara manual.
Jalur cepat: tempel dan analisis
- Klik Koneksi API baru
Dialog terbuka di Wizard. Tempel contoh perintah cURL, spesifikasi OpenAPI/Swagger, ekspor Postman, antarmuka TypeScript, atau skema Zod ke dalam kotak.
- Klik Analisis
ThunderPhone menyimpulkan seluruh koneksi dari tempelan Anda — URL, metode, header, dan skema parameter yang diturunkan dari parameter kueri serta isi permintaan yang ditemukan. Header yang Anda tempel (termasuk header autentikasi) dibawa ke konfigurasi endpoint.
- Konfirmasikan bidang yang disorot
Konfigurasi yang disimpulkan terbuka dengan bidang yang diperkirakan disorot untuk ditinjau. Sesuaikan nama, deskripsi, dan jenis parameter agar agen memahami kapan dan bagaimana memanggil fungsi — deskripsi adalah yang dibaca oleh model.
- Validasi & Simpan
Penyimpanan terlebih dahulu menjalankan permintaan uji langsung terhadap endpoint Anda. Jika permintaan gagal, koneksi tidak disimpan — perbaiki URL, header autentikasi, atau isi lalu coba lagi. Jika berhasil, koneksi disimpan dengan lencana Tervalidasi.
Jika Wizard tidak dapat menemukan URL permintaan dalam tempelan Anda, Wizard akan memberi tahu Anda —
sertakan endpoint http(s) lengkap lalu coba lagi.
Pengaturan manual
Klik Atur secara manual → di Wizard (atau Ingin AI menyimpulkan ini? Coba Wizard → untuk kembali). Pembuat manual memiliki dua editor:
- Visual — bidang formulir untuk nama tampilan, nama fungsi, permintaan
URL, metode (
POST,GET,PUT,PATCH,DELETE), kustom header, dan skema parameter (Tambahkan properti untuk setiap argumen yang dapat diberikan agen). - JSON — definisi yang sama sebagai JSON mentah, untuk menempelkan atau menyempurnakan spesifikasi tool secara langsung.
Panel Uji Permintaan (opsional) memungkinkan Anda mengirim permintaan yang dikonfigurasi sebelum menyimpan serta menampilkan status, latensi, dan pratinjau respons. Validasi & Simpan selalu menjalankan pengujian ini dan hanya menyimpan jika berhasil.
Kelola koneksi Anda
Setiap baris koneksi menampilkan status validasinya — Tervalidasi, Belum diuji, atau Error — nama fungsinya, serta agen yang menggunakannya. Dari menu tindakan baris, Anda dapat:
- Edit — membuka kembali konfigurasi.
- Kloning — menduplikasinya sebagai titik awal (salinan dimulai Belum diuji).
- Riwayat revisi — melihat versi sebelumnya dan memulihkan salah satunya ke editor.
- Transfer — menyalin atau memindahkan koneksi ke organisasi lain yang Anda ikuti. Pemindahan menghapusnya di sini; agen yang menggunakannya mungkin perlu dikonfigurasi ulang.
- Hapus — permanen; agen yang menggunakan koneksi perlu dikonfigurasi ulang.
Lampirkan ke agen
Tambahkan koneksi ke agen di bagian koneksi API pada pembuat (Buat agen). Daftar menampilkan agen yang menggunakan setiap koneksi, sehingga Anda dapat langsung mengetahui dampak suatu perubahan.