Strumenti

Configurazione del set di strumenti

Abilita il set di strumenti completo con agent_toolset_20260401 durante la creazione di un agente. Usa l'array configs per disabilitare strumenti specifici o sovrascrivere le loro impostazioni.

Disabilitare strumenti specifici

Per disabilitare uno strumento, imposta enabled: false nella sua voce di configurazione:

Abilitare solo strumenti specifici

Per iniziare con tutto disabilitato e abilitare solo ciò di cui hai bisogno, imposta default_config.enabled su false:

Strumenti personalizzati

Oltre agli strumenti integrati, puoi definire strumenti personalizzati. Gli strumenti personalizzati sono analoghi agli strumenti client definiti dall'utente nell'API Messages.

Gli strumenti personalizzati ti consentono di estendere le capacità di Claude per eseguire una più ampia varietà di compiti. Ogni strumento definisce un contratto: specifichi quali operazioni sono disponibili e cosa restituiscono; Claude decide quando e come chiamarle. Il modello non esegue mai nulla da solo. Emette una richiesta strutturata, il tuo codice esegue l'operazione e il risultato ritorna nella conversazione.

Una volta definito lo strumento a livello di agente, l'agente invocherà gli strumenti nel corso di una sessione. Consulta Flusso di eventi della sessione per il flusso completo.

Best practice per le definizioni di strumenti personalizzati

• Fornisci descrizioni estremamente dettagliate. Questo è di gran lunga il fattore più importante nelle prestazioni degli strumenti. Le tue descrizioni dovrebbero spiegare cosa fa lo strumento, quando dovrebbe essere utilizzato (e quando non dovrebbe), cosa significa ogni parametro e come influisce sul comportamento dello strumento, e qualsiasi avvertenza o limitazione importante. Più contesto puoi fornire a Claude sui tuoi strumenti, meglio sarà nel decidere quando e come usarli. Punta ad almeno 3-4 frasi per descrizione dello strumento, di più se lo strumento è complesso.
• Consolida le operazioni correlate in meno strumenti. Invece di creare uno strumento separato per ogni azione (create_pr, review_pr, merge_pr), raggruppale in un unico strumento con un parametro action. Meno strumenti, ma più capaci, riducono l'ambiguità nella selezione e rendono la tua superficie di strumenti più facile da navigare per Claude.
• Usa una denominazione significativa nei nomi degli strumenti. Quando i tuoi strumenti coprono più servizi o risorse, aggiungi un prefisso con la risorsa (es. db_query, storage_read). Questo rende la selezione degli strumenti inequivocabile man mano che la tua libreria cresce.
• Progetta le risposte degli strumenti per restituire solo informazioni ad alto segnale. Restituisci identificatori semantici e stabili (es. slug o UUID) piuttosto che riferimenti interni opachi, e includi solo i campi di cui Claude ha bisogno per ragionare sul suo passo successivo. Le risposte gonfiate sprecano contesto e rendono più difficile per Claude estrarre ciò che conta.