Combinazioni di strumenti

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

Ogni snippet mostra solo l'array tools. Vedi Gestire le chiamate agli strumenti per la forma completa della richiesta.

Agente di ricerca: web_search + code_execution

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

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

Il flusso è tipicamente ricerca, quindi esecuzione, quindi facoltativamente ricerca di nuovo se il primo passaggio ha evidenziato una lacuna. L'esecuzione del codice viene eseguita lato server, quindi non c'è sandbox lato client da gestire.

Agente di codifica: text_editor + bash

L'editor di testo legge e modifica i file; bash esegue test e comandi di build. Questo è il ciclo canonico dello sviluppo software: ispeziona il codice, fai una modifica, esegui i test, ripeti. Entrambi gli strumenti vengono eseguiti dal 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 un elenco di comandi consentiti se l'agente opera su codice non attendibile. Vedi Strumento editor di testo e Strumento Bash per i contratti di esecuzione.

Cita-poi-recupera: web_search + web_fetch

La ricerca fa emergere URL candidati; il recupero recupera il contenuto completo della pagina per quelli rilevanti. Questo evita di recuperare tutto in anticipo. Claude esegue una ricerca, ispeziona i frammenti, 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 in forma lunga (pagine di documentazione, articoli, specifiche) che uno snippet di ricerca non può catturare completamente. Il recupero estrae la pagina completa in modo che Claude possa citare passaggi specifici.

Agente a lunga esecuzione: memory + qualsiasi set di strumenti

La memoria persiste lo stato tra le conversazioni; gli altri strumenti svolgono il lavoro. Aggiungi memoria a qualsiasi agente che ha bisogno di ricordare 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 i tuoi altri strumenti insieme a memory nello stesso array.

La memoria è ortogonale al resto del tuo set di strumenti. Non cambia il modo in cui gli altri strumenti si comportano; dà a Claude un posto dove scrivere e successivamente recuperare fatti che altrimenti andrebbero persi quando la finestra di contesto si ripristina. Vedi Strumento Memory per il modello di archiviazione.

All-in-one: computer_use

Lo strumento computer use sostituisce la maggior parte degli altri operando su un desktop completo. Claude vede screenshot e emette azioni del mouse e della tastiera, il che significa che può guidare qualsiasi applicazione che un umano può. Usalo quando l'attività 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 si estendono su più app desktop.

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

Computer use è l'opzione più generale ed è anche la più lenta, poiché ogni azione richiede un roundtrip di screenshot. Preferisci strumenti più ristretti quando coprono il tuo caso d'uso e ricorri a computer use quando nient'altro si adatta. Vedi Strumento Computer use per la configurazione della sandbox.

Passaggi successivi