L'outil de recherche web integre
Claude dispose d’un outil integre de recherche web qui lui permet de chercher des informations sur Internet pour repondre aux questions des utilisateurs. Contrairement aux outils classiques, vous n’avez pas besoin d’ecrire l’implementation — Claude gere l’ensemble du processus de recherche automatiquement.
Prerequis : Votre organisation doit activer l’outil de recherche web dans la console de configuration : https://console.anthropic.com/settings/privacy
Configuration
Le schema est minimal — il suffit de declarer l’outil avec quelques parametres :
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}Le champ max_uses limite le nombre de recherches que Claude peut effectuer. Claude peut faire des recherches de suivi en fonction des premiers resultats, donc cette limite evite les appels excessifs a l’API. Une seule recherche retourne plusieurs resultats, mais Claude peut decider que des recherches supplementaires sont necessaires.
Structure de la reponse
Quand Claude utilise l’outil de recherche, la reponse contient plusieurs types de blocs :
| Type de bloc | Contenu |
|---|---|
| Text blocks | Explications de Claude sur ce qu’il fait |
| ServerToolUseBlock | La requete de recherche exacte utilisee |
| WebSearchToolResultBlock | Les resultats de la recherche |
| WebSearchResultBlock | Resultats individuels avec titres et URLs |
| Citation blocks | Textes cites qui appuient les reponses de Claude |
Les citations incluent le texte precis que Claude a utilise pour etayer ses reponses, avec les URLs sources correspondantes.
Restreindre les domaines de recherche
Vous pouvez limiter les recherches a des domaines specifiques avec le champ allowed_domains. C’est utile quand vous voulez des sources fiables et faisant autorite :
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5,
"allowed_domains": ["nih.gov"]
}Par exemple, pour des questions medicales, restreindre les recherches a PubMed (nih.gov) garantit des informations basees sur des preuves scientifiques plutot que du contenu de blog aleatoire.
Afficher les resultats
Les differents types de blocs dans la reponse sont concus pour un rendu UI specifique :
- Blocs texte : afficher comme du contenu classique
- Resultats de recherche : afficher sous forme de liste de sources
- Citations : afficher en ligne avec le texte, incluant le domaine source, le titre de la page, l’URL et le texte cite
Cette structure aide les utilisateurs a comprendre comment Claude est arrive a ses reponses et offre de la transparence sur les sources utilisees.
Cas d’usage ideaux
L’outil de recherche web fonctionne le mieux pour :
- Actualites et developpements recents
- Informations specialisees absentes des donnees d’entrainement de Claude
- Verification de faits et recherche de sources faisant autorite
- Taches de recherche necessitant des informations a jour
Il suffit d’inclure le schema dans la liste tools de vos appels API. Claude decidera automatiquement quand une recherche web serait utile pour repondre a la question de l’utilisateur.