Claude Web Search

Claude Web Search permet aux modèles Claude compatibles de rechercher sur le Web et, lorsque le protocole le permet, de retourner des blocs de résultats et des citations. Il convient aux faits récents, à la vérification des sources et aux recherches sur des sites précis.

AGTCloud peut proposer Claude via Chat compatible ou Anthropic Messages. Les champs d’activation et les réponses diffèrent ; choisissez l’endpoint selon la fiche du modèle actuel.

Activer la recherche via Chat compatible

Le parcours principal AGTCloud décrit dans les anciens documents ajoute web_search_options à la requête Chat :

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Recherchez les principales actualités du jour sur la réglementation de l’IA et indiquez les sources."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Le texte se lit généralement dans l’Assistant Message. La forme des citations — Annotations structurées, liens ou texte — dépend du modèle et de l’endpoint. Ne créez pas de citations sans éléments retournés par la réponse.

Comprendre la structure des outils natifs Anthropic

Avec un endpoint Messages compatible avec Claude Web Search natif, l’outil se trouve dans tools. L’exemple illustre uniquement la structure ; remplacez le type d’outil par la version indiquée dans la documentation actuelle du modèle :

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Recherchez les principales actualités du jour sur la réglementation de l’IA et indiquez les sources."
    }
  ],
  "tools": [
    {
      "type": "WEB_SEARCH_TOOL_VERSION",
      "name": "web_search",
      "max_uses": 5
    }
  ]
}

Utilisez max_uses, les filtres de domaines, la localisation et le filtrage dynamique uniquement si la version de l’outil les prend en charge. Consultez les conteneurs Messages et Content Blocks dans Anthropic Messages Reference.

Lire les résultats et les citations

Une réponse Messages native peut contenir les types de Content Block suivants :

• server_tool_use : appel d’un outil de recherche côté serveur demandé par le modèle.
• web_search_tool_result : résultats de recherche ou erreur de l’outil.
• text : réponse finale du modèle à l’utilisateur.
• citations : association entre les passages de réponse et les sources Web, lorsqu’elle est fournie.

Traitez les blocs selon leur type, sans les concaténer tous comme de simples chaînes.

{
  "content": [
    {
      "type": "text",
      "text": "D’après les résultats de recherche…",
      "citations": [
        {
          "type": "web_search_result_location",
          "url": "https://example.com/article",
          "title": "Titre de la source"
        }
      ]
    }
  ]
}

L’exemple montre que citations et texte appartiennent à la même structure de réponse. Les champs réels dépendent de la réponse actuelle et de la référence Messages.

Domaines, localisation et filtrage dynamique

Si la version de l’outil le permet, utilisez :

• allowed_domains : autoriser uniquement les domaines indiqués.
• blocked_domains : exclure les domaines indiqués ; ne pas combiner avec la liste autorisée.
• user_location : fournir la ville, la région, le pays et le fuseau horaire.
• Filtrage dynamique : affiner les résultats avec une combinaison d’outils compatible.

Ces options limitent les sources sans garantir leur exactitude. Pour les usages à haut risque, vérifiez les sources, les dates et la concordance entre plusieurs sources.

Distinguer les erreurs de recherche des erreurs HTTP

L’échec de l’outil ne signifie pas nécessairement un échec HTTP. La réponse native peut conserver un statut de réussite tout en contenant une erreur dans web_search_tool_result.

Différence entre recherche native et outils personnalisés

Claude Web Search est exécuté par le modèle ou un outil côté serveur. Avec Tool Calling personnalisé, votre application appelle son propre service et retourne le résultat. Pour contrôler les index, les droits ou les données internes, préférez Tool Calling.

Vérifications avant la mise en production

• Le modèle et le protocole prennent explicitement en charge les champs Web Search utilisés.
• La version du type d’outil provient de la documentation actuelle, pas d’un ancien exemple.
• Les Content Blocks, résultats, textes et citations sont analysés séparément.
• Les erreurs d’outils ne sont pas traitées comme des résultats normaux.
• Les domaines et la localisation ne sont envoyés que si nécessaire.
• Les résultats ne peuvent pas déclencher directement des outils à haut risque ni contourner les autorisations.

Consultez les champs Chat dans Chat Completions Reference et, en cas d’échec, Erreurs et dépannage.