Outil de recherche web
L’outil de recherche web donne à Claude un accès direct au contenu web en temps réel, lui permettant de répondre aux questions avec des informations à jour au-delà de sa limite de connaissances.
L’outil de recherche web donne à Claude un accès direct au contenu web en temps réel, lui permettant de répondre aux questions avec des informations à jour au-delà de sa limite de connaissances. Claude cite automatiquement les sources des résultats de recherche dans le cadre de sa réponse.
Veuillez nous contacter via notre formulaire de commentaires pour partager votre expérience avec l’outil de recherche web.
Modèles pris en charge
La recherche web est disponible sur :
- Claude Opus 4 (
claude-opus-4-20250514
) - Claude Sonnet 4 (
claude-sonnet-4-20250514
) - Claude Sonnet 3.7 (
claude-3-7-sonnet-20250219
) - Claude Sonnet 3.5 (nouveau) (
claude-3-5-sonnet-latest
) - Claude Haiku 3.5 (
claude-3-5-haiku-latest
)
Comment fonctionne la recherche web
Lorsque vous ajoutez l’outil de recherche web à votre requête API :
- Claude décide quand effectuer une recherche en fonction de l’invite.
- L’API exécute les recherches et fournit à Claude les résultats. Ce processus peut se répéter plusieurs fois au cours d’une seule requête.
- À la fin de son tour, Claude fournit une réponse finale avec des sources citées.
Comment utiliser la recherche web
L’administrateur de votre organisation doit activer la recherche web dans la Console.
Fournissez l’outil de recherche web dans votre requête API :
Définition de l’outil
L’outil de recherche web prend en charge les paramètres suivants :
Utilisations maximales
Le paramètre max_uses
limite le nombre de recherches effectuées. Si Claude tente plus de recherches que autorisé, le web_search_tool_result
sera une erreur avec le code d’erreur max_uses_exceeded
.
Filtrage de domaines
Lors de l’utilisation de filtres de domaines :
- Les domaines ne doivent pas inclure le schéma HTTP/HTTPS (utilisez
example.com
au lieu dehttps://example.com
) - Les sous-domaines sont automatiquement inclus (
example.com
couvredocs.example.com
) - Les sous-chemins sont pris en charge (
example.com/blog
) - Vous pouvez utiliser soit
allowed_domains
soitblocked_domains
, mais pas les deux dans la même requête.
Localisation
Le paramètre user_location
vous permet de localiser les résultats de recherche en fonction de l’emplacement d’un utilisateur.
type
: Le type d’emplacement (doit êtreapproximate
)city
: Le nom de la villeregion
: La région ou l’étatcountry
: Le paystimezone
: L’ID de fuseau horaire IANA.
Réponse
Voici un exemple de structure de réponse :
Résultats de recherche
Les résultats de recherche incluent :
url
: L’URL de la page sourcetitle
: Le titre de la page sourcepage_age
: Quand le site a été mis à jour pour la dernière foisencrypted_content
: Contenu chiffré qui doit être renvoyé dans les conversations multi-tours pour les citations
Citations
Les citations sont toujours activées pour la recherche web, et chaque web_search_result_location
inclut :
url
: L’URL de la source citéetitle
: Le titre de la source citéeencrypted_index
: Une référence qui doit être renvoyée pour les conversations multi-tours.cited_text
: Jusqu’à 150 caractères du contenu cité
Les champs de citation de recherche web cited_text
, title
, et url
ne comptent pas dans l’utilisation des jetons d’entrée ou de sortie.
Lors de l’affichage des résultats web ou des informations contenues dans les résultats web aux utilisateurs finaux, les citations en ligne doivent être clairement visibles et cliquables dans votre interface utilisateur.
Erreurs
Si une erreur se produit pendant la recherche web, vous recevrez une réponse qui prend la forme suivante :
Voici les codes d’erreur possibles :
too_many_requests
: Limite de taux dépasséeinvalid_input
: Paramètre de requête de recherche invalidemax_uses_exceeded
: Utilisations maximales de l’outil de recherche web dépasséesquery_too_long
: La requête dépasse la longueur maximaleunavailable
: Une erreur interne s’est produite
Raison d’arrêt pause_turn
La réponse peut inclure une raison d’arrêt pause_turn
, qui indique que l’API a mis en pause un tour de longue durée. Vous pouvez fournir la réponse telle quelle dans une requête ultérieure pour laisser Claude continuer son tour, ou modifier le contenu si vous souhaitez interrompre la conversation.
Mise en cache des invites
La recherche web fonctionne avec la mise en cache des invites. Pour activer la mise en cache des invites, ajoutez au moins un point d’arrêt cache_control
dans votre requête. Le système mettra automatiquement en cache jusqu’au dernier bloc web_search_tool_result
lors de l’exécution de l’outil.
Pour les conversations multi-tours, définissez un point d’arrêt cache_control
sur ou après le dernier bloc web_search_tool_result
pour réutiliser le contenu mis en cache.
Par exemple, pour utiliser la mise en cache des invites avec la recherche web pour une conversation multi-tours :
Streaming
Avec le streaming activé, vous recevrez des événements de recherche dans le cadre du flux. Il y aura une pause pendant l’exécution de la recherche :
Requêtes par lots
Vous pouvez inclure l’outil de recherche web dans l’API Messages Batches. Les appels d’outil de recherche web via l’API Messages Batches sont facturés de la même manière que ceux dans les requêtes API Messages régulières.
Utilisation et tarification
Web search usage is charged in addition to token usage:
Web search is available on the Anthropic API for $10 per 1,000 searches, plus standard token costs for search-generated content. Web search results retrieved throughout a conversation are counted as input tokens, in search iterations executed during a single turn and in subsequent conversation turns.
Each web search counts as one use, regardless of the number of results returned. If an error occurs during web search, the web search will not be billed.