Combinazioni di strumenti

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

Ogni snippet mostra solo l'array tools. Consulta Gestire le chiamate agli strumenti per la forma 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 Python per elaborarli, tabularli o visualizzarli. Questo abbinamento è adatto per domande che richiedono sia informazioni aggiornate sia calcoli non banali su tali informazioni, come "confronta gli utili di questo trimestre tra i primi cinque fornitori cloud."

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

Il flusso è tipicamente cercare, poi eseguire, poi opzionalmente cercare di nuovo se il primo passaggio ha fatto emergere una lacuna. L'esecuzione del codice avviene lato server, quindi non c'è alcuna sandbox lato client da gestire.



Agente di codifica: 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, fai 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 questo a una directory di lavoro vincolata e a una lista di comandi consentiti 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 di lunga forma (pagine di documentazione, articoli, specifiche) che uno snippet di ricerca non può catturare completamente. Il fetch estrae la pagina completa in modo che Claude possa citare passaggi specifici.



Agente a lunga esecuzione: memory + qualsiasi set di strumenti

La memoria mantiene lo stato tra le conversazioni; gli altri strumenti fanno il lavoro. Aggiungi la memoria a qualsiasi agente che deve ricordare le sessioni precedenti, come un agente di supporto che ricorda 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 strumenti insieme a memory nello stesso array.

La memoria è ortogonale al resto del tuo set di strumenti. Non cambia il comportamento degli altri strumenti; offre a Claude un posto dove annotare e successivamente recuperare fatti che altrimenti andrebbero persi quando la finestra di contesto si azzera. Consulta Strumento memory per il modello di archiviazione.



Tutto in uno: computer_use

Lo strumento di uso del computer 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ò guidare qualsiasi applicazione che un umano può usare. Usalo quando il compito richiede un'interazione GUI arbitraria che strumenti più specifici non possono raggiungere: software legacy senza un'API, passaggi di verifica visiva o flussi di lavoro che coinvolgono più app desktop.

{
  "tools": [
    {
      "type": "computer_20250124",
      "name": "computer",
      "display_width_px": 1280,
      "display_height_px": 800
    }
  ]
}

L'uso del computer è l'opzione più generale e anche la più lenta, poiché ogni azione richiede un round trip di screenshot. Preferisci strumenti più specifici quando coprono il tuo caso d'uso, e ricorri all'uso del computer quando nient'altro è adatto. Consulta Strumento di uso del computer per la configurazione della sandbox.



Prossimi passi