Combinazioni di strumenti

Gli strumenti forniti da Anthropic sono progettati per funzionare insieme. I pattern comuni per gli agenti abbinano strumenti che coprono fasi complementari di un flusso di lavoro: uno strumento raccoglie o scopre, un altro elabora o agisce. Le combinazioni riportate di seguito sono punti di partenza, non prescrizioni. Combinale per adattarle al tuo compito.

Ogni frammento mostra solo l'array tools. Consulta Gestire le chiamate agli strumenti per la struttura completa della richiesta.

Agente di ricerca: web_search + code_execution

La ricerca trova le fonti; l'esecuzione del codice analizza e sintetizza. Claude cerca i dati, poi scrive codice Python per elaborarli, tabularli o visualizzarli. Questo abbinamento è adatto a domande che richiedono sia informazioni aggiornate sia calcoli non banali su tali informazioni, come "confronta gli utili di questo trimestre tra i cinque principali fornitori cloud".

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20260521", "name": "code_execution" }
  ]
}

Il flusso è tipicamente: ricerca, poi esecuzione, poi eventualmente una nuova ricerca se il primo passaggio ha evidenziato una lacuna. L'esecuzione del codice avviene lato server, quindi non c'è alcuna sandbox lato client da gestire.

Agente di programmazione: text_editor + bash

L'editor di testo legge e modifica i file; bash esegue i test e i comandi di build. Questo è il ciclo canonico dello sviluppo software: ispeziona il codice, apporta una modifica, esegui i test, ripeti. Entrambi gli strumenti sono eseguiti lato client, quindi la tua applicazione controlla quali file e comandi sono accessibili.

{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}

Abbina questa configurazione a una directory di lavoro vincolata e a una allowlist di comandi se l'agente opera su codice non attendibile. Consulta Strumento editor di testo e Strumento Bash per i contratti di esecuzione.

Cita-poi-recupera: web_search + web_fetch

La ricerca fa emergere gli URL candidati; il fetch recupera il contenuto completo della pagina per quelli rilevanti. Questo evita di recuperare tutto in anticipo. Claude esegue una ricerca, ispeziona gli snippet, sceglie i due o tre risultati che sembrano effettivamente rilevanti e recupera solo quelli.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}

Questo abbinamento è utile quando la risposta si trova in contenuti lunghi (pagine di documentazione, articoli, specifiche) che uno snippet di ricerca non può catturare completamente. Il fetch recupera la pagina completa in modo che Claude possa citare passaggi specifici.

Agente a lunga esecuzione: memory + qualsiasi altro strumento

La memoria mantiene lo stato tra le conversazioni; gli altri strumenti svolgono il lavoro. Aggiungi la memoria a qualsiasi agente che debba ricordare le sessioni precedenti, come un agente di supporto che richiama i problemi precedenti di un cliente o un assistente di progetto che tiene traccia delle decisioni prese la settimana scorsa.

{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}

Aggiungi gli altri tuoi strumenti accanto a memory nello stesso array.

La memoria è ortogonale rispetto agli altri strumenti. Non cambia il loro comportamento; offre a Claude un luogo dove annotare e successivamente recuperare fatti che altrimenti andrebbero persi quando la "context window" (finestra di contesto) viene reimpostata. Consulta Strumento memoria per il modello di archiviazione.

Tutto in uno: computer_use

Lo strumento computer use ingloba la maggior parte degli altri operando su un desktop completo. Claude vede gli screenshot ed emette azioni di mouse e tastiera, il che significa che può pilotare qualsiasi applicazione utilizzabile da un essere umano. Usalo quando il compito richiede un'interazione GUI arbitraria che strumenti più specifici non possono raggiungere: software legacy senza API, passaggi di verifica visiva o flussi di lavoro che coinvolgono più applicazioni desktop.

{
  "tools": [{ "type": "computer_toolset_20260801" }]
}

La voce del toolset non accetta name né dimensioni di visualizzazione: le coordinate sono espresse nello spazio in pixel degli screenshot che restituisci, e puoi disattivare singole azioni tramite il campo configs della voce.

Computer use è l'opzione più generale e anche la più lenta, perché Claude in genere ha bisogno di un nuovo screenshot dopo ogni gruppo di azioni. Preferisci strumenti più mirati quando coprono il tuo caso d'uso e ricorri a computer use quando nient'altro è adatto. Se il compito rimane all'interno di un browser web, usa il pattern dell'agente browser nella sezione successiva. Consulta Strumento computer use per la configurazione della sandbox.

Agente browser: browser_use

Quando l'intero compito si svolge all'interno di pagine web (compilare moduli, leggere il contenuto delle pagine, lavorare su più schede), lo strumento browser use è più adatto rispetto a computer use. La tua applicazione pilota un browser che controlla e restituisce screenshot o lo stato della pagina; Claude chiama strumenti membri consapevoli della pagina come read_page, find, form_input e get_page_text insieme a clic e digitazione, così può agire su riferimenti agli elementi oltre che su coordinate in pixel.

{
  "tools": [{ "type": "browser_toolset_20260801" }]
}

Come il toolset computer use, la voce non accetta name, e puoi disattivare i singoli strumenti membri tramite il suo campo configs. Consulta Strumento browser use per il contratto di esecuzione.

Passaggi successivi