Referensi alat

Halaman ini adalah referensi untuk alat yang disediakan Anthropic dan properti opsional yang dapat Anda atur pada definisi alat apa pun. Untuk pengenalan konseptual tentang penggunaan alat, lihat Penggunaan alat dengan Claude. Untuk panduan tentang mengimplementasikan penggunaan alat di aplikasi Anda, lihat Tentukan alat.

Alat yang disediakan Anthropic

Anthropic menyediakan dua jenis alat: alat server yang dijalankan pada infrastruktur Anthropic, dan alat klien di mana Anthropic mendefinisikan skema tetapi aplikasi Anda menangani eksekusi. Kedua jenis muncul dalam array tools permintaan Anda bersama dengan alat yang ditentukan pengguna.

Untuk kompatibilitas model, lihat halaman setiap alat. Model yang didukung bervariasi menurut alat dan versi alat.

Versioning alat

Sebagian besar alat yang disediakan Anthropic memiliki akhiran _YYYYMMDD dalam string type. Versi baru dirilis ketika perilaku alat, skema, atau dukungan model berubah. Versi yang lebih lama tetap tersedia sehingga integrasi yang ada terus berfungsi.

Ketika alat memiliki beberapa versi aktif, hubungan di antara mereka bervariasi:

• Capability-keyed: web_search_20260209 dan web_fetch_20260209 menambahkan penyaringan konten dinamis dibandingkan pendahulu mereka. code_execution_20260120 menambahkan pemanggilan alat terprogram dari dalam sandbox. Dalam setiap kasus, versi baru dan lama adalah versi terkini; versi mana yang Anda gunakan tergantung pada apakah Anda memerlukan kemampuan baru.
• Model-keyed: text_editor_20250728 untuk model Claude 4 dan text_editor_20250124 untuk model sebelumnya. Versi yang Anda gunakan tergantung pada model yang Anda targetkan.
• Varian, bukan versi: tool_search_tool_regex_20251119 dan tool_search_tool_bm25_20251119 adalah dua algoritma pencarian yang dirilis bersama. Tidak ada yang menggantikan yang lain.
• Legacy: code_execution_20250522 hanya mendukung Python. code_execution_20250825 menambahkan Bash dan operasi file.

Tipe mcp_toolset tidak memiliki versi bertanggal; versioning dibawa dalam header anthropic-beta sebagai gantinya.

Properti definisi alat

Setiap alat dalam array tools, termasuk alat yang ditentukan pengguna, menerima properti opsional yang mengontrol cara alat dimuat, siapa yang dapat memanggilnya, dan bagaimana inputnya divalidasi. Properti ini dapat digabungkan: Anda dapat mengatur defer_loading dan cache_control dan strict pada alat yang sama.

Nilai allowed_callers

allowed_callers adalah array yang menerima kombinasi apa pun dari:

Menghilangkan "direct" dari array (misalnya, "allowed_callers": ["code_execution_20260120"]) berarti alat hanya dapat dipanggil dari dalam eksekusi kode. Blok tool_use respons menyertakan bidang caller yang mengidentifikasi pemanggil mana yang memanggil alat. Lihat Pemanggilan alat terprogram untuk perlakuan lengkap, termasuk bentuk respons caller dan perilaku kesalahan.

defer_loading dan prompt caching

Alat dengan defer_loading: true dilepas dari bagian alat yang dirender sebelum kunci cache dihitung. Mereka tidak muncul dalam awalan prompt sistem sama sekali. Ketika pencarian alat menemukan alat yang ditunda dan mengembalikan tool_reference untuknya, definisi lengkap alat diperluas inline pada titik itu dalam badan percakapan, bukan dalam awalan.

Ini berarti defer_loading: true melestarikan cache prompt Anda. Anda dapat menambahkan alat yang ditunda ke permintaan tanpa membatalkan entri cache yang ada, dan cache tetap valid di seluruh giliran di mana alat ditemukan dan giliran di mana alat dipanggil.

Untuk cara menggabungkan defer_loading dengan breakpoint cache_control, lihat panduan prompt caching Alat pencarian alat.