forum aux questions Microsoft Web IQ

Réponses aux questions courantes sur l’utilisation de Microsoft WEB IQ. Pour obtenir des informations détaillées sur l’API et des exemples de requêtes, consultez la référence de l’API.

Service et déploiement

Qu’est-ce que Microsoft Web IQ ?

Microsoft Web IQ est une suite d’API de recherche web native et de grounding d’IA qui donne aux LLM, aux agents IA et aux applications l’accès aux informations web actuelles et pertinentes. Cela permet des réponses d’IA plus précises et à jour, avec des sources que les utilisateurs peuvent vérifier. Web IQ alimente les principaux assistants d’IA de pointe, notamment Microsoft Copilot et ChatGPT.

Web IQ est disponible via REST at https://api.microsoft.ai/v3 et via MCP à l’adresse https://api.microsoft.ai/v3/mcp. Les API actuellement disponibles sont Recherche web, Actualités, Vidéos, Images et Browse. Auto est disponible en version bêta.

Qu’est-ce que l’ancrage Web, et quand un agent IA en a-t-il besoin ?

L’ancrage web permet à l’IA d’accéder aux dernières informations web afin qu’elle puisse répondre à l’aide de faits actuels au-delà de ses données d’apprentissage, avec des sources citées que les utilisateurs peuvent vérifier. Il est surtout utile pour les informations qui changent fréquemment, telles que les développements du marché, l’activité des concurrents, les actualités et les mises à jour réglementaires.

Web IQ est-il un LLM ? Génère-t-il la réponse finale ?

Non. Web IQ n’est pas un modèle IA ni LLM. Il s’agit d’une suite d’API de recherche Web native à l’IA et d’ancrage qui donne aux LLM, aux agents IA et aux applications l’accès à des informations Web actuelles et pertinentes.

Web IQ ne génère pas la réponse IA finale. Il récupère les informations pertinentes à partir du web, et votre logique LLM, IA ou application choisie utilise ces éléments pour générer une réponse.

Qu’est-ce qui rend Web IQ différent des autres API de recherche web et des services de grounding ?

La plupart des API de recherche web forcent un compromis : rapide ou précis, économique ou complet. Dans la comparaison publiée de Microsoft, Web IQ offre le meilleur taux de satisfaction de l’ancrage, la vitesse la plus rapide et le moins de jetons par requête. C'est la même plateforme sur laquelle les assistants IA tels que Copilot et ChatGPT s'appuient tous les jours, prouvée à l'échelle mondiale et prête pour que n'importe quel agent ou application d'IA puisse se construire.

Web IQ se distingue aussi par la façon dont il accède au contenu. Il adopte une approche responsable de l’accès web, regroupant le Web ouvert et les données structurées avec la sécurité et les protections intégrées à l’entreprise.

Web IQ fonctionne avec la pile IA que vous utilisez déjà. Vous pouvez utiliser votre modèle IA préféré et vous connecter via l’API REST ou le protocole MCP (Model Context Protocol), sans être lié à un seul modèle ou plateforme.

Source : Résultats du benchmark Web IQ (sections Qualité, Efficacité et Vitesse).

Que puis-je créer avec Web IQ ?

Web IQ alimente les agents et applications IA qui ont besoin d’informations externes récentes à partir du web public. Les équipes internes peuvent l’utiliser pour l’intelligence concurrentielle, la surveillance, la recherche réglementaire, l’intelligence commerciale et l’optimisation du contenu. Les expériences orientées client peuvent l’utiliser pour la recherche, la découverte, les recommandations et les agents spécialisés.

Il convient le mieux aux scénarios où les informations changent fréquemment, couvrent de nombreuses sources externes et doivent être ancrées dans le contenu web actuel et attribuable.

Quelle API Web IQ correspond à mon cas d’usage ?

Utilisez la Web Search API pour rechercher des pages publiques et des passages pertinents pour votre modèle, la News API pour les événements actuels, les API Images et Vidéos pour les résultats visuels et vidéo, ainsi que la Browse API lorsque vous connaissez déjà l’URL. Consultez la référence de l’API pour connaître les fonctionnalités et les limites disponibles pour votre compte.

Puis-je utiliser Web IQ avec mon modèle IA existant et mon infrastructure d’agent ?

Yes. Web IQ vous permet d’ajouter des informations web au modèle IA et au flux de travail de l’agent que vous choisissez. Les API REST et MCP vous offrent une flexibilité quant à la façon dont vous vous y connectez. Consultez le SDK et la documentation sur l’intégration MCP pour connaître les configurations prises en charge.

À quoi ressemble l’intégration ?

Votre agent IA ou votre application appelle Web IQ pour obtenir des preuves issues du Web, puis transmet les résultats sélectionnés à son modèle pour générer une réponse. Vous contrôlez la façon dont les informations sont sélectionnées, utilisées et citées. Suivez le guide de démarrage rapide pour connecter votre premier flux de travail, ou commencez à utiliser Playground.

Web IQ peut-il récupérer des informations confidentielles sur l’entreprise ?

Non. Web IQ récupère les informations web publiques. Pour le contexte d’entreprise, Microsoft offre Work IQ, Fabric IQ et Foundry IQ, chacun servant un rôle différent, du contexte organisationnel aux données métier et aux connaissances de l’entreprise.

Comment Web IQ est-il lié à Foundry IQ, Work IQ et Fabric IQ ?

Microsoft IQ réunit quatre couches intégrées qui alimentent la veille décisionnelle dans Microsoft. Web IQ fournit des informations à partir du web public. Work IQ se concentre sur les signaux de travail, Fabric IQ sur les données métier et Foundry IQ sur les connaissances organisationnelles. Ces produits répondent à différents besoins d’informations pour les agents et applications IA et sont les plus puissants lorsqu’ils sont utilisés ensemble.

Web IQ est-il une ressource Azure ?

Vous déployez une ressource Web IQ dans votre abonnement Azure. La ressource gère l’identité, le comptage et la facturation.

Le service lui-même est hébergé par Microsoft et mutualisé. La récupération web et le classement s’exécutent dans l’infrastructure Microsoft, et votre application appelle api.microsoft.ai via HTTPS. La ressource Azure n'héberge pas Web IQ et n'est pas dans le chemin d’accès de la requête.

Où est déployé Web IQ ?

Web IQ est hébergé par Microsoft et disponible via le point de terminaison publichttps://api.microsoft.ai/v3. Votre application appelle l’API, et Web IQ effectue la récupération web côté serveur.

Existe-t-il des API dédiées pour les finances, les sports ou les conditions météorologiques ?

Pas aujourd’hui. Les API dédiées sont Web Search, News, Videos, Images et Browse. Pour les finances, les sports, les conditions météorologiques et d’autres sujets sans API dédiée, utilisez la recherche web, qui retourne du contenu indexé pertinent. Ce contenu est un texte de page non structuré plutôt qu’un flux structuré.

Accès et prise en main

Comment passer de l’évaluation à la production ?

1. Terminez votre évaluation et confirmez que le service répond à vos besoins.
2. Votre abonnement Azure est activé pour Web IQ.
3. Déployez la ressource Web IQ dans cet abonnement, puis connectez-vous au site client Web IQ et connectez la ressource. Cela crée votre AppID de production, qui commence à la limite par défaut de 15 requêtes par seconde (QPS).
4. Pour vous authentifier auprès d’Entra ID, ajoutez l’ID client de votre application à cet ID d’application dans le site client Web IQ.

Votre utilisation de Web IQ est régie par les conditions d’utilisation de Web IQ, dans le contexte de votre Contrat client Microsoft existant.

Quels abonnements Azure puis-je utiliser ?

Web IQ nécessite un abonnement Azure payant. Les crédits Azure ne fonctionnent pas pour Web IQ.

Quelle adresse dois-je utiliser pour me connecter ?

Utilisez l’adresse de connexion Microsoft qui a accès à Web IQ : l’adresse Microsoft activée pour vous, ou le compte que vous avez utilisé pour connecter votre ressource Web IQ dans le site client Web IQ. Il s’agit normalement de l’adresse que vous utilisez pour Azure, Teams ou Office, qui peut différer de votre adresse de boîte aux lettres.

Pour le confirmer, connectez-vous à Portail Azure et vérifiez l’adresse dans le coin supérieur droit.

Pourquoi la connexion indique-t-elle que je n’ai pas accès ?

Tout d’abord, vérifiez que l’adresse affichée dans le coin supérieur droit de Azure portal correspond exactement à l’adresse qui a accès à Web IQ. Les organisations utilisent souvent une adresse pour la connexion à Microsoft et une autre pour l’e-mail.

Si les adresses correspondent, votre organisation peut bloquer l’accès invité inter-locataire au locataire Microsoft Corporation. Demandez à votre administrateur informatique d’autoriser cet accès.

Où puis-je obtenir de l’aide ?

Visitez le site de support Microsoft Web IQ pour obtenir de l’aide sur le produit. Pour plus d’informations sur l’utilisation, la confidentialité, le stockage ou l’affichage autorisés, consultez les conditions d’utilisation de Web IQ actuelles et votre contrat client applicable.

Authentification d’API

Quelles méthodes d’authentification sont prises en charge ?

Web IQ prend en charge:

• Microsoft Entra ID jetons Bearer via le flux des informations d’identification du client OAuth 2.0. Ceci est recommandé pour les charges de travail de production.
• Clés API envoyées dans l’en-tête de requête x-apikey.

Tout le trafic d’API utilise HTTPS.

Comment configurer l’authentification serveur à serveur ?

Inscrire une application dans Microsoft Entra ID et utiliser le flux d’informations d’identification du client OAuth 2.0. Ajoutez l’ID client de l’application à votre ID d’application Web IQ dans le site client Web IQ, obtenez un jeton d’accès et envoyez-le en tant que Authorization: Bearer <access_token>.

Consultez Authentification pour connaître les étapes de configuration complètes.

Puis-je gérer mes propres clés API ?

Yes. Vous pouvez créer autant de clés API que nécessaire à partir du site client WEB IQ. Il n’y a aucun frais pour créer des clés.

Web IQ utilise-t-il Azure RBAC pour l’autorisation d’API ?

Non. Web IQ est un service hébergé par Microsoft auquel vous accédez via Internet. La ressource Web IQ que vous déployez dans votre abonnement Azure gère l'identité, le comptage et la facturation, mais elle n'est pas dans le chemin de requête. Il n'existe donc aucune ressource de service à laquelle attacher des rôles Azure RBAC.

WebIQ autorise les requêtes par AppID. Chaque AppID possède son propre profil et quota d’éligibilité de contenu, et les appels non autorisés retournent HTTP 403. Pour séparer des équipes ou des charges de travail, par exemple avec différentes stratégies d’accès ou quotas, utilisez plusieurs AppID.

Un Entra ID peut-il appeler plusieurs AppID ?

Yes. Un ID d’application Entra (client) unique peut être autorisé à appeler un ou plusieurs AppID. Pour choisir l’AppID, transmettez-le en tant que paramètre de requête, par exemple https://api.microsoft.ai/v3/search/web?appid=<AppID>. L’API résout l’AppID comme suit :

• Votre Entra ID est lié à un Id d'application : si vous ne spécifiez pas d'AppID, ou si vous spécifiez cet AppID, la requête réussit (HTTP 200). Si vous spécifiez un autre AppID, la requête retourne HTTP 403.
• Votre Entra ID est lié à plusieurs ID d’application : vous devez en spécifier un. Un AppID manquant ou vide retourne HTTP 400 ; l’un de vos AppID liés réussit (HTTP 200) ; tout autre AppID retourne HTTP 403.
• Votre Entra ID n'est lié à aucun AppID : la requête retourne HTTP 401.

L’authentification par clé API (x-apikey) n’est pas affectée. Chaque clé API est liée à un seul APPID, donc ?appid= n’est jamais nécessaire ni accepté pour les appels authentifiés par clé.

Quelle authentification un agent hébergé doit-il utiliser : Managed Identity ou AgentID ?

L’un ou l’autre fonctionne. Managed Identity et AgentID sont à la fois des identités Entra ID, et Web IQ accepte toute identité Entra dont l’ID d’application (client) est lié à votre profil d’application Web IQ à partir de la page Gestion des profils du site client Web IQ.

Celui que vous utilisez dépend de l’emplacement d’hébergement de l’agent :

• Managed Identity convient aux agents qui s’exécutent sur l’infrastructure Azure, comme Foundry, App Service, Container Apps, AKS, Functions ou les machines virtuelles. Les identités affectées par le système et affectées par l’utilisateur fonctionnent toutes les deux.
• AgentID correspond à des agents Foundry ou hébergés par Copilot Studio qui exposent une identité d’agent.
• Les agents hébergés en dehors d’Azure, par exemple sur votre propre cluster Kubernetes ou dans un autre cloud, peuvent utiliser un enregistrement d’application Entra standard avec un secret client ou des informations d’identification fédérées.

Dans tous les cas, l’appel utilise le flux des informations d’identification du client OAuth 2.0 et envoie le jeton sous la forme Authorization: Bearer <access_token>. Consultez Authentification pour connaître les étapes de configuration. Une clé API dans l’en-tête x-apikey reste l’option la plus simple pour les prototypes.

Le réseau et la sécurité

Web IQ prend-il en charge les Private Link, les points de terminaison privés, l’intégration au VNet ou la liste d’autorisation d’IP ?

Non. Aucun de ces éléments n’est pris en charge aujourd’hui. Web IQ est accessible via un point de terminaison public unique, https://api.microsoft.ai/v3via HTTPS avec Entra ID ou l’authentification par clé API. Il n’existe aucun contrôle d’accès basé sur IP sur le point de terminaison de l’API.

La ressource Web IQ de votre abonnement Azure gère l'identité, la mesure d’usage et la facturation, mais n'est pas dans le chemin de requête. Par conséquent, les contrôles réseau Azure tels que Private Link, l'intégration au réseau virtuel, Pare-feu Azure, les groupes de sécurité réseau et les topologies hub-and-spoke n’ont aucun élément côté Web IQ auquel se rattacher. L’intégration d’identité (Entra ID) est alignée sur Azure ; la couche réseau ne l’est pas.

Sur votre côté, autorisez le nom d’hôte api.microsoft.ai dans vos contrôles de sortie.

Le trafic d’Azure vers Web IQ reste-t-il sur le réseau de Microsoft ou sur le backbone Azure ?

Cela n’est pas garanti. Les clients se connectent au point de terminaison public https://api.microsoft.ai et le trafic est sécurisé en transit avec HTTPS.

Le trafic d’API Web IQ se termine à Azure Front Door, qui prend en charge TLS 1.2 et TLS 1.3 avec ces suites de chiffrement :

• TLS 1.3 : TLS_AES_256_GCM_SHA384, TLS_AES_128_GCM_SHA256
• TLS 1.2 : TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Zscaler ou un autre outil d’inspection de sortie interfère-t-il avec Web IQ ?

Il ne doit pas interférer lorsqu’il est configuré pour autoriser les connexions à api.microsoft.ai. Il s’agit d’une action de liste d’autorisation standard, et non d’un contournement large. La même approche s’applique à d’autres passerelles web sécurisées telles que Netskope.

Puis-je mettre Web IQ derrière Gestion des API Azure ?

Yes. Vous pouvez placer Gestion des API Azure ou une autre passerelle devant Web IQ dans votre propre abonnement Azure pour l’observabilité et la gouvernance, et il n’existe aucune limitation de blocage connue. Les appels d’API passent de votre application appelante à https://api.microsoft.ai/v3 via TLS avec une clé API ou un jeton Entra ID, de sorte que tout ce que vous mettez devant ce trafic est votre propre infrastructure dans votre locataire. Microsoft ne publie pas d'architecture de référence pour ces déploiements ; votre équipe d'architecture cloud est responsable de cette conception.

Sous les conditions d’utilisation de Web IQ, le contenu de réponse ne peut pas être mis en cache ou stocké pour générer un jeu de données dérivé, quoi que fasse la passerelle. Les données de télémétrie opérationnelles telles que l’état, la latence, les en-têtes et les ID de trace peuvent être conservées, par exemple dans Application Insights ou Log Analytics.

Quels contrôles de sécurité sont disponibles ?

• Authentification : Entra ID (identifiants client OAuth 2.0) ou une clé API.
• Autorisation : accès par appID aux API. Les appels non autorisés retournent HTTP 403.
• Limitation du taux : application du quota par appID. Les requêtes au-dessus de la limite retournent HTTP 429.
• Transport : HTTPS uniquement.

La politique réseau au niveau de votre périmètre est votre responsabilité. Si vous avez des exigences d’architecture spécifiques que vous souhaitez faire évaluer, contactez le support web IQ.

Limites de débit et clés API

Existe-t-il une limite de débit ?

Yes. Chaque ressource Web IQ a une limite par défaut de 15 requêtes par seconde (QPS). La limite s’applique à l’AppID créé lorsque vous connectez la ressource, et le site client Web IQ l’affiche.

La limite est partagée entre toutes les clés API et Entra ID clients pour cet AppID. Les requêtes au-dessus de la limite retournent HTTP 429.

Puis-je augmenter ma limite de requêtes ?

Yes. Chaque ressource Web IQ démarre à 15 QPS. Pour demander une limite plus élevée, contactez Web IQ Support avec votre trafic attendu et votre cas d’usage.

Combien de clés API puis-je créer ?

Vous pouvez créer autant de clés que votre application en a besoin. La création de clé est gratuite, mais toutes les clés d’une ressource partagent sa limite de débit de requêtes.

Confidentialité et gestion des données

Web IQ enregistre-t-il les requêtes API ?

Yes. Les demandes d’API sont enregistrées à des fins opérationnelles : fiabilité du service, débogage et amélioration de la qualité. Il s’agit d’une norme pour les services Microsoft.

• L'accès est limité au personnel d’ingénierie et d’exploitation autorisé de Microsoft et est régi par les stratégies internes de Microsoft en matière de contrôle d’accès. Les données des journaux d’activité ne sont pas accessibles à d’autres clients ou tiers.
• Les journaux sont stockés dans l'infrastructure de production de Microsoft et sont soumis à des contrôles de sécurité standard de Microsoft, y compris le contrôle d'accès en fonction du rôle et les pistes d'audit.
• Les journaux sont chiffrés en transit (HTTPS) et au repos à l'aide des pratiques de chiffrement standard de Microsoft.

Microsoft agit en tant que responsable du traitement conformément à la Déclaration de confidentialité Microsoft.

Combien de temps les requêtes sont-elles conservées ?

La rétention des données de télémétrie de requête est régie par l'article 4 des conditions d'utilisation de Web IQ, ce qui soumet le traitement de Microsoft à la Déclaration de confidentialité Microsoft. Il n’existe aucun engagement distinct en matière de rétention spécifique à l’IQ web au-delà de ce que décrit la Déclaration de confidentialité.

Puis-je désactiver la journalisation des requêtes pour les charges de travail réglementées ou sensibles ?

Le texte de requête est capturé dans le cadre de la télémétrie de requête standard, et son traitement est régi par la déclaration de confidentialité Microsoft et la section 4 des conditions d’utilisation web IQ.

Si vous disposez d’une exigence réglementaire ou de conformité spécifique, Web IQ offre Zero Query Logging, ce qui supprime le texte des requêtes de la télémétrie. Il ne s’agit pas d’une fonctionnalité libre-service ; chaque cas d’usage est examiné et approuvé individuellement, et cette approbation peut s’appliquer à toutes vos applications ou uniquement à des applications spécifiques. Pour le demander, contactez votre équipe du compte Microsoft et partagez :

• Framework réglementaire ou de conformité qui s’applique (par exemple, GLBA, HIPAA, RGPD ou APPI).
• Brève description de votre scénario de déploiement.

Quels sont les engagements de résidence des données fournis par Web IQ ?

Aucun aujourd’hui. Web IQ ne fournit pas de garanties d’hébergement des données ni de traitement en région, et le routage interrégional vers le point de terminaison disponible le plus proche est le comportement attendu. La confidentialité est couverte par la déclaration de confidentialité Microsoft.

Web IQ est-il couvert par l’addenda sur la protection des données Azure ou l’EU Data Boundary ?

Non. La section 4.1 des Web IQ Terms of Use exclut le service de l’addenda sur la protection des données des produits et services Microsoft.

Au lieu de cela, Microsoft et le client agissent en tant que responsables du traitement indépendants pour toutes les données personnelles traitées en vertu des conditions d’utilisation (section 4.4). Le traitement de Microsoft est régi par la Déclaration de confidentialité Microsoft (section 4.2), et vous êtes responsable d’informer de manière appropriée vos utilisateurs finaux.

Pour les transferts internationaux, les conditions d’utilisation incorporent des clauses contractuelles standard si nécessaire (section 4.6.1). Ce mécanisme de transfert transite par les conditions d’utilisation, qui se trouvent sous votre Contrat client Microsoft, et non pas par l’Addendum sur la protection des données.

Web IQ n’offre pas aujourd’hui de frontière des données de l’UE, de résidence des données spécifique à une région ni d’engagements de traitement dans la région à ce jour.

Web IQ détecte-t-il ou masque-t-il les données personnelles dans les requêtes ?

Non. Web IQ n’effectue pas de détection ou de masquage côté serveur des données personnelles dans les requêtes entrantes. Si une charge de travail peut envoyer des données personnelles ou sensibles, nettoyez-la avant d’appeler Web IQ, par exemple avec Azure AI Language PII Detection en tant qu’étape de prétraitement. De cette façon, aucune donnée sensible ne quitte votre environnement, et vous conservez un contrôle total sur ce qui atteint l’API.

Web IQ prend-il en charge les industries réglementées ?

Yes. Web IQ prend en charge une gamme de cas d’usage d’entreprise et réglementés. Si vous avez des exigences spécialisées en matière de conformité, de gouvernance ou de secteur, contactez le support Web IQ.

Sécurité des contenus et couverture

Quels sont les contrôles de sécurité de contenu appliqués ?

Web IQ applique la classification de la qualité et de la sécurité au moment de l’exploration, le filtrage de contenu pour adultes et les règles d’éligibilité de contenu par client. SafeSearch est appliqué côté strict serveur par défaut. Les résultats de la recherche web incluent également un champ isAdult pour une gestion côté client supplémentaire.

Web IQ protège-t-il un LLM contre l’injection de prompts dans le contenu récupéré ?

Microsoft Web IQ récupère et classe le contenu du web ; il n’exécute, n’interprète ni n’agit sur des instructions incorporées dans le contenu récupéré. Web IQ complète ce comportement de récupération avec la qualité, la fiabilité, le courrier indésirable et le filtrage de contenu malveillant de Bing.

La protection contre l’injection indirecte de prompt, les tentatives de jailbreak et les attaques de suivi d’instructions est principalement la responsabilité du modèle en aval et de la couche d’orchestration. Traitez les prompts et le contenu récupéré comme des entrées non fiables et appliquez des contrôles en couches tels que Prompt Shields, Azure AI Sécurité du Contenu, l’isolation du prompt système, l’accès aux outils avec le minimum de privilèges, la validation de l’ancrage et la validation de sortie. Web IQ ne doit pas être traité comme le seul point d’application pour l’atténuation des injections de prompt.

Comment le contenu web est-il traité avant que Web IQ ne le retourne ? Est-il assaini pour obtenir des instructions de type prompt ?

Microsoft Web IQ ne traite pas directement le HTML brut de la page au moment de la récupération. Lors de l’indexation, le contenu web est normalisé dans une représentation structurée de document conçue pour préserver un contenu significatif et une structure de document. Les passages retournés par Web IQ sont sélectionnés à partir de cette représentation, ce qui permet une extraction et une récupération plus cohérentes sur la surface de l’API. Le filtrage existant de la qualité, de la sécurité, du spam et du contenu malveillant de Bing s’applique également dans le cadre du pipeline d’indexation.

Cette normalisation ne doit pas être interprétée comme une garantie que le texte de type prompt est identifié ou supprimé. Traitez le contenu récupéré comme une entrée non fiable et appliquez les protections de couche de modèle et d’orchestration décrites dans la réponse précédente.

Web IQ retourne-t-il du contenu de page masqué ou non accessible à l’utilisateur ?

Microsoft Web IQ tente de retourner du contenu visible par l’interaction utilisateur normale, y compris le contenu révélé par des contrôles de page ordinaires ou le rendu côté client. Cela n’est pas garanti. La structure et l’implémentation des pages varient. Les applications ne doivent donc pas supposer que chaque passage retourné était visible dans l’état initial de la page ou que chaque élément masqué sera toujours exclu.

Comment Microsoft maintient la qualité des index ?

Les pages sont évaluées pour la qualité, l’autorité et la fiabilité. Le contenu malveillant, indésirable et d’hameçonnage est détecté et exclu, et l’index est actualisé en permanence. Il s'agit du même index dont dépendent les propres produits IA de Microsoft.

Comment Web IQ respecte-t-il les préférences de contenu de l’éditeur ?

Web IQ est conçu pour respecter les contrôles d’éditeur pris en charge, notamment les directives robots.txt applicables et d’autres signaux d’éditeur reconnus par Microsoft.

Existe-t-il une liste publiée de sites exclus ou de catégories bloquées ?

Non. Les contrôles d’exclusion incluent la conformité au fichier robots.txt, les suppressions légales et de conformité (telles que les avis DMCA et les ordonnances judiciaires), le courrier indésirable, les programmes malveillants, le filtrage du hameçonnage et le filtrage de contenu pour adultes. Les listes elles-mêmes sont exclusives et mises à jour en continu. Si vous avez des préoccupations concernant des catégories spécifiques de contenu apparaissant ou non dans les résultats, contactez le support Web IQ pour déterminer si la configuration de votre profil d’application répond à ces exigences.

Quel contenu web IQ couvre-t-il et quelle est sa fraîcheur ?

Web IQ récupère continuellement de nouvelles informations sur les pages web, les actualités et les résultats des images et des vidéos pour aider votre agent IA ou votre application à répondre aux questions au-delà des données d’entraînement de son modèle.

La disponibilité et l’actualisation varient selon l’API, le type de source et le cas d’usage ; il n’existe aucune garantie d’actualisation unique sur tout le contenu. Tenez compte des exigences en matière de fraîcheur des données de votre charge de travail lors du choix des sources et des paramètres de récupération.

Quelles langues et marchés Web IQ prend-il en charge ?

Web IQ s’appuie sur le web mondial, mais la couverture varie selon la langue, le marché, la rubrique et le type de source. Passez en revue la page Langues et régions prises en charge pour les codes que chaque API accepte et évaluez la couverture des informations dont vos utilisateurs ont besoin.

Puis-je configurer des listes d’autorisation ou de refus de domaine ?

Pour les domaines individuels ou les petites listes, utilisez des opérateurs de requête standard tels que site:example.com pour inclure un domaine et -site:example.com en exclure un. Les listes configurables plus volumineuses ne sont actuellement pas exposées en tant que fonctionnalité gérée par le client.

Pourquoi ne vois-je pas les résultats LinkedIn ?

Les résultats LinkedIn sont actuellement exclus.

Que se passe-t-il lorsque Browse est appelé pour une URL exclue ?

Browse renvoie le code HTTP 403. La liste d’exclusion sous-jacente n’est pas exposée.

Comment puis-je rendre mon site web trouvable par Web IQ ?

Web IQ est basé sur le même index web que Microsoft utilise pour ses propres produits IA. Utilisez des pratiques standard de découverte du web telles que les plans de site, IndexNow, Outils pour webmasters Bing et une politique robots.txt appropriée. Il n’existe aucune procédure de soumission Web IQ distincte.

Comportement des requêtes et qualité des résultats

Dois-je utiliser des requêtes en langage naturel ou des mots-clés ?

Les deux fonctionnent. Les requêtes en langage naturel fonctionnent souvent correctement avec contentFormat=passage, tandis que les requêtes par mots-clés sont utiles pour des recherches précises telles que les noms de société, les symboles boursiers ou des rubriques spécifiques. Évitez les requêtes trop longues ou composées ; séparez plusieurs besoins d’information en appels d’API distincts.

Quelle est la longueur maximale de la requête ?

La valeur maximale est de 1 000 caractères et les requêtes plus longues sont rejetées. Les requêtes plus courtes et ciblées produisent généralement de meilleurs résultats : si une requête contient beaucoup de contexte, la recherche peut ne pas se concentrer sur le bon signal.

Puis-je filtrer les résultats de la recherche web par date ?

La recherche web n’offre pas de filtre de plage de dates aujourd’hui, et nous vous recommandons d’éviter un filtre de date strict, sauf si vous en avez vraiment besoin. La récence est déjà prise en compte dans le classement en fonction de la requête, et l’ajout d’une contrainte stricte sur la date nuit presque toujours à la pertinence. Pour les scénarios d’actualités, utilisez la News API plutôt que de filtrer les résultats de recherche web par date.

lastUpdatedAt est la date à laquelle l’éditeur a mis à jour le contenu, et non la date à laquelle Web IQ a vérifié la page pour la dernière fois. Par conséquent, une date antérieure ne signifie pas que la page n’a pas été cochée récemment. Il est retourné dans la réponse, il n’est pas un filtre de requête, et pas tous les résultats l’incluent. Vous pouvez l’utiliser pour trier ou filtrer les résultats dans votre application.

Recherche web peut-elle gérer une invite qui contient plusieurs questions ?

Chaque requête Web Search traite une requête. Si une invite contient plusieurs questions ou intentions, fractionnez-la en requêtes distinctes dans votre application, appelez Web Search pour chaque requête et combinez les résultats avant de générer la réponse.

Web IQ peut-il prendre en charge les flux de travail d’agent en plusieurs étapes ?

Yes. Un agent peut appeler Web IQ chaque fois qu’il a besoin de preuves web supplémentaires pendant une tâche. La latence de récupération est particulièrement importante dans les flux de travail qui effectuent plusieurs appels avant de produire une réponse.

Comment mon agent IA ou mon application doit-il gérer les preuves récupérées ?

Utilisez des éléments de preuve pertinents pour la question et identifiez les sources qui étayent la réponse. Conservez le contenu récupéré séparément des instructions qui contrôlent l’agent. Lorsque les sources sont en conflit ou que les preuves sont incomplètes, faites en sorte que l’incertitude soit claire plutôt que de combler les lacunes avec des affirmations non étayées.

Comment la qualité du grounding se compare-t-elle ?

Microsoft signale la satisfaction relative à l’ancrage la plus élevée dans sa comparaison publiée, avec un score de 79,05. Les résultats dépendent du jeu de requêtes, du modèle et de la méthode d’évaluation. Validez donc la qualité sur vos propres scénarios.

Source : Résultats du benchmark WEB IQ. 3K Global, Requêtes aveugles échantillonnées à partir de prod, Config : 10 résultats, 10 000 caractères par résultat (ou équivalent).

Pourquoi les résultats diffèrent-ils de Bing.com ?

Web IQ est optimisé pour la consommation LLM, la densité factuelle, la qualité de passage et la faible latence. Bing.com est une expérience destinée aux consommateurs avec des signaux de classement supplémentaires, la personnalisation, les réponses visuelles et du contenu susceptible de ne pas pouvoir être redistribué via une API. Certaines différences de classement sont attendues.

Les requêtes identiques peuvent-elles retourner des résultats différents ?

Une certaine variabilité est attendue, car l’index est actualisé en continu et les mises à jour se propagent entre les centres de données. Les résultats des demandes identiques effectuées à peu d’intervalle doivent rester globalement stables. Si vous constatez une variance significative d’une seconde à l’autre sur des requêtes identiques, contactez le support Web IQ.

Pourquoi une requête retourne-t-elle moins de résultats que prévu ?

Vérifiez la réponse Web IQ brute avant de compter les résultats. La cause la plus courante est un paramètre côté client ou une étape de pipeline en aval qui filtre les résultats valides avant qu’ils ne soient mesurés. maxResultsVérifiez également l’éligibilité du contenu, le comportement de SafeSearch et tout opérateur site: ou -site: dans la requête.

Contenu de la réponse

Pourquoi la recherche web et la recherche d’actualités ne retournent-elles pas un champ snippet ?

C’est intentionnel. Les deux retournent content sous la forme d’un extrait dépendant de la requête (passage) au lieu d’un extrait distinct, indépendant snippetde la requête.

Quels formats de contenu la recherche web prend-elle en charge ?

Avec passage, chaque résultat retourne les parties du document les plus pertinentes pour la requête, jusqu’à maxLength caractères (sans accès complet au document, au maximum 3 000). Il s’agit du format recommandé pour la mise à la terre. Les applications disposant d’un accès complet aux documents peuvent également utiliser text, htmlet markdown. Consultez passages et formats de contenu.

Qu’est-ce que c’est passageet pourquoi l’utiliser ?

Définissez contentFormat=passage et l’API retourne, pour chaque résultat, uniquement les segments du document les plus pertinents pour la requête, et non le document complet. Le document complet est traité côté Web IQ et ce qui revient est un extrait ciblé par la requête, de sorte que votre LLM n’a pas à parcourir les paragraphes non liés pour trouver la phrase appropriée.

• Économies de jetons : le LLM reçoit une fraction du document au lieu de tout cela.
• Meilleure exactitude factuelle : avec moins de contenu hors sujet dans le contexte, le modèle est moins susceptible de s’ancrer sur un paragraphe tangentiel.

Définissez contentFormat=passage sur chaque requête de recherche web et d’actualités. Browse ne prend pas en charge passage, car il récupère une URL spécifique que vous avez déjà choisie et il n’y a aucune requête sur laquelle effectuer l’extraction.

Quelle est la valeur maximale maxResults pour la recherche web ?

La recherche web prend en charge jusqu’à 50 résultats par requête.

Quels paramètres de requête puis-je configurer ?

La recherche web expose markdown, maxLength et safeSearch, html (passage, text, contentFormat ou region), language et maxResults. Consultez la référence de l’API pour obtenir la liste complète des paramètres.

Quelle est la différence entre lastUpdatedAt et crawledAt?

lastUpdatedAt est la date de mise à jour du contenu signalée par l’éditeur, retournée par Recherche web, Actualités, Vidéos, Images, Browse et Auto quand elle est disponible. crawledAt correspond à l’heure à laquelle Web IQ a récupéré la page pour la dernière fois, telle que renvoyée par Web Search, Browse, News et Auto. La couverture des deux champs varie en fonction du résultat.

Comment puis-je paramétrer maxResults et maxLength pour gérer les coûts de fenêtre de contexte et de jeton ?

Web IQ peut hiérarchiser les passages pertinents pour une requête au lieu de fournir un contexte de page inutile. Cela peut réduire la quantité de texte passée à votre modèle et réduire les coûts de jeton d’entrée. Les avantages dépendent de votre modèle, des prompts, de la combinaison de requêtes et des paramètres de recherche.

Pour la plupart des scénarios d’ancrage, plus de résultats avec des passages plus courts donnent une meilleure sortie que moins de résultats avec des passages plus longs pour environ le même budget total de jetons. Un bon point de départ est maxResults=10 avec maxLength environ 3 000 caractères au format passage. Comparez les performances avec vos propres requêtes et votre modèle.

Qu’est-ce que Browse Live Crawl et quand dois-je l’utiliser ?

La navigation renvoie du contenu de l’index web Bing, qui est actualisé en permanence, car nos analyseurs observent les modifications sur le web. C’est ainsi que la recherche web fonctionne en général : les résultats de recherche sont servis à partir d’un index plutôt qu’en récupérant chaque URL en direct sur chaque requête, et c’est ce qui donne à Browse sa vitesse et sa cohérence.

Pour les scénarios qui nécessitent spécifiquement une extraction juste-à-temps de l’URL au moment de la requête, comme la surveillance en temps réel, les vérifications de la concurrence ou les flux de travail qui se déclenchent sur une modification que vous savez vient de se produire, Browse prend en charge Live Crawl. Définissez liveCrawl: "fallback" sur la demande pour activer une récupération en direct lorsque la copie indexée est manquante ou obsolète. L’omission du paramètre (ou en définissant liveCrawl: "none") retourne uniquement le contenu indexé. Pour plus d’informations sur les paramètres, consultez la référence de l’API Browse.

Live Crawl est disponible par défaut sur Web IQ Browse et est configuré avec un plafond de capacité modeste par seconde, séparé de votre QPS Browse global. Ce plafond est partagé entre toutes les clés API sous l’APPID. La plupart des charges de travail Browse n’ont pas besoin de Live Crawl et sont mieux prises en charge par le chemin d’accès indexé standard ; utilisez Live Crawl pour l’ensemble étroit de scénarios ci-dessus.

Browse peut-il récupérer des pages rendues par JavaScript ?

Yes. Utiliser renderDynamicPages: true avec liveCrawl: "fallback". Consultez la référence de l’API Browse pour obtenir les détails complets du jeu de paramètres et de la réponse. Testez les URL représentatives avant de dépendre de ce comportement en production.

Browse peut-il extraire des fichiers PDF en ligne ?

Les fichiers PDF hébergés en ligne ne sont pas un scénario de navigation documenté aujourd’hui. Si vous avez un cas d’usage PDF spécifique, contactez le support Web IQ avec une URL représentative et le comportement attendu, et vous obtiendrez une réponse définitive.

Facturation et mentions légales

Que coûte Web IQ ?

Web IQ utilise une tarification à l’usage, par appel. La tarification dépend des API activées pour votre compte, votre utilisation et vos conditions commerciales. Consultez Tarification pour connaître les tarifs actuels.

Web IQ inclut-il un engagement SLA, RTO ou RPO ?

Non. Microsoft Web IQ n’inclut pas de contrat de niveau de service. Les Conditions d’utilisation de Web IQ ne garantissent pas de temps d’activité, de latence, d’objectif de délai de récupération (RTO) ou d’objectif de point de récupération (RPO), et les conditions de SLA ne sont pas ajoutées pour les clients individuels.

Dois-je afficher des citations ?

Yes. Annexe A, section 1 (utilisation LLM) des conditions d’utilisation Web IQ nécessite une attribution de source et un lien vers chaque source utilisée pour le contenu LLM affiché, près de ce contenu.

• Citez uniquement les sources réellement utilisées pour générer la réponse. Si Web IQ a retourné 10 résultats et que votre modèle a utilisé 3, affichez ces 3.
• Les citations doivent rester visibles avec la réponse et être accessibles avec une seule action. Ne les affichez pas seulement brièvement, masquez-les derrière plusieurs écrans ou obligez les utilisateurs à demander les sources séparément.
• Pour les interfaces contraintes telles que les voitures, les appareils portables, les appareils vocaux ou les kiosques, utilisez un code QR persistant qui se résout en une page répertoriant chaque citation utilisée pour la réponse actuelle, une application complémentaire qui affiche la réponse avec des citations cliquables ou une liste à l’écran que l’utilisateur peut ouvrir directement.

Vous pouvez stocker des citations dans le cadre de l’historique de conversation d’un utilisateur final individuel pendant jusqu’à 30 jours. Consultez la question de mise en cache ci-dessous.

Combien de contenu source mon agent IA ou mon application peut-il afficher ?

L’annexe A des Web IQ Terms of Use limite le contenu d’ancrage affiché provenant d’une seule source à la valeur la plus faible entre 200 caractères et le maximum spécifié par le propriétaire du site web ou le webmaster. Pour les expériences vocales ou audio, appliquez la même limite à la sortie parlée. Des restrictions supplémentaires s’appliquent aux résumés et à l’affichage. Passez en revue les conditions d’utilisation avant de concevoir des extraits ; cette limite ne constitue pas une autorisation de reproduire des pages sources entières.

Les résultats image et vidéo peuvent-ils être utilisés pour ancrer un LLM sur ?

Les métadonnées d’image et de vidéo et le texte de remplacement sont inclus dans la définition du Grounding Content. Toutefois, les conditions d’utilisation du Web IQ interdisent l’utilisation d’images ou de vidéos réelles issues des résultats pour l’ancrage, leur inclusion dans la sortie du LLM, ou la création d’images ou de vidéos dérivées à partir de celles-ci. Passez en revue les conditions de votre implémentation prévue.

Puis-je mettre en cache ou stocker du contenu Web IQ ?

En règle générale, non. Les Web IQ Terms of Use interdisent la copie, le stockage, la mise en cache, l’archivage ou la création d’une base de données de contenu, sauf dans le cadre d’exceptions limitées (section 3.2.15 et section 4 des annexes A et B) :

• Historique des conversations de l’utilisateur final (jusqu’à 30 jours) : le contenu peut être stocké sur une base non agrégée, par utilisateur final pour l’historique de conversation d’un utilisateur final individuel pendant jusqu’à 30 jours. Pour l’utilisation LLM (annexe A), cela couvre le contenu en général ; pour l’utilisation pour la recherche (annexe B), cela couvre les URL d’image et de vidéo.
• Traitement temporaire d’action atomique : le contenu peut être conservé dans un état de traitement temporaire uniquement si nécessaire pour effectuer une requête logique unique ou un flux de travail initié par un LLM (une « action atomique », qui peut impliquer plusieurs étapes internes ou interactions agentiques). Le contenu doit être supprimé rapidement une fois l’Atomic Action terminée.
• Votre propre travail résultant : dans la mesure autorisée par la loi sur le droit d’auteur, le contenu peut être copié ou stocké en tant que partie intégrée de votre propre travail résultant, tant que le travail résultant n’est pas créé pour remplacer les services (par exemple, la création d’une base de données de contenu, l’indexation de liens pour l’analyse ou l’offre d’une recherche distincte).

En dehors de ces exceptions, les conditions d’utilisation n’autorisent pas les bases de données dérivées, la mise en cache persistante ou l’archivage à long terme du contenu.

Où puis-je lire les conditions d’utilisation Web IQ ?

Les présentes conditions sont publiées à Microsoft Conditions d’utilisation de Web IQ. Ils s’appliquent conjointement avec votre Contrat client Microsoft existant.

Accès complet au document

Pourquoi est-ce que j’obtiens HTTP 403 quand je définis contentFormat sur html ?

Dans Recherche web et Recherche d’actualités, text, html et markdown renvoient le document complet et sont disponibles pour les applications disposant d’un accès complet au document. D’autres applications obtiennent HTTP 403 avec le code d’erreur AuthContentFormatForbidden. passage fonctionne pour chaque application. Consultez passages et formats de contenu.

Comment demander un accès complet aux documents ?

Ouvrez une demande de support Web IQ via Azure Support et choisissez la catégorie de contenu de page complète. Applications qui utilisent html déjà ou text continuent de fonctionner comme aujourd’hui.