L'outil de recherche web

Après le text editor, voici un second outil intégré — et d’une espèce différente : la recherche web. Claude peut chercher sur Internet des informations actuelles ou spécialisées, mais contrairement à tous les outils vus jusqu’ici, vous n’implémentez rien : c’est un outil serveur, exécuté par l’infrastructure d’Anthropic. Claude gère l’ensemble du processus automatiquement — formuler la requête, lancer la recherche, lire les résultats, recommencer si besoin — sans qu’un seul aller-retour ne transite par votre code.

Configuration

Activer la recherche revient à ajouter un schéma à la liste d’outils :

web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5
}

Le champ max_uses mérite votre attention : il limite le nombre de recherches pour une même requête. Claude pratique volontiers la recherche itérative — une première requête, puis des recherches de suivi pour préciser ou recouper — et ce paramètre évite les appels excessifs : au-delà de la latence, chaque recherche est facturée, et un plafond explicite garde le comportement prévisible.

Types de blocs dans la réponse

Une réponse avec recherche web est la plus riche que nous ayons rencontrée — elle empile plusieurs types de blocs :

• TextBlock : explication de Claude
• ServerToolUseBlock : requête de recherche exacte
• WebSearchToolResultBlock : résultats de recherche
• WebSearchResultBlock : résultats individuels avec titres et URLs
• CitationsWebSearchResultLocation : citations spécifiques

Remarquez le ServerToolUseBlock : là où un ToolUse classique attend que votre code réponde, celui-ci est purement informatif — la recherche a déjà été exécutée côté serveur, le bloc documente simplement quelle requête a été lancée. Toute la conversation d’outil s’est déroulée sans vous, et la réponse vous en livre le procès-verbal complet, résultats et citations compris.

Restreindre les domaines

Pour les usages sérieux, un paramètre change tout :

web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5,
    "allowed_domains": ["nih.gov"]
}

allowed_domains garantit que Claude ne cherche que sur des domaines de confiance — ici les publications médicales du NIH — au lieu de blogs aléatoires. C’est la différence entre « Claude a trouvé sur Internet » et « Claude a trouvé dans les sources que nous acceptons de citer » : pour une application médicale, juridique ou financière, cette liste blanche est ce qui rend la fonctionnalité présentable en production.

Rendu des résultats

Cette architecture de blocs n’est pas une complexité gratuite : elle est conçue pour un rendu riche dans votre interface. Les citations relient chaque affirmation du texte aux résultats qui la fondent — de quoi afficher un texte avec citations en ligne, des liens vers les sources, et le surlignage du passage exact cité. On obtient une expérience transparente où les utilisateurs peuvent vérifier les sources de Claude d’un clic, au lieu de croire le modèle sur parole. Pour une réponse fondée sur le web, cette vérifiabilité n’est pas un luxe — c’est elle qui crée la confiance.

Points clés à retenir

• La recherche web est un outil serveur : exécuté par Anthropic, aucune implémentation de votre côté
• Claude mène seul le cycle complet : requête, lecture, recherches de suivi — plafonné par max_uses
• La réponse empile des blocs spécialisés : requêtes exécutées, résultats, citations
• allowed_domains restreint les sources — indispensable pour les domaines sensibles
• Les citations permettent un rendu vérifiable : chaque affirmation renvoie à sa source exacte