- Claude Opus 4.1 (
claude-opus-4-1-20250805) - Claude Opus 4 (
claude-opus-4-20250514) - Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) - Claude Sonnet 4 (
claude-sonnet-4-20250514) - Claude Sonnet 3.7 (deprecato) (
claude-3-7-sonnet-20250219) - Claude 3.5 Haiku (
claude-3-5-haiku-20241022)
Vantaggi principali
- Citazioni naturali - Ottieni la stessa qualità di citazione della ricerca web per qualsiasi contenuto
- Integrazione flessibile - Usa nei ritorni degli strumenti per RAG dinamico o come contenuto di primo livello per dati pre-recuperati
- Corretta attribuzione della fonte - Ogni risultato include informazioni sulla fonte e il titolo per una chiara attribuzione
- Nessun workaround basato su documenti necessario - Elimina la necessità di workaround basati su documenti
- Formato di citazione coerente - Corrisponde alla qualità e al formato delle citazioni della funzione di ricerca web di Claude
Come funziona
I risultati di ricerca possono essere forniti in due modi:- Dalle chiamate di strumenti - I tuoi strumenti personalizzati restituiscono risultati di ricerca, abilitando applicazioni RAG dinamiche
- Come contenuto di primo livello - Fornisci i risultati di ricerca direttamente nei messaggi dell’utente per contenuto pre-recuperato o memorizzato nella cache
Schema dei risultati di ricerca
I risultati di ricerca utilizzano la seguente struttura:Campi obbligatori
| Campo | Tipo | Descrizione |
|---|---|---|
type | string | Deve essere "search_result" |
source | string | L’URL della fonte o l’identificatore per il contenuto |
title | string | Un titolo descrittivo per il risultato di ricerca |
content | array | Un array di blocchi di testo contenenti il contenuto effettivo |
Campi facoltativi
| Campo | Tipo | Descrizione |
|---|---|---|
citations | object | Configurazione delle citazioni con campo booleano enabled |
cache_control | object | Impostazioni di controllo della cache (ad es. {"type": "ephemeral"}) |
content deve essere un blocco di testo con:
type: Deve essere"text"text: Il contenuto di testo effettivo (stringa non vuota)
Metodo 1: Risultati di ricerca dalle chiamate di strumenti
Il caso d’uso più potente è restituire i risultati di ricerca dai tuoi strumenti personalizzati. Questo abilita applicazioni RAG dinamiche dove gli strumenti recuperano e restituiscono contenuto rilevante con citazioni automatiche.Esempio: Strumento di base di conoscenza
Metodo 2: Risultati di ricerca come contenuto di primo livello
Puoi anche fornire i risultati di ricerca direttamente nei messaggi dell’utente. Questo è utile per:- Contenuto pre-recuperato dalla tua infrastruttura di ricerca
- Risultati di ricerca memorizzati nella cache da query precedenti
- Contenuto da servizi di ricerca esterni
- Test e sviluppo
Esempio: Risultati di ricerca diretti
Risposta di Claude con citazioni
Indipendentemente da come vengono forniti i risultati di ricerca, Claude include automaticamente le citazioni quando utilizza informazioni da essi:Campi di citazione
Ogni citazione include:| Campo | Tipo | Descrizione |
|---|---|---|
type | string | Sempre "search_result_location" per le citazioni dei risultati di ricerca |
source | string | La fonte dal risultato di ricerca originale |
title | string o null | Il titolo dal risultato di ricerca originale |
cited_text | string | Il testo esatto citato |
search_result_index | integer | Indice del risultato di ricerca (basato su 0) |
start_block_index | integer | Posizione iniziale nell’array di contenuto |
end_block_index | integer | Posizione finale nell’array di contenuto |
search_result_index si riferisce all’indice del blocco di contenuto del risultato di ricerca (basato su 0), indipendentemente da come sono stati forniti i risultati di ricerca (chiamata di strumento o contenuto di primo livello).
Blocchi di contenuto multipli
I risultati di ricerca possono contenere più blocchi di testo nell’arraycontent:
start_block_index e end_block_index.
Utilizzo avanzato
Combinazione di entrambi i metodi
Puoi usare sia i risultati di ricerca basati su strumenti che quelli di primo livello nella stessa conversazione:Combinazione con altri tipi di contenuto
Entrambi i metodi supportano la miscelazione di risultati di ricerca con altri contenuti:Controllo della cache
Aggiungi il controllo della cache per migliori prestazioni:Controllo delle citazioni
Per impostazione predefinita, le citazioni sono disabilitate per i risultati di ricerca. Puoi abilitare le citazioni impostando esplicitamente la configurazionecitations:
citations.enabled è impostato su true, Claude includerà riferimenti di citazione quando utilizza informazioni dal risultato di ricerca. Questo abilita:
- Citazioni naturali per le tue applicazioni RAG personalizzate
- Attribuzione della fonte quando si interfaccia con basi di conoscenza proprietarie
- Citazioni di qualità web search per qualsiasi strumento personalizzato che restituisce risultati di ricerca
citations viene omesso, le citazioni sono disabilitate per impostazione predefinita.
Le citazioni sono tutto o niente: o tutti i risultati di ricerca in una richiesta devono avere le citazioni abilitate, oppure tutti devono averle disabilitate. La miscelazione di risultati di ricerca con diverse impostazioni di citazione comporterà un errore. Se hai bisogno di disabilitare le citazioni per alcune fonti, devi disabilitarle per tutti i risultati di ricerca in quella richiesta.
Migliori pratiche
Per la ricerca basata su strumenti (Metodo 1)
- Contenuto dinamico: Usa per ricerche in tempo reale e applicazioni RAG dinamiche
- Gestione degli errori: Restituisci messaggi appropriati quando le ricerche falliscono
- Limiti dei risultati: Restituisci solo i risultati più rilevanti per evitare overflow del contesto
Per la ricerca di primo livello (Metodo 2)
- Contenuto pre-recuperato: Usa quando hai già i risultati di ricerca
- Elaborazione batch: Ideale per elaborare più risultati di ricerca contemporaneamente
- Test: Ottimo per testare il comportamento delle citazioni con contenuto noto
Migliori pratiche generali
-
Struttura i risultati in modo efficace
- Usa URL di fonte chiari e permanenti
- Fornisci titoli descrittivi
- Dividi il contenuto lungo in blocchi di testo logici
-
Mantieni la coerenza
- Usa formati di fonte coerenti in tutta l’applicazione
- Assicurati che i titoli riflettano accuratamente il contenuto
- Mantieni la formattazione coerente
-
Gestisci gli errori con eleganza
Limitazioni
- I blocchi di contenuto dei risultati di ricerca sono disponibili su Claude API e su Vertex AI di Google Cloud
- Solo il contenuto di testo è supportato all’interno dei risultati di ricerca (nessuna immagine o altro media)
- L’array
contentdeve contenere almeno un blocco di testo