Alat (API)

Alat membuat agent bisa mengecek data di sistem milik bisnis Anda. Contohnya stok, ongkir, atau status pesanan. Agent memanggil alat saat pelanggan membutuhkan info itu.

Alat memanggil satu alamat API di sistem Anda. Sistem Anda harus punya API yang bisa dibuka lewat HTTPS.

Yang Anda perlukan

• Peran pemilik atau admin di workspace.
• Kunci OpenRouter yang sudah tersimpan. Baca Agentic.
• Model Balasan berlabel Mendukung alat.
• Alamat API HTTPS publik dari sistem Anda.
• Kalau API Anda meminta tanda masuk: token, kata sandi, atau kunci dari sistem Anda.

Tanya pengembang Anda kalau Anda belum punya API. Minta alamat, cara autentikasi, dan contoh jawabannya.

Dua jenis alat

Saran balasan yang tim minta sendiri hanya memakai alat yang membaca data.

Contoh: alat "Cek stok"

Contoh ini membuat alat yang mengecek stok satu produk. Ganti alamat dengan alamat API Anda.

1. Buka AI Wulan → Agent & model.
2. Klik tab Alat (API).
3. Klik Tambah alat.
4. Isi kolom berikut.

5. Di Parameter, klik Tambah parameter, lalu isi:

6. Di Autentikasi, pilih jenis yang API Anda minta. Lihat bagian "Autentikasi" di bawah.
7. Di Bagian jawaban untuk AI, tulis data.nama, data.stok. Agent hanya menerima dua bagian itu.
8. Uji alat. Lihat bagian berikutnya.
9. Klik Simpan.
10. Nyalakan saklar alat di daftar.

Tulis {kode_produk} di URL untuk bagian yang diisi agent. Setiap {nama} di URL harus punya parameter dengan nama yang sama. Bagian {nama} boleh ada di jalur atau di query. Nama domain tetap dan tidak boleh memuat {nama}.

Contoh: saat pelanggan bertanya "Kaos hitam M masih ada?", agent mengisi kode_produk, memanggil alamat itu, lalu menjawab dari hasilnya.

Tulis deskripsi yang jelas

Agent membaca Deskripsi untuk AI untuk memutuskan kapan memakai alat. Tulis kapan alat dipakai dan data apa yang dikembalikan. Isi Penjelasan untuk AI di tiap parameter dengan contoh nilainya.

Parameter bisa bertipe Teks, Angka, atau Ya/Tidak. Isi Pilihan tetap kalau nilainya hanya boleh dari daftar, misalnya reguler, kilat.

Autentikasi

Autentikasi adalah cara sistem Anda memastikan bahwa yang memanggil adalah Konektor.

Isi Token, Nilai header, atau Username dan Kata sandi sesuai pilihan. Konektor menyimpan nilai itu terenkripsi dan tidak menampilkannya lagi. Halaman hanya menampilkan 4 karakter terakhir. Untuk mengganti nilai, isi kolomnya dengan nilai baru.

Kalau API Anda butuh header lain, buka Header tambahan dan klik Tambah header. Konektor mengirim header itu di setiap permintaan.

Uji alat

Uji alat sebelum Anda menyimpannya.

1. Di bagian Uji alat, isi Nilai contoh untuk tiap parameter, misalnya KS-HTM-M.
2. Klik Uji sekarang.
3. Baca hasilnya.

Pengujian mengirim satu permintaan sungguhan ke sistem Anda. Pengujian tidak dihitung sebagai pemakaian agent.

Hasil yang benar menampilkan Berhasil, Status 200, durasi, dan Awal jawaban. Periksa bahwa awal jawaban memuat data yang Anda butuhkan.

Alat POST dan persetujuan

Alat dengan metode POST mengubah data di sistem Anda. Karena itu alat POST diberi tanda Perlu persetujuan.

Saat balas otomatis menyala dan agent ingin memakai alat POST:

1. Agent berhenti dan mengirim pesan tunggu ke pelanggan.
2. Kotak Masuk menampilkan kartu "Wulan ingin menjalankan {nama alat}".
3. Anggota tim membaca rinciannya, lalu menekan Setujui atau Tolak.
4. Agent melanjutkan dan membalas pelanggan.

Aksi yang tidak diputuskan dalam 30 menit kedaluwarsa. Baca Serah ke tim dan Persetujuan.

Hasil yang terlihat

• Alat muncul di daftar dengan tanda Baca (GET) atau Perlu persetujuan (POST).
• Hitungan "{jumlah} dari 10 alat" muncul di atas daftar.
• Setiap pemakaian alat tercatat di tab Aktivitas.

Masalah umum

Agent tidak memakai alat Anda? Periksa tiga hal:

1. Saklar alat menyala.
2. Model Balasan berlabel Mendukung alat.
3. Deskripsi untuk AI menjelaskan kapan alat dipakai.

Batas

Lihat juga

• Agentic
• MCP
• Serah ke tim dan Persetujuan
• Pengetahuan