Referensi alat

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



Alat yang disediakan Anthropic

Anthropic menyediakan dua jenis alat: server tools (alat server) yang dieksekusi pada 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.



Pemversian alat

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

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

• Berbasis kemampuan: web_search_20260209 dan web_fetch_20260209 menambahkan pemfilteran konten dinamis dibandingkan pendahulunya; web_fetch_20260309 menambahkan opsi pelewatan cache; web_search_20260318 dan web_fetch_20260318 menambahkan kontrol penyertaan respons. code_execution_20260120 menambahkan pemanggilan alat terprogram 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 kemampuan baru tersebut.
• Berbasis model: text_editor_20250728 untuk model Claude 4 dan yang lebih baru, 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.
• Warisan: code_execution_20250522 hanya mendukung Python. code_execution_20250825 menambahkan Bash dan operasi file.

Tipe mcp_toolset tidak diversikan berdasarkan tanggal; pemversian 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 menetapkan defer_loading dan 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 alat yang mencantumkan salah satu pemanggil tersebut. Blok respons selalu menandai pemanggil sebagai code_execution_20260120 terlepas dari versi mana yang dideklarasikan oleh permintaan.

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



defer_loading dan caching prompt

Alat dengan defer_loading: true dihapus dari bagian alat yang dirender sebelum kunci cache dihitung. Alat tersebut sama sekali tidak muncul 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 badan 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 sepanjang giliran di mana alat ditemukan dan giliran di mana alat tersebut dipanggil.

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