~/tools / Tool Definition Checker
Tool Definition Checker — Periksa definisi tool dan fungsi untuk OpenAI, Anthropic, Gemini
Periksa definisi tool (fungsi) yang Anda kirim ke OpenAI, Anthropic, atau Gemini terhadap format yang didokumentasikan tiap API: nama, deskripsi, schema parameter, strict mode, dan contoh input. Temukan kesalahan sebelum permintaan gagal. Tidak ada data yang keluar dari browser Anda.
Aturan diperiksa terhadap dokumentasi pada 2026-10-23.
Dokumentasi: OpenAI / Anthropic / Referensi Gemini API
Tidak diperiksa: apakah sebuah model mendukung tool tersebut, detail strict tool use untuk Anthropic, tool yang disediakan Anthropic sendiri, dan aturan yang tidak dinyatakan dalam dokumentasi.
Semuanya berjalan di browser Anda. Definisi tidak diunggah.
Penggunaan tool (tool use), disebut juga pemanggilan fungsi (function calling), memungkinkan model meminta kode Anda menjalankan sebuah fungsi. Anda menggambarkan setiap fungsi dalam definisi JSON, dan ketiga API besar mengharapkan bentuk yang berbeda: OpenAI Chat Completions menaruh fungsi di dalam objek function, OpenAI Responses menaruh field-nya pada satu tingkat, Anthropic memakai name dan input_schema, dan Gemini memakai deklarasi fungsi. Aturan penamaannya pun berbeda. Alat ini membaca definisi yang Anda tempel, menentukan untuk API mana definisi itu ditulis, lalu memeriksanya terhadap isi dokumentasi vendor tersebut: nama, deskripsi, schema parameter, strict mode, dan, khusus Anthropic, apakah setiap contoh input sesuai dengan schema. Alat ini juga memberi tahu bila sebuah nama yang berfungsi di satu API akan ditolak oleh API lain. Aturan-aturannya diperiksa terhadap dokumentasi pada tanggal yang tertera di bawah alat ini.
Kapan dipakai
- Memeriksa definisi tool sebelum ditambahkan ke permintaan, agar nama yang salah atau bentuk yang keliru tidak menggagalkan panggilan
- Mencari tahu mengapa strict mode menolak schema sebuah fungsi
- Memindahkan tool dari satu vendor ke vendor lain dan melihat apa yang harus diubah
Cara pakai
- Tempelkan satu definisi tool, sebuah array tool, atau body permintaan yang memiliki array tools, atau muat contohnya.
- Lihat API mana yang dikenali untuk tiap tool, lalu daftar temuannya. Perbaiki berarti dokumentasi menyebut definisi itu akan ditolak atau tidak valid, Periksa berarti layak dicermati, dan Catatan hanya untuk informasi.
- Perbaiki definisinya lalu tempelkan lagi. Untuk masalah strict mode, Structured Output Schema Checker menampilkan setiap masalah secara rinci.
Tanya jawab
Bagaimana alat ini tahu definisi itu untuk API yang mana?
Dari bentuknya. Definisi dengan input_schema dibaca sebagai Anthropic. Definisi dengan type function dan objek function bersarang dibaca sebagai OpenAI Chat Completions, sedangkan definisi dengan type function dan field di tingkat atas dibaca sebagai OpenAI Responses. Objek dengan functionDeclarations, atau dengan name, description, dan parameters, dibaca sebagai Gemini. Hasilnya menunjukkan apa yang dikenali untuk tiap tool.
Apa saja aturan penamaannya?
OpenAI mendokumentasikan huruf, angka, garis bawah, dan tanda hubung, hingga 64 karakter. Anthropic mendokumentasikan huruf, angka, garis bawah, dan tanda hubung, hingga 128 karakter. Gemini mendokumentasikan huruf, angka, garis bawah, titik dua, titik, dan tanda hubung, hingga 128 karakter. Nama yang valid untuk satu API bisa ditolak oleh API lain, dan alat ini akan memberi tahu bila hal itu terjadi.
Mengapa schema diperiksa lagi saat strict bernilai true?
OpenAI menyatakan strict mode membutuhkan additionalProperties yang diatur ke false pada setiap objek dan setiap properti tercantum di required, dengan nilai opsional ditulis sebagai tipe yang juga mengizinkan null. Schema yang melanggar aturan ini akan ditolak. Alat ini menghitung masalahnya dan menunjukkan di mana masalah pertama berada.
Apa yang diperiksa pada input_examples?
Anthropic menyatakan setiap contoh harus valid terhadap input_schema tool tersebut dan contoh yang tidak valid mengembalikan error 400. Alat ini memeriksa setiap contoh terhadap schema dan memberi tahu contoh mana yang gagal.
Apa yang tidak diperiksa?
Apakah model tertentu mendukung tool tersebut, detail strict tool use untuk Anthropic, tool yang disediakan Anthropic sendiri, dan apa pun yang tidak dinyatakan dalam dokumentasi. Alat ini tidak memanggil API apa pun, sehingga definisi yang lolos masih bisa gagal pada permintaan sungguhan.
Apakah definisi saya dikirim ke server?
Tidak. Pemeriksaan berjalan di browser Anda.