Qwen Web Search

Qwen Web Search permet aux modèles compatibles d’accéder aux informations Web et de retourner des citations lorsque la réponse le permet. Il convient à la météo, aux actualités, aux mises à jour et aux autres informations récentes.

La recherche Qwen peut utiliser des champs Chat étendus, des outils intégrés Responses ou un framework natif. Leurs modes d’activation et citations diffèrent ; choisissez selon la fiche actuelle du modèle.

Le modèle doit prendre explicitement en charge l’endpoint de recherche

Ne déduisez pas du nom Qwen la disponibilité de enable_search, de Responses Web Search ou du choix d’un moteur. Vérifiez le modèle et le protocole dans le Catalogue de modèles.

Activer la recherche avec Chat

Le parcours principal Qwen Chat décrit dans les anciens documents utilise enable_search :

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": "Quel temps fait-il aujourd’hui à Hangzhou ? Indiquez vos sources."
      }
    ],
    "enable_search": true
  }'

enable_search est une extension du modèle ou du canal, pas un paramètre commun à tous les modèles Chat. Si le SDK ne le déclare pas, utilisez HTTP directement ou les paramètres étendus du SDK, selon la documentation du modèle.

Utiliser la recherche intégrée avec Responses

Si le modèle prend en charge Responses Web Search, utilisez la structure d’outil intégré :

curl 'https://api.agtcloud.cn/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "tools": [
      {
        "type": "web_search_preview"
      }
    ],
    "input": "Quel temps fait-il aujourd’hui à Hangzhou ? Indiquez vos sources."
  }'

Responses peut retourner web_search_call, un Output Item textuel et url_citation. Consultez la structure complète dans Responses Reference.

Choisir un moteur ou un fournisseur

Le framework natif Qwen peut permettre le choix du fournisseur de recherche. Cette option dépend du modèle, du framework d’agent ou du canal ; ce n’est pas un champ commun d’AGTCloud Chat.

Lorsque la documentation actuelle propose des options de fournisseur :

Le fournisseur par défaut réduit la configuration et conserve les possibilités de repli côté serveur.
Un fournisseur explicite convient aux exigences de sources, de qualité ou de conformité.
Conservez les identifiants et autorisations côté serveur, jamais dans le prompt ou le code du navigateur.
Le basculement automatique dépend de l’implémentation de l’outil ; le client doit toujours gérer les échecs.

Ne présentez pas les moteurs et leur ordre par défaut dans les anciens documents comme un engagement permanent de la plateforme.

Lire la réponse et les citations

Selon l’endpoint, la réponse peut contenir :

Endpoint	Réponse	Citations
Chat étendu	`choices[].message.content`	Annotations, liens ou sources numérotées fournis
Responses	Message Output Item	`url_citation` dans `annotations`
Framework natif	Réponse générée par le framework	Sources numérotées ou objets retournés par le fournisseur

Si la réponse utilise [1], [2] ou d’autres numéros, récupérez aussi les URL correspondantes ; n’affichez pas de numéros sans liens cibles.

{
  "answer": "Des averses sont prévues aujourd’hui à Hangzhou.[1]",
  "sources": [
    {
      "index": 1,
      "title": "Titre de la source",
      "url": "https://example.com/weather"
    }
  ]
}

Cet exemple représente des données d’affichage préparées par l’application, et non un Schema de réponse fixe de l’API AGTCloud.

Recherche native et fonctions personnalisées

Web Search intégré cible le Web public. Pour une recherche interne, des commandes ou une base privée, appelez vos services contrôlés via Tool Calling.

Le texte d’un outil personnalisé n’acquiert pas automatiquement des citations fiables. Retournez aussi les métadonnées des sources et préservez leur correspondance avec la réponse.

Échecs et solutions de repli

Situation	Traitement
`enable_search` refusé	Vérifier la prise en charge de l’extension ou choisir un endpoint Responses documenté
Recherche non déclenchée	Vérifier le besoin d’informations récentes et la transmission des champs d’activation au service amont
Numéro sans URL	Ne pas afficher de citation cliquable et signaler les informations de source incomplètes
Fournisseur indisponible	Basculer selon les règles de l’outil ou limiter les tentatives, sans boucle infinie entre fournisseurs
Résultats contradictoires	Afficher les sources et dates sans laisser le modèle masquer les divergences importantes

Vérifications avant la mise en production

Le modèle prend explicitement en charge enable_search ou l’outil Responses choisi.
Le SDK ne supprime pas silencieusement les champs étendus.
Chat, Responses et la recherche native utilisent des analyseurs distincts.
Les numéros de citation correspondent à des titres et URL réels.
La configuration et les identifiants du fournisseur ne figurent pas dans le prompt client.
L’absence de résultats, les échecs et les sources manquantes disposent de solutions de repli explicites.

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