En bref. Mistral propose web_search et web_search_premium via Conversations et Agents et renvoie un texte de réponse entrecoupé de références aux sources.

Définition : L’API de recherche web de Mistral désigne les outils intégrés de Mistral qui permettent de récupérer des informations sur le web au cours d’une conversation avec un assistant IA. Au 17 octobre 2026, Mistral documente web_search et web_search_premium, qui renvoient des références aux sources avec le texte de la réponse.

Points clés

La documentation Websearch de Mistral décrit la recherche standard avec web_search ; web_search_premium ajoute l’accès à des articles de presse grâce à un mécanisme intégré de vérification auprès des fournisseurs d’actualités.
La présentation des outils pour agents situe l’exécution des outils intégrés dans l’environnement de Mistral et indique qu’ils peuvent être utilisés via Conversations ou Agents.
Le guide pratique Web Search with References comprend un exemple de recherche intégrée qui démarre une conversation sans créer d’agent au préalable.

Comment activer la recherche web ?

Un outil est une fonctionnalité qu’un assistant peut appeler pour traiter une demande. La présentation des outils pour agents de Mistral indique aux développeurs d’inclure les outils intégrés dans le paramètre tools lors de la création d’un agent ou d’un appel à l’API Conversations. Pour la recherche web standard, le fragment de configuration est le suivant :

{"tools": [{"type": "web_search"}]}

Le point de terminaison (endpoint) pris en charge pour les conversations est /v1/conversations. La recherche web intégrée est également disponible via l’API Agents. La présentation exclut l’utilisation de ces outils de recherche avec le point de terminaison Chat Completions, /v1/chat/completions.

Le guide Websearch de Mistral laisse le modèle décider s’il lance une recherche pour traiter une demande. L’ajout de l’outil rend la recherche disponible ; une application vérifie les entrées d’exécution renvoyées pour savoir si elle a eu lieu.

Que contient une réponse de recherche ?

Le guide Websearch distingue tool.execution, qui consigne l’opération de recherche, de message.output, la réponse de l’assistant. Les métadonnées d’exécution comprennent le nom de l’outil ainsi que les horodatages de début et de fin.

Le champ content de la réponse est une séquence de blocs (chunks), c’est-à-dire des éléments distincts du contenu du message. Des blocs de texte alternent avec des blocs tool_reference. Une référence fournit notamment les champs tool, title, url et source. Cette structure permet à une application d’associer le texte de la réponse aux contenus liés tout en conservant séparément la trace d’exécution de la recherche.

Comment une application peut-elle afficher les sources ?

Le guide Citations & References de Mistral présente une implémentation distincte qui utilise une fonction définie par le développeur pour fournir des documents. Sa fonction de mise en forme traite les objets TextChunk et ReferenceChunk, recueille les reference_ids, puis utilise ces identifiants pour retrouver les données de référence fournies et afficher les titres et les URL.

Le guide pratique Web Search with References développe ce traitement personnalisé avec des résultats de recherche Wikipédia et des extraits de texte. Son exemple de diffusion en continu (streaming) associe les identifiants de référence reçus aux enregistrements de sources conservés et les met en forme en liens cliquables. Pour l’intégration de la recherche native, la structure de réponse pertinente est le bloc tool_reference décrit ci-dessus.

Termes associés

Questions fréquentes

Dois-je d’abord créer un agent ?

Non. La présentation des outils pour agents de Mistral permet d’utiliser les outils intégrés directement dans Conversations, y compris la recherche web.

Pourquoi le guide sur les citations utilise-t-il Chat Completions ?

Le guide sur les citations présente une fonction définie par le développeur qui renvoie des contenus sources. Cet exemple utilise Chat Completions ; les outils intégrés web_search nécessitent Conversations ou Agents.

Sources

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