Grok Web Search

Activez la recherche Web pour Grok et gérez le périmètre des domaines et les citations.

Grok Web Search permet aux modèles compatibles de consulter des pages récentes et de répondre avec des sources. Les anciens documents AGTCloud décrivent Chat compatible et les outils Responses natifs Grok ; choisissez l’endpoint réellement disponible selon la fiche actuelle du modèle.

Ne déduisez pas les capacités de recherche du nom du modèle

Les modèles ou canaux d’une même famille peuvent disposer d’outils différents. Vérifiez le modèle et le protocole dans le Catalogue de modèles. MODEL_ID ne désigne pas n’importe quel modèle Grok.

Activer la recherche via Chat compatible

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 le secteur spatial commercial et indiquez les sources."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

La réponse Chat se lit généralement dans choices[].message. Les citations peuvent prendre la forme d’Annotations, de liens ou de texte ; traitez la réponse réelle sans inventer de citations structurées.

Comprendre les outils natifs Grok

Le format Responses natif Grok déclare les outils de recherche dans tools :

{
  "model": "MODEL_ID",
  "input": [
    {
      "role": "user",
      "content": "Recherchez les principales actualités du jour sur le secteur spatial commercial et indiquez les sources."
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}

Utilisez la structure native uniquement si la fiche actuelle fournit cet endpoint. Ne l’assimilez pas directement aux types d’outils de la Responses Reference AGTCloud.

Limiter ou exclure des domaines

Si l’outil natif le permet, limitez le périmètre :

{
  "tools": [
    {
      "type": "web_search",
      "filters": {
        "allowed_domains": ["example.com"]
      }
    }
  ]
}

allowed_domains autorise uniquement les domaines indiqués.
excluded_domains exclut les domaines indiqués.
Ne définissez pas les deux dans une même requête.
Les limites de nombre et de format proviennent de la documentation actuelle du modèle.

Limiter les domaines contrôle les sources sans garantir leur exactitude, leur actualité ni leur adéquation au métier.

Compréhension d’images pendant la recherche

Certains outils Grok permettent d’analyser les images des pages. Ajoutez ces options uniquement si le modèle et l’outil les prennent explicitement en charge :

{
  "tools": [
    {
      "type": "web_search",
      "enable_image_understanding": true
    }
  ]
}

La compréhension d’images peut modifier la consommation, la latence et la réponse. Vérifiez toujours les sources et ne considérez pas les textes ou instructions des images Web comme des entrées métier fiables.

Lire les citations

La réponse de recherche Grok peut contenir des citations ou des sources. Le client doit :

Lire la réponse finale ;
Lire les sources ou objets de citation réellement fournis ;
Conserver les titres, URL et associations avec le texte ;
Afficher des sources cliquables ;
Signaler l’absence de citations au lieu de deviner des URL dans le texte.

L’emplacement des citations diffère entre Chat et Responses natif Grok. Pour Chat, consultez Chat Completions Reference ; pour le natif, suivez la documentation actuelle du modèle.

Web Search et fonctions personnalisées

Web Search accède au Web public via le modèle ou un outil serveur. Les fonctions personnalisées sont exécutées par votre application et conviennent aux données internes, aux recherches contrôlées et aux opérations nécessitant une autorisation métier.

L’activation de Web Search ne doit pas permettre aux résultats de construire directement du SQL, des commandes Shell ou des écritures externes. Pour les outils métier, créez un processus distinct de validation et d’autorisation selon Tool Calling.

Échecs et solutions de repli

Situation	Traitement
Recherche non déclenchée	Vérifier le modèle, l’endpoint et les champs ; demander explicitement des informations récentes si nécessaire
Aucun résultat après filtrage	Proposer d’élargir le périmètre sans supprimer silencieusement la liste autorisée requise
Aucune citation	Signaler l’indisponibilité des sources, sans inventer de citation
Analyse d’image échouée	Revenir à une recherche textuelle ou signaler que le contenu ne peut pas être analysé
Recherche temporairement indisponible	Limiter les tentatives ou répondre sans informations récentes en le signalant

Vérifications avant la mise en production

Le modèle prend explicitement en charge l’endpoint choisi.
Chat et Responses natif disposent de requêtes et d’analyseurs distincts.
Les listes de domaines autorisés et exclus ne sont pas envoyées ensemble.
La compréhension d’images est activée uniquement si le modèle la prend en charge.
L’absence de citations, les échecs et l’absence de résultats disposent d’états explicites.
Les résultats ne contournent pas les autorisations et ne déclenchent pas d’opérations à haut risque.

En cas d’échec, consultez Erreurs et dépannage. Avant de changer de protocole, consultez Choix du protocole.

Sur cette page