Referensi alat

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



Alat yang disediakan Anthropic

Anthropic menyediakan dua jenis alat: server tools (alat server) yang dieksekusi di infrastruktur Anthropic, dan client tools (alat klien) di mana Anthropic mendefinisikan skemanya tetapi aplikasi Anda yang menangani eksekusinya. Kedua jenis ini muncul dalam array tools pada permintaan Anda bersama dengan alat yang didefinisikan pengguna.

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



Versi alat

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

Ketika sebuah alat memiliki beberapa versi aktif, hubungan di antara versi-versi tersebut bervariasi:

• Berdasarkan kapabilitas: web_search_20260209 dan web_fetch_20260209 menambahkan pemfilteran konten dinamis dibandingkan pendahulunya; web_fetch_20260309 menambahkan opsi untuk melewati cache; web_search_20260318 dan web_fetch_20260318 menambahkan kontrol penyertaan respons. code_execution_20260120 menambahkan pemanggilan alat secara programatik dari dalam sandbox; code_execution_20260521 mengungkapkan batas waktu per sel dalam deskripsi alat. Dalam setiap kasus, baik versi baru maupun lama sama-sama terkini; versi mana yang Anda gunakan bergantung pada apakah Anda memerlukan kapabilitas baru tersebut.
• Berdasarkan model: text_editor_20250728 ditujukan untuk model Claude 4 dan text_editor_20250124 untuk model yang lebih lama. Versi yang Anda gunakan bergantung 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 bersamaan. 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 diberi versi berdasarkan tanggal; penentuan versinya dilakukan melalui header anthropic-beta.



Properti definisi alat

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



Nilai allowed_callers

allowed_callers adalah array yang menerima kombinasi apa pun dari:

Baik "code_execution_20260120" maupun "code_execution_20260521" diterima dalam allowed_callers dan dapat dipertukarkan: permintaan yang menggunakan salah satu versi alat eksekusi kode memenuhi syarat untuk alat yang mencantumkan salah satu pemanggil tersebut. Blok respons selalu menandai pemanggil sebagai code_execution_20260120 terlepas dari versi mana yang dideklarasikan dalam permintaan.

Menghilangkan "direct" dari array (misalnya, "allowed_callers": ["code_execution_20260120"]) mengarahkan Claude untuk memanggil alat hanya dari dalam eksekusi kode. Blok tool_use dalam respons menyertakan field caller yang mengidentifikasi pemanggil mana yang memanggil alat tersebut. Lihat Pemanggilan alat secara programatik untuk penjelasan lengkap, termasuk bentuk respons caller dan perilaku error.



defer_loading dan caching prompt

Alat dengan defer_loading: true dihapus dari bagian alat yang dirender sebelum kunci cache dihitung. Alat-alat tersebut tidak muncul sama sekali dalam prefiks prompt sistem. Ketika pencarian alat menemukan alat yang ditangguhkan dan mengembalikan tool_reference untuknya, definisi lengkap alat tersebut diperluas secara inline pada titik tersebut dalam isi percakapan, bukan dalam prefiks.

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

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