Buat definisi tool yang bisa dipanggil model AI, dengan nama, deskripsi, dan parameternya. Ekspor sebagai JSON Schema biasa atau dalam bentuk yang diharapkan API tool-calling umum dan server MCP, dan lihat masalah sebelum model tersandung. Berjalan di browser Anda, gratis, dan privat.
Cara membangun definisi tool
- Beri Nama tool dan Deskripsi yang jelas.
- Tekan Tambah parameter untuk setiap input, dan atur nama, tipe, deskripsi, dan apakah wajib.
- Tekan Tambah tool lain untuk lebih dari satu, atau Hapus tool ini untuk menghapus satu. Mulai ulang menghapus semuanya.
- Pilih keluaran: JSON Schema, atau salah satu format penyedia, atau MCP. Aktifkan Mode strict (keluaran terstruktur) jika Anda memerlukannya.
- Tekan Salin JSON atau Unduh. Salin argumen contoh memberi contoh pemanggilan.
Sudah punya definisi? Tempel ke JSON untuk diimpor dan tekan Impor.
Menulis tool yang dipakai model dengan baik
Model memilih tool dengan membaca nama dan deskripsinya, jadi katakan dengan jelas fungsinya dan kapan dipakai, misalnya “Cari di pusat bantuan. Gunakan saat pengguna bertanya cara melakukan sesuatu di aplikasi.” Jelaskan setiap parameter, termasuk satuan dan format, seperti “tanggal ISO, YYYY-MM-DD”. Gunakan daftar nilai yang diizinkan tetap jika pilihannya terbatas, dan tandai hanya kolom yang benar-benar dibutuhkan sebagai wajib.
Bagaimana format berbeda
Skema parameter adalah JSON Schema yang sama di mana-mana; yang berubah adalah pembungkusnya. Satu penyedia menaruhnya di bawah function.parameters, yang lain menyebutnya input_schema, yang lain mendaftar deklarasi fungsi, dan server MCP mengembalikan inputSchema. Mode strict menambah aturan: setiap properti harus tercantum sebagai wajib dan properti tambahan harus ditolak, jadi kolom opsional ditulis sebagai mengizinkan null.
Apa yang ditangkap pemeriksaan
Nama yang melanggar aturan API, seperti spasi atau lebih dari 64 karakter, nama tool atau parameter duplikat, nilai yang diizinkan tidak sesuai tipe, objek tanpa properti, dan deskripsi yang hilang. Kesalahan akan menghentikan panggilan API; peringatan adalah hal yang cenderung membuat model memilih tool yang salah atau mengisi nilai yang salah.
Tips
- Gunakan nama pendek berbasis kata kerja seperti search_orders atau get_weather, hanya dengan huruf, angka, dan garis bawah.
- Jaga jumlah tool tetap kecil. Model memilih lebih baik dari daftar pendek.
- Beri setiap parameter contoh dalam deskripsinya saat formatnya tidak jelas.
- Uji skema terhadap jawaban nyata dengan pemeriksa skema jawaban AI.
Siapa yang memakainya
Developer, freelancer yang membuat asisten untuk klien, dan siswa yang belajar cara kerja tool calling. Untuk mengubah objek JSON contoh menjadi tipe untuk kode Anda, lihat JSON ke tipe.
Pertanyaan
Apa itu mode strict?
Ini membuat model mengikuti skema persis. Semua properti harus tercantum sebagai wajib dan properti tambahan ditolak.
Apakah definisi saya diunggah?
Tidak. Dibuat di browser Anda.
Bisakah saya mengedit definisi yang sudah ada?
Ya. Tempel ke kotak impor, ubah, dan ekspor lagi.