Riferimento degli strumenti

Questa pagina è un riferimento per gli strumenti forniti da Anthropic e le proprietà opzionali che puoi impostare su qualsiasi definizione di strumento. Per un'introduzione concettuale all'uso degli strumenti, consulta Uso degli strumenti con Claude. Per indicazioni sull'implementazione dell'uso degli strumenti nella tua applicazione, consulta Definire gli strumenti.



Strumenti forniti da Anthropic

Anthropic fornisce due tipi di strumenti: strumenti server che vengono eseguiti sull'infrastruttura di Anthropic, e strumenti client per i quali Anthropic definisce lo schema ma la tua applicazione gestisce l'esecuzione. Entrambi i tipi compaiono nell'array tools della tua richiesta insieme a qualsiasi strumento definito dall'utente.

Per la compatibilità con i modelli, consulta la pagina di ciascuno strumento. I modelli supportati variano in base allo strumento e alla versione dello strumento.



Versionamento degli strumenti

La maggior parte degli strumenti forniti da Anthropic include un suffisso _YYYYMMDD nella stringa type. Una nuova versione viene rilasciata quando il comportamento, lo schema o il supporto dei modelli dello strumento cambia. Le versioni precedenti rimangono disponibili in modo che le integrazioni esistenti continuino a funzionare.

Quando uno strumento ha più versioni attive, la relazione tra di esse varia:

• Basata sulle capacità: web_search_20260209 e web_fetch_20260209 aggiungono il filtraggio dinamico dei contenuti rispetto ai loro predecessori; web_fetch_20260309 aggiunge un'opzione per bypassare la cache; web_search_20260318 e web_fetch_20260318 aggiungono il controllo dell'inclusione nella risposta. code_execution_20260120 aggiunge la chiamata programmatica degli strumenti dall'interno della sandbox; code_execution_20260521 dichiara il limite di tempo per cella nella descrizione dello strumento. In ogni caso, sia la nuova che la vecchia versione sono attuali; quale usare dipende dal fatto che tu abbia bisogno o meno della nuova capacità.
• Basata sul modello: text_editor_20250728 è per Claude 4 e modelli successivi e text_editor_20250124 è per i modelli precedenti. La versione che usi dipende dal modello a cui ti rivolgi.
• Variante, non versione: tool_search_tool_regex_20251119 e tool_search_tool_bm25_20251119 sono due algoritmi di ricerca rilasciati insieme. Nessuno dei due sostituisce l'altro.
• Legacy: code_execution_20250522 supporta solo Python. code_execution_20250825 aggiunge Bash e le operazioni sui file.

Il tipo mcp_toolset non è versionato per data; il versionamento è invece gestito nell'header anthropic-beta.



Proprietà di definizione degli strumenti

Ogni strumento nell'array tools, inclusi gli strumenti definiti dall'utente, accetta proprietà opzionali che controllano come lo strumento viene caricato, chi può chiamarlo e come vengono validati i suoi input. Queste proprietà si compongono: puoi impostare defer_loading e cache_control e strict sullo stesso strumento.



Valori di allowed_callers

allowed_callers è un array che accetta qualsiasi combinazione di:

Sia "code_execution_20260120" che "code_execution_20260521" sono accettati in allowed_callers e sono intercambiabili: una richiesta che usa una qualsiasi delle due versioni dello strumento di esecuzione del codice soddisfa gli strumenti che elencano uno dei due chiamanti. I blocchi di risposta contrassegnano sempre il chiamante come code_execution_20260120 indipendentemente dalla versione dichiarata nella richiesta.

Omettere "direct" dall'array (ad esempio, "allowed_callers": ["code_execution_20260120"]) guida Claude a chiamare lo strumento solo dall'interno dell'esecuzione del codice. Il blocco tool_use della risposta include un campo caller che identifica quale chiamante ha chiamato lo strumento. Consulta Chiamata programmatica degli strumenti per la trattazione completa, inclusa la struttura della risposta caller e il comportamento in caso di errore.



defer_loading e cache dei prompt

Gli strumenti con defer_loading: true vengono rimossi dalla sezione degli strumenti renderizzata prima che venga calcolata la chiave della cache. Non compaiono affatto nel prefisso del prompt di sistema. Quando la ricerca degli strumenti scopre uno strumento differito e restituisce un tool_reference per esso, la definizione completa dello strumento viene espansa inline in quel punto del corpo della conversazione, non nel prefisso.

Questo significa che defer_loading: true preserva la tua cache dei prompt. Puoi aggiungere strumenti differiti a una richiesta senza invalidare una voce di cache esistente, e la cache rimane valida attraverso il turno in cui lo strumento viene scoperto e il turno in cui viene chiamato.

Per come combinare defer_loading con i punti di interruzione cache_control, consulta le indicazioni sulla cache dei prompt dello strumento di ricerca degli strumenti.