- 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 (déprécié) (
claude-3-7-sonnet-20250219) - Claude 3.5 Haiku (
claude-3-5-haiku-20241022)
Avantages clés
- Citations naturelles - Obtenez la même qualité de citation que la recherche web pour n’importe quel contenu
- Intégration flexible - Utilisez dans les retours d’outils pour la RAG dynamique ou comme contenu de haut niveau pour les données pré-récupérées
- Attribution de source appropriée - Chaque résultat inclut les informations de source et de titre pour une attribution claire
- Aucune solution de contournement de document nécessaire - Élimine le besoin de solutions de contournement basées sur des documents
- Format de citation cohérent - Correspond à la qualité et au format de citation de la fonctionnalité de recherche web de Claude
Comment ça marche
Les résultats de recherche peuvent être fournis de deux façons :- À partir d’appels d’outils - Vos outils personnalisés retournent des résultats de recherche, permettant des applications RAG dynamiques
- Comme contenu de haut niveau - Vous fournissez les résultats de recherche directement dans les messages utilisateur pour le contenu pré-récupéré ou mis en cache
Schéma des résultats de recherche
Les résultats de recherche utilisent la structure suivante :Champs obligatoires
| Champ | Type | Description |
|---|---|---|
type | string | Doit être "search_result" |
source | string | L’URL source ou l’identifiant du contenu |
title | string | Un titre descriptif pour le résultat de recherche |
content | array | Un tableau de blocs de texte contenant le contenu réel |
Champs optionnels
| Champ | Type | Description |
|---|---|---|
citations | object | Configuration des citations avec le champ booléen enabled |
cache_control | object | Paramètres de contrôle du cache (par exemple, {"type": "ephemeral"}) |
content doit être un bloc de texte avec :
type: Doit être"text"text: Le contenu textuel réel (chaîne non vide)
Méthode 1 : Résultats de recherche à partir d’appels d’outils
Le cas d’usage le plus puissant est de retourner les résultats de recherche à partir de vos outils personnalisés. Cela permet des applications RAG dynamiques où les outils récupèrent et retournent le contenu pertinent avec des citations automatiques.Exemple : Outil de base de connaissances
Méthode 2 : Résultats de recherche comme contenu de haut niveau
Vous pouvez également fournir les résultats de recherche directement dans les messages utilisateur. Ceci est utile pour :- Le contenu pré-récupéré de votre infrastructure de recherche
- Les résultats de recherche mis en cache à partir de requêtes précédentes
- Le contenu provenant de services de recherche externes
- Les tests et le développement
Exemple : Résultats de recherche directs
Réponse de Claude avec citations
Indépendamment de la façon dont les résultats de recherche sont fournis, Claude inclut automatiquement les citations lors de l’utilisation d’informations provenant de ceux-ci :Champs de citation
Chaque citation inclut :| Champ | Type | Description |
|---|---|---|
type | string | Toujours "search_result_location" pour les citations de résultats de recherche |
source | string | La source du résultat de recherche original |
title | string ou null | Le titre du résultat de recherche original |
cited_text | string | Le texte exact en cours de citation |
search_result_index | integer | Index du résultat de recherche (basé sur 0) |
start_block_index | integer | Position de départ dans le tableau de contenu |
end_block_index | integer | Position de fin dans le tableau de contenu |
search_result_index fait référence à l’index du bloc de contenu du résultat de recherche (basé sur 0), indépendamment de la façon dont les résultats de recherche ont été fournis (appel d’outil ou contenu de haut niveau).
Blocs de contenu multiples
Les résultats de recherche peuvent contenir plusieurs blocs de texte dans le tableaucontent :
start_block_index et end_block_index.
Utilisation avancée
Combinaison des deux méthodes
Vous pouvez utiliser à la fois les résultats de recherche basés sur des outils et de haut niveau dans la même conversation :Combinaison avec d’autres types de contenu
Les deux méthodes supportent le mélange des résultats de recherche avec d’autres contenus :Contrôle du cache
Ajoutez le contrôle du cache pour de meilleures performances :Contrôle des citations
Par défaut, les citations sont désactivées pour les résultats de recherche. Vous pouvez activer les citations en définissant explicitement la configurationcitations :
citations.enabled est défini sur true, Claude inclura des références de citation lors de l’utilisation d’informations du résultat de recherche. Cela permet :
- Les citations naturelles pour vos applications RAG personnalisées
- L’attribution de source lors de l’interfaçage avec des bases de connaissances propriétaires
- Les citations de qualité web pour tout outil personnalisé qui retourne des résultats de recherche
citations est omis, les citations sont désactivées par défaut.
Les citations sont tout ou rien : soit tous les résultats de recherche dans une requête doivent avoir les citations activées, soit tous doivent les avoir désactivées. Le mélange de résultats de recherche avec des paramètres de citation différents entraînera une erreur. Si vous avez besoin de désactiver les citations pour certaines sources, vous devez les désactiver pour tous les résultats de recherche dans cette requête.
Meilleures pratiques
Pour la recherche basée sur des outils (Méthode 1)
- Contenu dynamique : Utilisez pour les recherches en temps réel et les applications RAG dynamiques
- Gestion des erreurs : Retournez les messages appropriés lorsque les recherches échouent
- Limites des résultats : Retournez uniquement les résultats les plus pertinents pour éviter le débordement de contexte
Pour la recherche de haut niveau (Méthode 2)
- Contenu pré-récupéré : Utilisez lorsque vous avez déjà des résultats de recherche
- Traitement par lot : Idéal pour traiter plusieurs résultats de recherche à la fois
- Tests : Excellent pour tester le comportement des citations avec un contenu connu
Meilleures pratiques générales
-
Structurez les résultats efficacement
- Utilisez des URL source claires et permanentes
- Fournissez des titres descriptifs
- Divisez le contenu long en blocs de texte logiques
-
Maintenez la cohérence
- Utilisez des formats de source cohérents dans votre application
- Assurez-vous que les titres reflètent avec précision le contenu
- Conservez la mise en forme cohérente
-
Gérez les erreurs avec élégance
Limitations
- Les blocs de contenu des résultats de recherche sont disponibles sur l’API Claude et sur Vertex AI de Google Cloud
- Seul le contenu textuel est supporté dans les résultats de recherche (pas d’images ou d’autres médias)
- Le tableau
contentdoit contenir au moins un bloc de texte