En bref. L’outil intégré Websearch de Mistral renvoie les URL et les titres des sources dans des blocs tool_reference au sein de message.output.content.

Définition : Au 17 octobre 2026, l’outil intégré Websearch de Mistral renvoie les liens vers les sources dans des blocs tool_reference intercalés dans le texte de la réponse, au sein d’une entrée message.output. Chaque référence contient l’URL (url) et le titre (title) de la source.

Points clés

La documentation Websearch de Mistral indique que les outils intégrés sont disponibles via les API Conversations et Agents, à l’exclusion de Chat Completions.
Le guide pratique Web Search with References de Mistral montre comment examiner les réponses de la recherche intégrée à partir de response.outputs.
Le guide Citations & References présente séparément les résultats d’une fonction personnalisée, dont les données sources sont récupérées à l’aide de reference_ids.

Où se trouve l’URL de la source ?

La description de la sortie de Websearch présente message.output.content comme une liste de blocs de texte et de références. Le champ type d’une référence vaut tool_reference ; tool indique web_search, title contient le titre de la source et url son adresse. La documentation mentionne également un champ source.

Une entrée distincte, tool.execution, consigne l’exécution de la recherche. Ses métadonnées comprennent le nom de l’outil, un identifiant et des horodatages. La lecture de cette seule entrée omet les liens intégrés à la réponse produite. Une application qui affiche la réponse doit donc traiter les blocs de contenu en conservant les références avec le texte.

Comment une application peut-elle examiner la réponse ?

La section consacrée à la recherche intégrée du guide pratique Web Search with References de Mistral lance une conversation avec tools=[{"type": "web_search"}]. Elle indique directement un modèle : cet exemple démarre donc sans création préalable d’un agent.

Pour un objet response existant, l’adaptation suivante de la boucle de sortie affiche chaque entrée complète sous forme sérialisée. Le guide pratique tronque chaque entrée affichée ; supprimer cette troncature permet d’examiner le contenu intégral.

for output in response.outputs:
    print(output.model_dump_json())

Les éléments à examiner sont le champ type de la sortie et, pour un message produit, les blocs de content. Dans le cadre d’un audit de site web, conserver cette réponse sérialisée permet de garder les adresses des sources renvoyées avec la réponse examinée.

Pourquoi d’autres exemples utilisent-ils des identifiants de référence ?

Le guide Citations & References de Mistral présente une fonction personnalisée get_information. Elle renvoie des enregistrements JSON contenant les URL, les titres et des extraits des sources. L’application ajoute ce résultat à l’historique de conversation sous forme de message d’outil avant de demander la réponse finale.

Dans cet exemple, le code de mise en forme collecte les identifiants ReferenceChunk.reference_ids, recherche chacun d’eux dans le résultat de la fonction et affiche le titre et l’URL correspondants. Ces identifiants appartiennent aux données de référence de l’outil personnalisé. La réponse de l’outil intégré Websearch décrite plus haut fournit les URL directement dans ses blocs de référence d’outil. Le code d’analyse doit suivre le format correspondant à l’utilisation choisie de l’API.

Termes associés

Questions fréquentes

Puis-je activer l’outil intégré Websearch via Chat Completions ?

La documentation Websearch de Mistral place web_search et web_search_premium dans les API Conversations et Agents. Elle précise que les réponses de Chat Completions ne contiennent pas les références aux résultats de recherche nécessaires à ces outils.

Comment convertir les identifiants de référence personnalisés en liens ?

Suivez la méthode de correspondance de l’exemple Citations & References de Mistral : collectez les identifiants dans les blocs de référence, retrouvez les données correspondantes dans le résultat JSON de l’outil, puis utilisez les champs url et title associés.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment l’API de recherche web de Mistral renvoie-t-elle les liens vers les sources ?