L'outil de recherche web intégré

Claude dispose d’un outil intégré de recherche web qui lui permet de chercher des informations sur Internet pour répondre aux questions des utilisateurs. Contrairement aux outils classiques, vous n’avez pas besoin d’écrire l’implémentation — Claude gère l’ensemble du processus de recherche automatiquement.

Prérequis : Votre organisation doit activer l’outil de recherche web dans la console de configuration : https://console.anthropic.com/settings/privacy

Configuration

Le schéma est minimal — il suffit de déclarer l’outil avec quelques paramètres :

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 résultats, donc cette limite évite les appels excessifs à l’API. Une seule recherche retourne plusieurs résultats, mais Claude peut décider que des recherches supplémentaires sont nécessaires.

Structure de la réponse

Quand Claude utilise l’outil de recherche, la réponse contient plusieurs types de blocs :

Les citations incluent le texte précis que Claude a utilisé pour étayer ses réponses, avec les URLs sources correspondantes.

Restreindre les domaines de recherche

Vous pouvez limiter les recherches à des domaines spécifiques avec le champ allowed_domains. C’est utile quand vous voulez des sources fiables et faisant autorité :

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

Par exemple, pour des questions médicales, restreindre les recherches à PubMed (nih.gov) garantit des informations basées sur des preuves scientifiques plutôt que du contenu de blog aléatoire.

Afficher les résultats

Les différents types de blocs dans la réponse sont conçus pour un rendu UI spécifique :

• Blocs texte : afficher comme du contenu classique
• Résultats 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 cité

Cette structure aide les utilisateurs à comprendre comment Claude est arrivé à ses réponses et offre de la transparence sur les sources utilisées.

Cas d’usage idéaux

L’outil de recherche web fonctionne le mieux pour :

• Actualités et développements récents
• Informations spécialisées absentes des données d’entraînement de Claude
• Vérification de faits et recherche de sources faisant autorité
• Tâches de recherche nécessitant des informations à jour

Il suffit d’inclure le schéma dans la liste tools de vos appels API. Claude décidera automatiquement quand une recherche web serait utile pour répondre à la question de l’utilisateur.