Résultats de recherche
Activez les citations naturelles pour les applications RAG en fournissant des résultats de recherche avec attribution de source
Les blocs de contenu de résultats de recherche sont actuellement en version bêta. Utilisez l’en-tête bêta search-results-2025-06-09
pour activer cette fonctionnalité.
Les blocs de contenu de résultats de recherche permettent des citations naturelles avec une attribution de source appropriée, apportant des citations de qualité de recherche web à vos applications personnalisées. Cette fonctionnalité est particulièrement puissante pour les applications RAG (Génération Augmentée par Récupération) où vous avez besoin que Claude cite les sources avec précision.
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 un RAG dynamique ou comme contenu de niveau supérieur pour des données pré-récupérées
- Attribution de source appropriée - Chaque résultat inclut des 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 fonctionne
Les résultats de recherche peuvent être fournis de deux manières :
- À partir d’appels d’outils - Vos outils personnalisés retournent des résultats de recherche, permettant des applications RAG dynamiques
- Comme contenu de niveau supérieur - Vous fournissez des résultats de recherche directement dans les messages utilisateur pour du contenu pré-récupéré ou mis en cache
Dans les deux cas, Claude peut automatiquement citer des informations des résultats de recherche avec une attribution de source appropriée.
Schéma de résultat de recherche
Les résultats de recherche utilisent la structure suivante :
Champs requis
Champ | Type | Description |
---|---|---|
type | string | Doit être "search_result" |
source | string | L’URL ou identifiant de source pour le 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 de citation avec champ booléen enabled |
cache_control | object | Paramètres de contrôle de cache (par ex., {"type": "ephemeral"} ) |
Chaque élément dans le tableau 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 des résultats de recherche à partir de vos outils personnalisés. Cela permet des applications RAG dynamiques où les outils récupèrent et retournent du contenu pertinent avec des citations automatiques.
Exemple : Outil de base de connaissances
Méthode 2 : Résultats de recherche comme contenu de niveau supérieur
Vous pouvez également fournir des résultats de recherche directement dans les messages utilisateur. Ceci est utile pour :
- Du contenu pré-récupéré de votre infrastructure de recherche
- Des résultats de recherche mis en cache de requêtes précédentes
- Du contenu de services de recherche externes
- Les tests et le développement
Exemple : Résultats de recherche directs
Réponse de Claude avec citations
Peu importe comment les résultats de recherche sont fournis, Claude inclut automatiquement des citations lors de l’utilisation d’informations 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 étant cité |
search_result_index | integer | Index du résultat de recherche (basé sur 0) |
start_block_index | integer | Position de début dans le tableau de contenu |
end_block_index | integer | Position de fin dans le tableau de contenu |
Note : Le search_result_index
fait référence à l’index du bloc de contenu de résultat de recherche (basé sur 0), peu importe comment les résultats de recherche ont été fournis (appel d’outil ou contenu de niveau supérieur).
Blocs de contenu multiples
Les résultats de recherche peuvent contenir plusieurs blocs de texte dans le tableau content
:
Claude peut citer des blocs spécifiques en utilisant les champs start_block_index
et end_block_index
.
Utilisation avancée
Combiner les deux méthodes
Vous pouvez utiliser à la fois les résultats de recherche basés sur des outils et de niveau supérieur dans la même conversation :
Combiner avec d’autres types de contenu
Les deux méthodes supportent le mélange de résultats de recherche avec d’autres contenus :
Contrôle de cache
Ajoutez un contrôle de cache pour de meilleures performances :
Contrôle de citation
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 configuration citations
:
Quand 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 :
- Des citations naturelles pour vos applications RAG personnalisées
- L’attribution de source lors de l’interface avec des bases de connaissances propriétaires
- Des citations de qualité de recherche web pour tout outil personnalisé qui retourne des résultats de recherche
Si le champ 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. Mélanger des résultats de recherche avec différents paramètres de citation résultera en une erreur. Si vous devez 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 des recherches en temps réel et des applications RAG dynamiques
- Gestion d’erreurs : Retournez des messages appropriés quand les recherches échouent
- Limites de résultats : Retournez seulement les résultats les plus pertinents pour éviter le débordement de contexte
Pour la recherche de niveau supérieur (Méthode 2)
- Contenu pré-récupéré : Utilisez quand vous avez déjà des résultats de recherche
- Traitement par lots : Idéal pour traiter plusieurs résultats de recherche à la fois
- Tests : Excellent pour tester le comportement de citation avec du contenu connu
Meilleures pratiques générales
-
Structurer les résultats efficacement
- Utilisez des URL de source claires et permanentes
- Fournissez des titres descriptifs
- Divisez le contenu long en blocs de texte logiques
-
Maintenir la cohérence
- Utilisez des formats de source cohérents dans votre application
- Assurez-vous que les titres reflètent fidèlement le contenu
- Gardez un formatage cohérent
-
Gérer les erreurs gracieusement
Limitations
- Les blocs de contenu de résultats de recherche ne sont disponibles qu’avec l’en-tête bêta
- Seul le contenu texte est supporté dans les résultats de recherche (pas d’images ou autres médias)
- Le tableau
content
doit contenir au moins un bloc de texte