Riferimento agli strumenti

Questa pagina è un riferimento per gli strumenti forniti da Anthropic e per 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 eventuali strumenti definiti 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 cambiano il comportamento, lo schema o il supporto dei modelli dello strumento. 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:

• Basate sulle funzionalità: 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 sull'inclusione della 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 ciascun caso, sia la nuova versione che quella precedente sono attuali; quale utilizzare dipende dal fatto che tu abbia bisogno o meno della nuova funzionalità.
• Basate sul modello: text_editor_20250728 è per i modelli Claude 4 e text_editor_20250124 è per i modelli precedenti. La versione da utilizzare 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 operazioni sui file.

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



Proprietà delle definizioni 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à sono componibili: puoi impostare defer_loading, 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 utilizza una delle due versioni dello strumento di esecuzione codice soddisfa gli strumenti che elencano uno qualsiasi 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 di cache. Non compaiono affatto nel prefisso del prompt di sistema. Quando la ricerca strumenti individua 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.

Ciò 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 sia nel turno in cui lo strumento viene individuato sia nel turno in cui viene chiamato.

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