Riferimento degli strumenti

Questa pagina è un riferimento per gli strumenti forniti da Anthropic e le proprietà facoltative che puoi impostare su qualsiasi definizione di strumento. Per un'introduzione concettuale all'uso degli strumenti, vedi Uso degli strumenti con Claude. Per una guida sull'implementazione dell'uso degli strumenti nella tua applicazione, vedi 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 dove Anthropic definisce lo schema ma la tua applicazione gestisce l'esecuzione. Entrambi i tipi appaiono nell'array tools della tua richiesta insieme a qualsiasi strumento definito dall'utente.

Per la compatibilità dei modelli, vedi la pagina di ogni 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 ha un suffisso _YYYYMMDD nella stringa type. Una nuova versione viene rilasciata quando il comportamento, lo schema o il supporto del modello 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 loro varia:

• Basato su capacità: web_search_20260209 e web_fetch_20260209 aggiungono filtri di contenuto dinamico rispetto ai loro predecessori. code_execution_20260120 aggiunge chiamate di strumenti programmatiche dall'interno della sandbox. In ogni caso, sia la nuova che la vecchia versione sono attuali; quale usi dipende dal fatto che tu abbia bisogno della nuova capacità.
• Basato su modello: text_editor_20250728 è per i modelli Claude 4 e text_editor_20250124 è per i modelli precedenti. La versione che usi dipende dal modello che stai prendendo di mira.
• 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 su file.

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

Proprietà della definizione degli strumenti

Ogni strumento nell'array tools, inclusi gli strumenti definiti dall'utente, accetta proprietà facoltative che controllano come lo strumento viene caricato, chi può chiamarlo e come i suoi input vengono convalidati. 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:

Omettere "direct" dall'array (ad esempio, "allowed_callers": ["code_execution_20260120"]) significa che lo strumento è chiamabile 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. Vedi Chiamate di strumenti programmatiche per il trattamento completo, inclusa la forma della risposta caller e il comportamento degli errori.

defer_loading e prompt caching

Gli strumenti con defer_loading: true vengono rimossi dalla sezione degli strumenti renderizzati prima che la chiave della cache venga calcolata. Non appaiono 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 a quel punto nel corpo della conversazione, non nel prefisso.

Ciò significa che defer_loading: true preserva la tua cache del 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, vedi la guida al prompt caching dello strumento di ricerca degli strumenti.