Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Antworten auf häufig gestellte Fragen zur Verwendung von Microsoft Web IQ. Api-Details und Anforderungsbeispiele finden Sie in der API-Referenz.
Service und Deployment
Was ist Microsoft Web IQ?
Microsoft Web IQ ist eine Suite von APIs für Websuche und Grounding, die LLMs, KI-Agents und Anwendungen Zugriff auf aktuelle, relevante Webinformationen bietet. Dies ermöglicht genauere, aktuelle KI-Antworten mit Quellen, die Benutzer überprüfen können. Web IQ treibt führende Grenz-KI-Assistenten an, einschließlich Microsoft Copilot und ChatGPT.
Web IQ ist über REST bei https://api.microsoft.ai/v3 und über MCP unter https://api.microsoft.ai/v3/mcp verfügbar. Jede Web IQ AppID kann Websuche, Nachrichten, Bilder, Videos, Durchsuchen, Places und Auto aufrufen (ab dem 17. November 2026).
Was ist Web-Grounding, und wann benötigt ein KI-Agent es?
Web-Grounding bietet KI Zugriff auf die neuesten Webinformationen, damit sie Fragen anhand aktueller Fakten beantworten kann, die über ihre Trainingsdaten hinausgehen, mit zitierten Quellen, die Benutzer überprüfen können. Sie hilft am meisten bei sich häufig ändernden Informationen wie Marktentwicklungen, Wettbewerberaktivitäten, Nachrichten und regulatorischen Updates.
Ist Web IQ ein LLM? Generiert sie die endgültige Antwort?
Nein Web IQ ist kein KI-Modell oder LLM. Es ist eine Suite von KI-nativen Websuch- und Grounding-APIs, die LLMs, KI-Agents und Anwendungen Zugriff auf aktuelle, relevante Webinformationen bietet.
Web IQ generiert nicht die endgültige KI-Antwort. Relevante Informationen werden aus dem Web abgerufen, und Ihre ausgewählte LLM-, KI-Agent- oder Anwendungslogik verwendet diese Nachweise, um eine Antwort zu generieren.
Was unterscheidet Web IQ von anderen Websuch-APIs und Grounding-Diensten?
Die meisten Websuch-APIs erzwingen einen Kompromiss: schnell oder präzise, kosteneffizient oder vollständig. In den von Microsoft veröffentlichten Benchmarks war die P95-Latenz von Web IQ etwa doppelt so schnell wie der zweitschnellste getestete Dienst; Auto und Websuche erreichten eine höhere Grounding-Zufriedenheit bei niedrigeren Tokenanzahlen als die verglichenen Dienste, wobei Auto insgesamt am besten abschnitt; und Auto erzielte die höchste Bewertung im FreshSearch-Aktualitäts-Benchmark. Es ist die gleiche Plattform, auf die sich KI-Assistenten wie Copilot und ChatGPT jeden Tag verlassen, die auf globaler Ebene nachgewiesen ist und bereit ist, als Grundlage für jeden KI-Agenten oder jede App zu dienen.
Web IQ unterscheidet sich auch dadurch, wie es auf Inhalte zugreift. Es verfolgt einen verantwortungsvollen Ansatz für den Webzugriff, der das offene Web und strukturierte Daten mit integrierter Sicherheit und Schutz auf Unternehmensniveau zusammenführt.
Web IQ arbeitet mit dem KI-Stack, den Sie bereits verwenden. Sie können Ihr bevorzugtes KI-Modell verwenden und eine Verbindung über die REST-API oder das Model Context Protocol (MCP) herstellen, ohne an ein einzelnes Modell oder eine einzelne Plattform gebunden zu sein.
Quelle: Ergebnisse des Web IQ-Benchmarks (P95-Latenz, Qualität und Tokeneffizienz sowie Abschnitte zur Aktualität der Grounding-Daten).
Was kann ich mit Web IQ erstellen?
Web IQ treibt KI-Agenten und Anwendungen an, die frische, externe Informationen aus dem öffentlichen Web benötigen. Interne Teams können sie für Wettbewerbsbeobachtung, Monitoring, regulatorische Forschung, Sales Intelligence und Inhaltsoptimierung verwenden. Kundenorientierte Anwendungen können es für Forschung, Suche, Empfehlungen und spezialisierte Agenten verwenden.
Es eignet sich am besten für Szenarien, in denen sich Informationen häufig ändern, viele externe Quellen umfassen und auf aktuellen, belegbaren Webinhalten basieren müssen.
Welche Web IQ-API passt zu meinem Anwendungsfall?
Verwenden Sie die Web Search API, um relevante öffentliche Seiten und Passagen für Ihr Modell zu finden, die News API für aktuelle Ereignisse, die Images- und Videos-APIs für Bild- und Videoergebnisse, die Places API für strukturierte Ortsinformationen und die Browse-API, wenn Sie die URL bereits kennen. Überprüfen Sie die API-Referenz auf die für Ihr Konto verfügbaren Funktionen und Grenzwerte.
Kann ich Web IQ mit meinem vorhandenen KI-Modell und Agent-Framework verwenden?
Yes. Mit Web IQ können Sie dem von Ihnen ausgewählten KI-Modell- und Agent-Workflow Webinformationen hinzufügen. REST-APIs und MCP bieten Ihnen Flexibilität bei der Verbindung damit. Überprüfen Sie die SDK- und MCP-Integrationsdokumentation für unterstützte Konfigurationen.
Wie sieht die Integration aus?
Ihr KI-Agent oder Ihre Anwendung ruft Web IQ für Web-Belege auf und übergibt dann ausgewählte Ergebnisse an das Modell, um eine Antwort zu generieren. Sie steuern, wie die Informationen ausgewählt, verwendet und zitiert werden. Folgen Sie der Schnellstartanleitung , um Ihren ersten Workflow zu verbinden, oder beginnen Sie mit dem Playground.
Kann Web IQ private Unternehmensinformationen abrufen?
Nein Web IQ ruft Informationen aus dem öffentlichen Web ab. Im Unternehmenskontext bietet Microsoft Work IQ, Fabric IQ und Foundry IQ an, die jeweils eine andere Rolle spielen, vom Organisationskontext bis hin zu Geschäftsdaten und Unternehmenswissen.
Wie bezieht sich Web IQ auf Foundry IQ, Work IQ und Fabric IQ?
Microsoft IQ vereint vier integrierte Ebenen, die Enterprise Intelligence in ganz Microsoft fördern. Web IQ liefert Informationen aus dem öffentlichen Web. Work IQ konzentriert sich auf Arbeitssignale, Fabric IQ auf Geschäftsdaten und Foundry IQ auf Organisationswissen. Diese Produkte erfüllen unterschiedliche Informationsanforderungen für KI-Agents und -Anwendungen und sind am leistungsfähigsten, wenn sie zusammen verwendet werden.
Ist Web IQ eine Azure Ressource?
Sie stellen eine Web IQ-Ressource in Ihrem Azure-Abonnement bereit. Die Ressource übernimmt Messung und Abrechnung. Die Identität Ihrer Anwendung in Web IQ ist ihre Web IQ AppID, die erstellt wird, wenn Sie die Ressource im Web IQ Developer Portal verbinden.
Der Dienst selbst wird von Microsoft gehostet und ist mandantenfähig. Der Webabruf und die Rangfolge werden in der Microsoft-Infrastruktur ausgeführt, und Ihre Anwendung api.microsoft.ai über HTTPS aufruft. Die Azure-Ressource hostt Web IQ nicht und befindet sich nicht im Anforderungspfad.
Was ist der Unterschied zwischen einer Web IQ-Ressource und einer Web IQ AppID?
Eine Web IQ-Ressource ist die Azure Ressource, die Sie in Ihrem Azure-Abonnement, im Azure-Portal oder mit dem Azure CLI erstellen. Die Nutzung von Web IQ wird gemessen und über Ihr Abonnement in Rechnung gestellt. Die Ressource befindet sich nicht im Anfragepfad: Ihre Anwendung ruft api.microsoft.ai direkt auf.
Eine Web IQ AppID ist die Identität Ihrer Anwendung in Web IQ. Es wird erstellt, wenn Sie eine Web IQ-Ressource im Web IQ Developer Portal verbinden. Alles darüber, wie Ihre Anwendung Web IQ verwendet, wird auf der AppID festgelegt: welche APIs sie aufrufen kann, deren Ratelimit (standardmäßig 15 QPS), die API-Schlüssel und die an sie gebundenen Entra-Anwendungs-IDs (Client-IDs). Verwechseln Sie sie nicht mit der Entra-Anwendungs-ID (Client-ID) Ihrer App-Registrierung: Diese ID identifiziert Ihre Anwendung gegenüber Microsoft Entra ID, wenn sie ein Token erhält, und wird an eine Web IQ AppID gebunden.
Durch das Verbinden einer Ressource wird eine AppID erstellt, sodass die meisten Kunden mit jeweils einer Ressource und einer AppID beginnen. Wenn Sie mehr als eine AppID benötigen, z. B. eine pro Umgebung oder Workload, kann Ihr Microsoft Kontakt Ihnen die Optionen mitteilen.
Wo wird Web IQ bereitgestellt?
Web IQ wird von Microsoft gehostet und ist über den öffentlichen https://api.microsoft.ai/v3-Endpunkt verfügbar. Ihre Anwendung ruft die API auf, und Web IQ führt den serverseitigen Webabruf durch.
Gibt es dedizierte APIs für Finanzen, Sport oder Wetter?
Es gibt keine dedizierte Finanz-, Sport- oder Wetter-API. Bei Wetter gibt Auto strukturierte Wetterergebnisse (aktuelle Bedingungen, tägliche Prognosen und aktive Wetterwarnungen mit einem Link zur ausstellenden Behörde) zurück, wenn eine Abfrage über das Wetter erfolgt. Verwenden Sie für Finanzen, Sport und andere Themen die Websuche, die relevante durchforstete Inhalte als unstrukturierten Seitentext und nicht als strukturierten Feed zurückgibt.
Zugriff und Onboarding
Wie wechsle ich von der Evaluierung in den Produktivbetrieb?
- Füllen Sie Ihre Evaluierung aus, und bestätigen Sie, dass der Dienst Ihren Anforderungen entspricht.
- Erstellen Sie eine Web IQ-Ressource in einem kostenpflichtigen Azure-Abonnement, melden Sie sich dann beim Web IQ Developer Portal an, und verbinden Sie die Ressource. Dadurch wird Ihre Produktions-AppID erstellt, die Sie aus der Profilverwaltung kopieren können. Sie beginnt mit dem Standardgrenzwert von 15 Abfragen pro Sekunde (QPS).
- Um sich mit Microsoft Entra ID zu authentifizieren, binden Sie die Entra-Anwendungs-ID (Client-ID) Ihrer App-Registrierung an diese AppID im Entwicklerportal.
Ihre Nutzung von Web IQ unterliegt den Web IQ Nutzungsbedingungen im Rahmen Ihrer bestehenden Microsoft-Kundenvereinbarung.
Welche Azure Abonnements kann ich verwenden?
Web IQ erfordert ein kostenpflichtiges Azure-Abonnement, einschließlich Abonnements, die über einen Cloud Solution Provider (CSP)-Partner erworben wurden. Visual Studio, kostenlose Test- und Studentenabonnements und Azure Gutschriften funktionieren nicht für Web IQ. Wenn das Erstellen der Web IQ-Ressource aufgrund des Status Ihres Azure Kontos blockiert wird, werden Sie in der Fehlermeldung aufgefordert, sich an Ihr Microsoft-Konto Team zu wenden, das eine Überprüfung anfordern kann.
Welche APIs kann meine Anwendung aufrufen?
Jede Web IQ AppID kann Websuche, Nachrichten, Bilder, Videos, Durchsuchen, Orte und ab dem 17. November 2026 Auto aufrufen. Wenn Auto nach diesem Datum nicht unter "Zulässige Dienste " aufgeführt ist, öffnen Sie eine Web IQ-Supportanfrage mit Ihrer AppID. Um zu sehen, welche APIs Ihre AppID aufrufen kann, melden Sie sich beim Web IQ Developer Portal an, wechseln Sie zu Profilverwaltung, wählen Sie Ihre AppID nach Namen in der Dropdownliste oben links aus, und überprüfen Sie die zulässigen Dienste.
Wie erhalte ich Zugriff auf die Commerce-APIs?
Die Commerce-APIs (Suche, Angebote und Produktdetails) befinden sich in der privaten Vorschau für eine ausgewählte Gruppe von Azure Kunden. Wir erweitern den Zugriff während der Vorschau. Der Zugriff ist nicht garantiert. Um Zugriff zu beantragen, öffnen Sie eine Web IQ-Supportanfrage, wählen Sie Authentifizierung und Zugriff als Problemtyp aus, und schließen Sie Ihre AppID oder Ihren Firmennamen und den Namen Ihrer Web IQ-Ressource ein, wenn Sie noch keine AppID haben. Die Nutzung von Commerce wird pro Aufruf abgerechnet; siehe Preise. Die API-Referenz finden Sie unter Commerce.
Was können die Commerce-APIs tun? Unterstützen Sie den Checkout?
Es gibt drei Commerce-APIs. Die Suche wandelt eine Produktabfrage in rangierte Produkte um, die jeweils Verkäuferangebote (Preis, Verkäufer, ein Link zum Angebot, Bilder, Versandinformationen und Zustand) enthalten. Angebote geben die berechtigten Verkäuferangebote für ein Produkt aus einem Suchergebnis zurück. Produktdetails geben den Titel, die Beschreibung und die durchschnittliche Bewertung eines Produkts zurück. Die Commerce-APIs unterstützen keine Kaufabwicklung, keine Zahlung oder andere Transaktionen: sie geben Produkt- und Angebotsinformationen zurück, mit Links zu den einzelnen Angeboten beim Händler.
Wie sollte meine Anwendung auf Commerce-Angebote verlinken?
Verwenden Sie die clickUrl jedes Angebots genau so, wie sie in dieser Antwort für jeden Link oder jede Navigation zum Angebot zurückgegeben wird, von einem Benutzer oder von einem Agenten, der für den Benutzer fungiert. Entfernen Sie es nicht, schreiben Sie es nicht um, kürzen oder wiederverwenden Sie es nicht, und verknüpfen Sie es nicht mit displayUrl, mit dem nur der Händler oder Verkäufer identifiziert wird. Sie können den clickUrl nur in Ihren eigenen Tracking-Link einbetten, wenn dieser das Original unverändert weiterleitet. Erstellen Sie jeden Link im Anwendungscode aus der Antwort, anstatt es von einem Modell reproduzieren zu lassen. Ausführliche Informationen finden Sie unter Angebotslinks und Attribution und Anlage B der Web IQ Nutzungsbedingungen.
Welche Adresse sollte ich für die Anmeldung verwenden?
Verwenden Sie die Microsoft Anmeldeadresse, die Zugriff auf Web IQ hat: die Adresse, die für Sie aktiviert Microsoft, oder das Konto, das Sie zum Verbinden Ihrer Web IQ-Ressource im Web IQ Developer Portal verwendet haben. Dies ist normalerweise die Adresse, die Sie für Azure, Teams oder Office verwenden, die sich von Ihrer Postfachadresse unterscheiden kann.
Um dies zu bestätigen, melden Sie sich bei Azure Portal an, und überprüfen Sie die Adresse in der oberen rechten Ecke.
Warum sagt die Anmeldung, dass ich keinen Zugriff habe?
Vergewissern Sie sich zunächst, dass die in der oberen rechten Ecke des Azure Portals angezeigte Adresse genau mit der Adresse übereinstimmt, die Zugriff auf Web IQ hat. Organisationen verwenden häufig eine Adresse für Microsoft Anmeldung und eine andere für E-Mail.
Wenn die Adressen übereinstimmen, kann Ihre Organisation den mandantenübergreifenden Gastzugriff auf den Mandanten der Microsoft Corporation blockieren. Bitten Sie Ihren IT-Administrator, diesen Zugriff zuzulassen.
Wo erhalte ich Hilfe?
Besuchen Sie die Microsoft Web IQ Support-Website, um Produktunterstützung zu erhalten. Bei Fragen zu zulässiger Nutzung, Datenschutz, Speicherung oder Anzeige lesen Sie bitte die aktuellen Web IQ Nutzungsbedingungen und Ihre geltende Kundenvereinbarung.
API-Authentifizierung
Welche Authentifizierungsmethoden werden unterstützt?
Web IQ unterstützt:
- Microsoft Entra ID-Bearertoken werden über den OAuth 2.0-Clientanmeldeinformationsfluss abgerufen. Dies wird für Produktionsworkloads empfohlen.
- API-Schlüssel, die im
x-apikeyAnforderungsheader gesendet werden.
Der gesamte API-Datenverkehr verwendet HTTPS.
Wie kann ich die Server-zu-Server-Authentifizierung konfigurieren?
Registrieren Sie eine Anwendung in Microsoft Entra ID, und verwenden Sie den OAuth 2.0-Clientanmeldeinformationsfluss. Verknüpfen Sie die Entra-Anwendungs-ID (Client-ID) der App-Registrierung mit Ihrer Web IQ AppID im Web IQ Developer Portal, erwerben Sie ein Zugriffstoken und senden Sie es als Authorization: Bearer <access_token>.
Siehe Authentifizierung für die vollständigen Einrichtungsschritte.
Kann ich meine eigenen API-Schlüssel verwalten?
Yes. Sie können beliebig viele API-Schlüssel im Web IQ Developer Portal erstellen. Für das Erstellen von Schlüsseln fallen keine Gebühren an.
Verwendet Web IQ Azure RBAC für die API-Autorisierung?
Nein Web IQ ist ein Microsoft gehosteter Dienst, den Sie über das Internet aufrufen. Die Web IQ-Ressource, die Sie in Ihrem Azure-Abonnement bereitstellen, verarbeitet die Verbrauchserfassung und Abrechnung, aber sie liegt nicht im Pfad der Anfragen, sodass es keine Dienstressource gibt, an die Azure RBAC-Rollen angehängt werden können.
Web IQ autorisiert Anfragen pro AppID. Jede AppID verfügt über ein eigenes Berechtigungsprofil für Inhalte und Kontingent, und nicht autorisierte Aufrufe geben HTTP 403 zurück. Wenn Sie Teams oder Workloads trennen möchten, z. B. mit unterschiedlichen Zugriffsrichtlinien oder Kontingenten, verwenden Sie mehrere AppIDs.
Kann eine Entra-Anwendungs-(Client-)ID mehrere Web IQ AppID aufrufen?
Yes. Eine einzelne Entra-Anwendungs-ID (Client-ID) kann zum Aufrufen einer oder mehrerer AppIDs autorisiert werden. Um die AppID auszuwählen, übergeben Sie sie als Abfrageparameter, z. B https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>. . Die API löst die AppID wie folgt auf:
- Ihre Entra-Anwendungs-ID (Client-ID) ist an eine AppID gebunden: Wenn Sie keine AppID angeben oder diese AppID angeben, ist die Anforderung erfolgreich (HTTP 200). Wenn Sie eine andere AppID angeben, gibt die Anfrage HTTP 403 zurück.
- Ihre Entra-Anwendungs-ID (Client) ist an mehrere AppIDs gebunden: Sie müssen eine angeben. Eine fehlende oder leere AppID gibt HTTP 400 zurück; eine Ihrer gebundenen AppIDs gibt HTTP 200 zurück; jede andere AppID gibt HTTP 403 zurück.
- Ihre Entra-Anwendungs-ID (Client-ID) ist nicht an eine AppID gebunden: Die Anforderung gibt HTTP 401 zurück.
Die API-Schlüsselauthentifizierung (x-apikey) ist nicht betroffen. Jeder API-Schlüssel ist an eine einzelne AppID gebunden, daher wird APPID nie benötigt oder für schlüsselauthentifizierte Aufrufe akzeptiert.
Welche Authentifizierung sollte ein gehosteter Agent verwenden: Verwaltete Identität oder AgentID?
Beide funktionieren. Verwaltete Identitäten und AgentID sind beide Entra ID Identitäten, und Web IQ akzeptiert alle Entra-Identitäten, deren Entra-Anwendungs-ID (Client-ID) auf der Seite „Profile Management“ des Web IQ Developer Portals an Ihre Web IQ AppID gebunden ist.
Welche davon Sie verwenden, hängt davon ab, wo der Agent gehostet wird:
- Managed Identity passt zu Agents, die auf Azure Infrastruktur ausgeführt werden, z. B. Foundry, App Service, Container-Apps, AKS, Funktionen oder VMs. Vom System zugewiesene und vom Benutzer zugewiesene Identitäten funktionieren beide.
- AgentID passt zu Foundry oder Copilot Studio gehosteten Agents, die eine Agentidentität verfügbar machen.
- Agents, die außerhalb Azure gehostet werden, z. B. in Ihrem eigenen Kubernetes-Cluster oder einer anderen Cloud, können eine standardmäßige Entra-Anwendungsregistrierung mit einem geheimen Clientschlüssel oder Verbundanmeldeinformationen verwenden.
In jedem Fall verwendet der Aufruf den OAuth 2.0-Clientanmeldeinformationsfluss und sendet das Token als Authorization: Bearer <access_token>. Siehe Authentifizierung für die Einrichtungsschritte. Ein API-Schlüssel im x-apikey Header bleibt die einfachere Option für Prototypen.
Netzwerke und Sicherheit
Unterstützt Web IQ Private Link, private Endpunkte, VNet-Integration oder IP-Zulassungsliste?
Nein Keines davon wird derzeit unterstützt. Auf Web IQ wird über einen einzelnen öffentlichen Endpunkt https://api.microsoft.ai/v3, über HTTPS mit Entra ID oder API-Schlüsselauthentifizierung zugegriffen. Es gibt keine IP-basierte Zugriffssteuerung am API-Endpunkt.
Die Web IQ-Ressource in Ihrem Azure-Abonnement verarbeitet Nutzungs- und Abrechnungsdaten, ist aber nicht im Anfragepfad, daher haben Azure-Netzwerksteuerelemente wie Private Link, VNet-Integration, Azure Firewall, NSGs und Hub-and-Spoke-Topologien nichts auf der Web IQ-Seite, an das sie angefügt werden können. Die Identitätsintegration (Entra ID) ist an Azure ausgerichtet; die Netzwerkschicht ist nicht.
Lassen Sie auf Ihrer Seite den api.microsoft.ai Hostnamen in Ihren Regeln für ausgehenden Datenverkehr zu.
Bleibt der Datenverkehr von Azure zu Web IQ im Netzwerk Microsoft oder im Azure Backbone?
Dies ist nicht garantiert. Clients stellen eine Verbindung mit dem öffentlichen https://api.microsoft.ai Endpunkt her, und Datenverkehr wird bei der Übertragung mit HTTPS gesichert.
Der Web IQ-API-Datenverkehr wird bei Azure Front Door beendet, der TLS 1.2 und TLS 1.3 mit diesen Cipher Suites unterstützt:
-
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
Wird Zscaler oder ein anderes Tool zur Egress-Inspektion Web IQ beeinträchtigen?
Es sollte nicht stören, wenn es so konfiguriert ist, dass Verbindungen zu api.microsoft.ai zugelassen werden. Dies ist eine Standard-Allowlist-Aktion, keine weitreichende Umgehung. Der gleiche Ansatz gilt für andere sichere Webgateways wie Netskope.
Kann ich Web IQ hinter Azure API Management setzen?
Yes. Sie können Azure API Management oder ein anderes Gateway in Ihrem eigenen Azure-Abonnement vor Web IQ für Observability und Governance platzieren, und es gibt keine bekannten Einschränkungen, die dies verhindern. API-Aufrufe gehen von Ihrem Aufrufer zu https://api.microsoft.ai/v3 über TLS mit einem API-Schlüssel oder Entra ID-Token, sodass alles, was Sie vor diesen Datenverkehr schalten, Ihre eigene Infrastruktur in Ihrem Mandanten ist. Microsoft veröffentlicht keine Referenzarchitektur für diese Bereitstellungen; Ihr Cloudarchitekturteam ist für diesen Entwurf verantwortlich.
Unter den Web IQ Nutzungsbedingungen können Antwortinhalte nicht zwischengespeichert oder gespeichert werden, um ein abgeleitetes Dataset zu erstellen, unabhängig davon, was das Gateway tut. Betriebstelemetrie wie Status, Latenz, Header und Ablaufverfolgungs-IDs können beibehalten werden, z. B. in Application Insights oder Log Analytics.
Welche Sicherheitskontrollen sind verfügbar?
- Authentifizierung: Entra ID (OAuth 2.0-Clientanmeldeinformationen) oder ein API-Schlüssel.
- Autorisierung: Zugriff pro AppID auf APIs. Nicht autorisierte Aufrufe geben HTTP 403 zurück.
- Ratenbegrenzung: Erzwingung von Kontingenten pro AppID. Anfragen über dem Limit geben HTTP 429 zurück.
- Transport: Nur HTTPS.
Die Netzwerkrichtlinie an Ihrer Netzwerkgrenze liegt in Ihrer Verantwortung. Wenn Sie bestimmte Architekturanforderungen haben, die Sie bewerten möchten, wenden Sie sich an den Web IQ-Support.
Ratenbeschränkungen und API-Schlüssel
Gibt es ein Anfragelimit?
Yes. Jede Web IQ AppID hat einen Standardgrenzwert von 15 Abfragen pro Sekunde (QPS). Eine Web IQ-Ressource verfügt in der Regel über eine AppID, die erstellt wird, wenn Sie die Ressource anbinden. Das Web IQ Developer Portal zeigt den Grenzwert an.
Der Grenzwert wird von allen API-Schlüsseln und gebundenen Entra-Anwendungs-(Client-)IDs für diese AppID gemeinsam genutzt. Anfragen über dem Limit geben HTTP 429 zurück.
Kann ich mein Ratenlimit erhöhen?
Yes. Jede Web IQ AppID unterstützt mindestens 15 QPS. Um ein höheres Limit anzufordern, öffnen Sie eine Support-Anfrage für Web IQ mit Ihrem erwarteten Anfragevolumen und Anwendungsfall.
Wie viele API-Schlüssel kann ich erstellen?
Sie können so viele Schlüssel erstellen, wie Ihre Anwendung benötigt. Die Schlüsselerstellung ist kostenlos, aber alle Schlüssel für eine AppID teilen sich ihr Ratenlimit.
Datenschutz und Datenverarbeitung
Protokolliert Web IQ API-Abfragen?
Yes. API-Anfragen werden für betriebliche Zwecke protokolliert: Dienstsicherheit, Debugging und Qualitätsverbesserung. Dies ist Standard für Microsoft-Dienste.
- Der Zugriff ist auf autorisiertes Microsoft-Engineering- und Betriebspersonal beschränkt und unterliegt den internen Zugriffssteuerungsrichtlinien von Microsoft. Andere Kunden oder Dritte können nicht auf Daten in Protokollen zugreifen.
- Protokolle werden in Microsofts Produktionsinfrastruktur gespeichert und unterliegen Microsofts standardmäßigen Sicherheitskontrollen, einschließlich rollenbasierter Zugriffssteuerung und Auditprotokollen.
- Protokolle werden während der Übertragung (HTTPS) und im Ruhezustand mit Microsofts standardmäßigen Verschlüsselungsverfahren verschlüsselt.
Microsoft fungiert als Datenverantwortlicher gemäß der Microsoft-Datenschutzerklärung.
Wie lange werden Abfragen aufbewahrt?
Die Aufbewahrung der Abfragetelemetrie unterliegt Abschnitt 4 der Web IQ Nutzungsbedingungen, wodurch Microsofts Verarbeitung der Microsoft-Datenschutzerklärung unterliegt. Es gibt keine separate Web IQ-spezifische Aufbewahrungsverpflichtung, die über das in der Datenschutzerklärung Beschriebene hinausgeht.
Kann ich die Abfrageprotokollierung für regulierte oder vertrauliche Workloads deaktivieren?
Der Abfragetext wird als Teil der Standardanforderungstelemetrie erfasst, und seine Verarbeitung wird durch die Microsoft-Datenschutzbestimmungen und Abschnitt 4 der Web IQ-Nutzungsbedingungen geregelt.
Wenn Sie über eine bestimmte regulatorische oder Compliance-Anforderung verfügen, bietet Web IQ Zero Query Logging, wodurch Abfragetext aus der Telemetrie unterdrückt wird. Die Abfrage wird weiterhin an Microsoft gesendet, um die Anforderung zu erfüllen; Zero Query Logging hält den Abfragetext aus unseren Protokollen heraus. Es ist nicht Selbstbedienung: Unser Produktteam aktiviert es für Sie, für alle Ihre Anwendungen oder nur für bestimmte Anwendungen. Um dies anzufordern, wenden Sie sich an Ihr Microsoft-Konto Team, und teilen Sie Folgendes:
- Das regulatorische oder Compliance-Framework, das gilt (z. B. GLBA, HIPAA, DSGVO oder APPI).
- Eine kurze Beschreibung Ihres Bereitstellungsszenarios.
Bei der Zero Query Logging werden der Abfragetext, Ergebnistitel und URLs, die IP-Adresse und die Entra-Anwendungs-ID nicht beibehalten. Die Felder "AppID", "Ablaufverfolgungs-ID", "Anzeigedauer", "Status" und "Abrechnung" werden beibehalten, damit wir den Dienst ausführen und abrechnen können. Es gibt nichts, das Sie auf Ihrer Seite konfigurieren müssen.
Kann ich überprüfen, ob Zero Query Logging aktiviert ist?
Nicht im Web IQ Developer Portal oder der API heute. Wenn Sie eine Bestätigung benötigen, z. B. für eine Prüfung, öffnen Sie eine Web IQ-Supportanfrage mit Ihrer AppID, und web IQ Support bestätigt die Einstellung schriftlich.
Welche Daten-Residency-Verpflichtungen bietet Web IQ?
Heute keine. Web IQ macht keine regionsspezifischen Zusagen zur Datenresidenz oder zur Verarbeitung in der Region, und das regionsübergreifende Routing an den nächstgelegenen verfügbaren Endpunkt wird erwartet. Der Datenschutz wird durch die Microsoft Datenschutzerklärung abgedeckt. Microsoft gibt keine Zusicherungen hinsichtlich des Standorts oder der Staatsangehörigkeit des Personals, das auf die Daten zugreifen kann.
Wird Web IQ durch den Azure-Datenschutzzusatz oder die EU Data Boundary abgedeckt?
Nein Abschnitt 4.1 der Web IQ Nutzungsbedingungen nimmt den Dienst von dem Microsoft Produkte und Dienste Datenschutz-Nachtrag aus.
Stattdessen fungieren Microsoft und der Kunde als unabhängige Datenverantwortliche für alle personenbezogenen Daten, die unter den Nutzungsbedingungen verarbeitet werden (Abschnitt 4.4). die Verarbeitung durch Microsoft unterliegt den Microsoft Datenschutzbestimmungen (Abschnitt 4.2), und Sie sind dafür verantwortlich, Ihren Endbenutzern entsprechende Hinweise zu erteilen.
Bei internationalen Datenübermittlungen schließen die Nutzungsbedingungen Standardvertragsklauseln ein, sofern erforderlich (Abschnitt 4.6.1). Dieser Übertragungsmechanismus erfolgt über die Nutzungsbedingungen, die sich unter Ihrem Microsoft-Kundenvereinbarung befinden, nicht durch den Datenschutzzusatz.
Web IQ gibt heute keine Zusagen zu EU-Datengrenze, regionsspezifischer Datenresidenz oder zur Verarbeitung in der Region.
Erkennt oder maskiert Web IQ personenbezogene Daten in Abfragen?
Nein Web IQ führt keine serverseitige Erkennung oder Maskierung personenbezogener Daten in eingehenden Abfragen durch. Wenn eine Workload personenbezogene oder vertrauliche Daten senden kann, bereinigen Sie sie vor dem Aufrufen von Web IQ, z. B. mit Azure KI Language PII Detection als Vorverarbeitungsschritt. Auf diese Weise verlässt nichts Sensibles Ihre Umgebung, und Sie behalten die volle Kontrolle darüber, was an die API gesendet wird.
Unterstützt Web IQ regulierte Branchen?
Yes. Web IQ unterstützt eine Reihe von Unternehmens- und regulierten Anwendungsfällen. Wenn Sie spezielle Compliance-, Governance- oder Branchenanforderungen haben, wenden Sie sich an den Web IQ-Support.
Inhaltssicherheit und Abdeckung
Welche Sicherheitskontrollen für Inhalte werden angewendet?
Web IQ wendet eine Qualitäts- und Sicherheitsklassifizierung zum Crawl-Zeitpunkt, Filterung von Erwachseneninhalten und Regeln zur Berechtigung von Inhalten pro Kunde an. SafeSearch wird standardmäßig auf strict serverseitig erzwungen. Websuchergebnisse enthalten auch ein isAdult Feld für zusätzliche clientseitige Behandlung.
Schützt Web IQ ein LLM vor Prompt-Injection in abgerufenen Inhalten?
Microsoft Web IQ ruft Inhalte aus dem Web ab und bewertet sie. Sie führt keine Anweisungen aus, die in abgerufenen Inhalten eingebettet sind, interpretiert sie nicht oder handelt danach. Web IQ ergänzt dieses Abrufverhalten durch das vorhandene Qualitäts-, Vertrauens-, Spam- und Böswilligkeits-Screening von Bing.
Der Schutz vor indirekter Prompt-Injection, Jailbreak-Versuchen und Angriffen auf die Befolgung von Anweisungen liegt in erster Linie in der Verantwortung der nachgeschalteten Modell- und Orchestrierungsebene. Behandeln Sie Eingabeaufforderungen und abgerufene Inhalte als nicht vertrauenswürdige Eingaben und wenden Sie mehrstufige Steuerelemente wie Prompt Shields, Azure KI Inhaltssicherheit, System-Prompt-Isolation, Toolzugriff mit minimalen Berechtigungen, Grounding-Validierung und Ausgabeüberprüfung an. Web IQ sollte nicht als einziger Durchsetzungspunkt für die Abwehr von Prompt-Injection behandelt werden.
Wie werden Webinhalte verarbeitet, bevor Web IQ sie zurückgibt? Ist es für promptähnliche Anweisungen bereinigt?
Microsoft Web IQ arbeitet zum Abrufzeitpunkt nicht direkt mit dem rohen HTML der Seite. Während der Indizierung werden Webinhalte in eine strukturierte Dokumentdarstellung normalisiert, die so konzipiert ist, dass sinnvolle Inhalte und die Dokumentstruktur erhalten bleiben. Passagen, die von Web IQ zurückgegeben werden, werden aus dieser Darstellung ausgewählt, was eine konsistentere Extraktion und Abruf über die API-Oberfläche ermöglicht. Die vorhandene Qualitäts-, Sicherheits-, Spam- und Schadsoftwareprüfung von Bing gilt auch als Teil der Indizierungspipeline.
Web IQ kann nicht garantieren, dass zurückgegebene Inhalte frei von Skripts oder Schadsoftware sind, und diese Normalisierung ist keine Garantie dafür, dass promptähnlicher Text identifiziert oder entfernt wird. Behandeln Sie abgerufene Inhalte als nicht vertrauenswürdige Eingaben und wenden Sie die in der vorherigen Antwort beschriebenen Schutzmaßnahmen auf Modell- und Orchestrierungsebene an.
Gibt Web IQ ausgeblendete oder nicht benutzerorientierte Seiteninhalte zurück?
Microsoft Web IQ versucht, Inhalte zurückzugeben, die durch normale Benutzerinteraktionen sichtbar sind, einschließlich Inhalten, die über normale Seitensteuerelemente oder clientseitiges Rendering sichtbar werden. Dies ist nicht garantiert. Seitenstruktur und Implementierung variieren, daher sollten Anwendungen nicht davon ausgehen, dass jede zurückgegebene Passage im Anfangszustand der Seite sichtbar war oder dass jedes ausgeblendete Element immer ausgeschlossen wird.
Wie behält Microsoft die Indexqualität bei?
Seiten werden für Qualität, Autorität und Vertrauenswürdigkeit ausgewertet. Bösartige Inhalte, Spam und Phishing werden erkannt und ausgeschlossen, und der Index wird kontinuierlich aktualisiert. Es ist derselbe Index, von dem Microsofts eigene KI-Produkte abhängen.
Wie berücksichtigt Web IQ Die Inhaltseinstellungen von Herausgebern?
Web IQ wurde entwickelt, um unterstützte Publisher-Steuerelemente zu berücksichtigen, einschließlich anwendbarer robots.txt-Direktiven und anderer Herausgebersignale, die von Microsoft erkannt werden.
Gibt es eine veröffentlichte Liste der ausgeschlossenen Websites oder blockierten Kategorien?
Nein Ausschlussmechanismen umfassen die Einhaltung von robots.txt, Legal- und Compliance-Entfernungen (z. B. DMCA-Hinweise und Gerichtsordnungen), Spam-, Schadsoftware- und Phishingfilterung sowie die Filterung von Inhalten für Erwachsene. Die Listen selbst sind proprietär und werden kontinuierlich aktualisiert. Wenn Sie Bedenken bezüglich bestimmter Kategorien von Inhalten haben, die in Ergebnissen angezeigt oder nicht angezeigt werden, wenden Sie sich an den Web IQ-Support , um zu besprechen, ob die Konfiguration Ihrer Web IQ AppID diese Anforderungen erfüllt.
Welche Inhalte deckt Web IQ ab und wie frisch ist es?
Web IQ ruft ständig frische Informationen auf Webseiten, in Nachrichten sowie in Bild- und Videoergebnissen ab, um Ihren KI-Agenten oder Ihre Anwendung bei der Beantwortung von Fragen zu unterstützen, die über die Trainingsdaten seines Modells hinausgehen.
Verfügbarkeit und Aktualität variieren je nach API, Quelltyp und Anwendungsfall; es gibt keine einzige Aktualitätsgarantie für alle Inhalte. Berücksichtigen Sie beim Auswählen von Quellen- und Abrufeinstellungen die Aktualitätsanforderungen Ihrer Workload.
Welche Sprachen und Märkte unterstützt Web IQ?
Web IQ bezieht Daten aus dem globalen Web, aber die Abdeckung variiert je nach Sprache, Markt, Thema und Quelltyp. Überprüfen Sie die Seite Unterstützte Sprachen und Regionen für die Codes, die jede API akzeptiert, und bewerten Sie die Abdeckung anhand der Informationen, die Ihre beabsichtigten Benutzer benötigen.
Kunden in China sollten https://api.microsoftol.com/v3 anrufen; Die Nachrichtensuche ist dort nicht verfügbar (Basis-URL).
Kann ich Domänen-Zulassungs- oder Ablehnungslisten konfigurieren?
Verwenden Sie für einzelne Domänen oder kleine Listen Standardabfrageoperatoren, z. B. site:example.com zum Einschließen einer Domäne und -site:example.com zum Ausschließen einer Domäne. Um einen benannten Satz von Einschluss- und Ausschlussregeln in der Websuche oder Nachrichtensuche wiederzuverwenden, erstellen Sie einen Web IQ-Bereich für ein Abrechnungskonto mit verfügbarer Bereichsverwaltung. Benannte Bereiche unterstützen bis zu 10.000 normalisierte eindeutige Selektoren pro Liste, vorbehaltlich des kombinierten Grenzwerts für die Definitionsgröße.
Warum werden LinkedIn-Ergebnisse nicht angezeigt?
LinkedIn Ergebnisse sind derzeit ausgeschlossen.
Was geschieht, wenn „Browse“ für eine ausgeschlossene URL aufgerufen wird?
Browse gibt HTTP 403 zurück. Die zugrunde liegende Ausschlussliste wird nicht offengelegt.
Wie kann ich meine Website für Web IQ auffindbar machen?
Web IQ basiert auf demselben Webindex, den Microsoft für seine eigenen KI-Produkte verwendet. Verwenden Sie standardmäßige Web-Discovery-Methoden wie Sitemaps, IndexNow, Bing Webmaster-Tools und eine entsprechende robots.txt Richtlinie. Es gibt keinen separaten Web IQ-Übermittlungspfad.
Benannte Suchbereiche
Wie kann ich die Ergebnisse von Web IQ steuern und filtern?
Verwenden Sie Scopes, um Websuche- und Newssuchergebnisse mit wiederverwendbaren LISTEN von URLs, Websites, Domänen oder Pfaden zu filtern, die eingeschlossen oder ausgeschlossen werden sollen. Erstellen Sie einen benannten Scope, und wählen Sie ihn dann mit dem Anforderungsparameter scopeName aus. Ausschlüsse haben Vorrang vor Einschlüssen. Siehe Ergebnisse mit Scopes filtern.
Wie unterscheidet sich ein Web IQ-Abrechnungskonto von einer AppID oder Entra-Client-ID?
Ein Web IQ-Abrechnungskonto gruppiert Web IQ AppIDs, Kontozugriff und eine zugewiesene Scope Collection. Eine Web IQ AppID wählt die Laufzeitsuchkonfiguration Ihrer Anwendung aus. Eine Entra-Anwendungs-ID (Client) identifiziert die App-Registrierung, die Entra-Token erwirbt; sie ist keine der beiden Web IQ-IDs. Siehe die wichtigsten Konzepte und die Ermittlung autorisierter Ressourcen.
Kann ich meine Suchanmeldeinformationen verwenden, um Scopes zu erstellen?
Der Suchzugriff gewährt nicht automatisch Verwaltungszugriff. Eine Anwendung, die die Kundenverwaltungs-API aufruft, benötigt ein Nur-App-Entra-Token und CustomerApiAccess auf das beabsichtigte Abrechnungskonto. Ein menschlicher Kontoadministrator gewährt dies separat. Siehe Erteilen des Verwaltungs-API-Zugriffs auf die Anwendung.
Sind Scopes spezifisch für eine Web IQ AppID?
Nein Web IQ AppIDs in einem Abrechnungskonto verwenden die zugewiesene Scope-Sammlung. Namen sind innerhalb dieser Sammlung eindeutig, unabhängig von der Groß-/Kleinschreibung. Konten, die derselben Sammlung zugewiesen sind, teilen sich ihre Definitionen, sodass Bearbeitungen oder Löschungen alle Verbraucher dieser Definitionen betreffen. Die Kenntnis eines Namens gewährt keinen Zugriff auf die Scopes eines anderen Kontos.
Deaktiviert eine leere eingeschlossene Liste einen Scope?
Nein Ein leerer Einschluss erlaubt jede nicht ausgeschlossene Quelle. Wenn beide Listen leer sind, legt der Bereich selbst keine Website-Beschränkung fest. Ausschluss hat immer Vorrang vor einschluss.
Was geschieht, wenn die Suche meinen Scope nicht finden kann?
failOnMissingScope ist standardmäßig auf true gesetzt: Ein gemeldeter Fehler bei der Anwendung des Bereichs gibt einen Fehler zurück und kein Ergebnis ohne Bereich. Ein falscher Name oder eine unvollständige Weitergabe kann dazu führen, dass der Scope fehlt. Wenn Sie false explizit festlegen, kann die Suche mit dem gesamten Index ohne den Gültigkeitsbereich fortgesetzt werden und scopeApplied: false melden. Verwenden Sie diese Einstellung nur, wenn Ergebnisse ohne Bereich zulässig sind. Siehe Fehler zu benannten Scopes.
Bedeutet scopeApplied true, dass die Suche meine neueste Bereichsdefinition verwendet hat?
Nein
scopeApplied: true bedeutet, dass ein Bereich für diese Anforderung angewendet wurde. Sie identifiziert nicht die verwendete Version und garantiert keine globale Propagierung. Das Feld ist optional, wenn kein Anwendungsergebnis gemeldet wird; gehen Sie nicht davon aus, dass es immer vorhanden ist oder bei Anfragen ohne scopeName als false vorliegt.
Wenn die Verwendung einer vorherigen Definition während des Rollouts inakzeptabel ist, erstellen und überprüfen Sie einen Scope unter einem neuen Namen, bevor Sie aufrufende Clients umstellen. Es gibt noch keinen Readiness-Endpunkt oder eine Scope-Versionierung. Die vollständige globale Verteilung dauert in der Regel etwa 10 Minuten, kann jedoch in einigen Fällen bis zu 30 Minuten dauern. Es gibt derzeit keine SLA für die Verteilung, und diese Zeitangaben werden nicht garantiert. Der Wechsel von Anrufern ist nicht global atomisch.
Abfrageverhalten und Ergebnisqualität
Sollte ich Abfragen mit natürlicher Sprache oder Stichworten verwenden?
Beide funktionieren. Abfragen in natürlicher Sprache funktionieren häufig gut mit contentFormat=passage, während Stichwortabfragen für präzise Nachschlagevorgänge wie Firmennamen, Ticker oder bestimmte Themen nützlich sind. Vermeiden Sie übermäßig lange oder zusammengesetzte Abfragen; teilen Sie mehrere Informationsanforderungen in separate API-Aufrufe auf.
Was ist die maximale Abfragelänge?
Das Maximum beträgt 1.000 Zeichen, und längere Abfragen werden abgelehnt. Kürzere, fokussierte Abfragen erzielen in der Regel bessere Ergebnisse: Wenn eine Abfrage viel Kontext enthält, konzentriert sich der Abruf möglicherweise nicht auf das richtige Signal.
Kann ich Websuchergebnisse nach Datum filtern?
Die Websuche bietet heute keinen Datumsbereichsfilter, und es wird empfohlen, einen harten Datumsfilter zu vermeiden, es sei denn, Sie benötigen einen. Die Aktualität wird bereits basierend auf der Abfrage bei der Rangfolge berücksichtigt, und das Hinzufügen einer strikten Datumsbeschränkung kostet fast immer die Relevanz. Verwenden Sie für Nachrichtenszenarien die Nachrichten-API, anstatt Websuchergebnisse nach Datum zu filtern.
lastUpdatedAt ist das Datum, an dem der Herausgeber den Inhalt zuletzt aktualisiert hat, nicht das Datum, an dem Web IQ die Seite zuletzt überprüft hat, sodass ein älteres Datum nicht bedeutet, dass die Seite kürzlich nicht überprüft wurde. Es wird in der Antwort zurückgegeben, es ist kein Anforderungsfilter, und nicht jedes Ergebnis enthält es. Sie können es verwenden, um Ergebnisse in Ihrer Anwendung zu sortieren oder zu filtern.
Kann die Websuche eine Eingabeaufforderung verarbeiten, die mehrere Fragen enthält?
Jede Websuchanforderung verarbeitet eine Abfrage. Wenn eine Eingabeaufforderung mehrere Fragen oder Absichten enthält, teilen Sie sie in separate Abfragen in Ihrer Anwendung auf, rufen Sie die Websuche für jede auf, und kombinieren Sie die Ergebnisse, bevor Sie die Antwort generieren.
Kann Web IQ Workflows mit mehreren Schritten unterstützen?
Yes. Ein Agent kann Web IQ aufrufen, wenn er während einer Aufgabe zusätzliche Web-Nachweise benötigt. Die Abruflatenz ist besonders wichtig bei Workflows, die mehrere Aufrufe tätigen, bevor eine Antwort erzeugt wird.
Wie sollte mein KI-Agent oder meine Anwendung abgerufene Nachweise verarbeiten?
Verwenden Sie für die Frage relevante Belege, und halten Sie fest, welche Quellen die Antwort stützen. Halten Sie abgerufene Inhalte getrennt von Anweisungen, die den Agent steuern. Wenn Quellen konflikte oder Belege unvollständig sind, machen Sie diese Unsicherheit klar, anstatt Lücken mit unbelegten Aussagen zu füllen.
Wie ist die Erdungsqualität im Vergleich?
Im veröffentlichten Vergleich von Microsoft erreichten Auto und Web Search eine höhere Grounding-Zufriedenheit bei niedrigeren Tokenanzahlen als die verglichenen Dienste, und Auto erreichte insgesamt die höchste Grounding-Zufriedenheit. Die Ergebnisse hängen von Abfragemenge, Modell und Auswertungsmethode ab. Validieren Sie die Qualität in Ihren eigenen Szenarien.
Quelle: Web IQ Benchmark Ergebnisse. 2.850 zufällig erfasste globale Abfragen, ausgewertet am 8. bis 9. November 2026.
Behandelt Web IQ Gesundheitsquellen anders?
Die Bewertungsmodelle von Web IQ nutzen Signale für die Glaubwürdigkeit der Quelle. Bei gesundheitsbezogenen Abfragen basieren diese Signale auf Prinzipien, die unabhängig von der National Academy of Medicine entwickelt wurden. Dies gilt für die Websuche und für Auto-Ergebnisse, die aus der Websuche stammen; sie gilt nicht für News. Das geschieht automatisch: es gibt nichts zu aktivieren. Wir veröffentlichen die Liste oder die Anzahl der Quellen nicht. Verwenden Sie Scopes, um die Ergebnisse auf von Ihnen ausgewählte Websites zu beschränken.
Warum unterscheiden sich die Ergebnisse von Bing.com?
Web IQ ist für LLM-Verbrauch, Faktendichte, Passagenqualität und niedrige Latenz optimiert. Bing.com ist ein Angebot für Endverbraucher mit zusätzlichen Rankingsignalen, Personalisierung, visuellen Antworten und Inhalten, die möglicherweise nicht über eine API weiterverteilt werden können. Einige Bewertungsunterschiede werden erwartet.
Können identische Anfragen unterschiedliche Ergebnisse zurückgeben?
Einige Variationen werden erwartet, da der Index kontinuierlich aktualisiert und Aktualisierungen über Rechenzentren verteilt werden. Die Ergebnisse für identische Anfragen, die kurz hintereinander gestellt wurden, sollten weitgehend stabil bleiben. Wenn innerhalb von Sekunden eine signifikante Varianz bei identischen Abfragen angezeigt wird, wenden Sie sich an den Web IQ-Support.
Warum gibt eine Abfrage weniger Ergebnisse zurück als erwartet?
Überprüfen Sie die unverarbeitete Web IQ-Antwort, bevor Sie Ergebnisse zählen. Die häufigste Ursache ist eine clientseitige Einstellung oder ein nachgeschalteter Pipelineschritt, der gültige Ergebnisse herausfiltert, bevor sie gemessen werden. Überprüfen Sie außerdem maxResults, die Eignung von Inhalten, das SafeSearch-Verhalten und alle site:- oder -site:-Operatoren in der Abfrage.
Wie wirken sich Sprache, Region und Standort auf die Ergebnisse aus?
Die Sprache der Abfrage selbst ist am wichtigsten; die language- und region-Parameter spielen eine sekundäre Rolle, und ihre Wirkung kann je nach API variieren. Jede unterstützte Sprache funktioniert mit jeder unterstützten Region, zum Beispiel en mit IN, AU oder NZ. Region wirkt sich auf die Rangfolge, die Mischung aus Quellen und Einheiten (z. B. °C oder °F) aus, jedoch nicht auf das Datumsformat. Eine Abfrage zu einem globalen Thema gibt weiterhin globale Ergebnisse zurück. Bei lokalen Abfragen wie "Wetter bei mir" ist der Standort wichtiger als die Region.
Beide Parameter verwenden Zwei-Buchstaben-Codes; ein anderer Wert gibt HTTP 400 zurück. Wenn eine Zwei-Buchstaben-Region nicht unterstützt wird, verwendet Web IQ US. Wenn eine Sprache mit zwei Buchstaben nicht unterstützt wird, wird die Standardsprache für diese Region verwendet. Keiner der beiden Fälle liefert keinen Fehler zurück. Dies funktioniert in der Websuche, der Nachrichtensuche und in Auto. Siehe unterstützte Sprachen und Regionen.
Was ist der Unterschied zwischen Auto und Auto Advanced?
Sie sind zwei Modi derselben API. Auto, der Standardwert, wählt die Quellen für eine Frage und gibt zitierte Nachweise in einem Aufruf zurück. Auto Advanced führt zusätzliche Abrufdurchläufe für komplexe Fragen aus; um es zu verwenden, legen Sie "mode": "advanced" fest. Der Preis wird separat berechnet; siehe Preise.
Benötige ich responseFilter mit Auto?
Nein Auto entscheidet, welche Informationen eine Anfrage benötigt (Web, Nachrichten, Wetter und mehr) und gibt sie in einem Aufruf zurück, sodass Sie nicht jede API separat aufrufen müssen.
responseFilter listet die Evidenztypen auf, die Auto einschließen kann; wenn Sie es weglassen, sind alle Typen zulässig. Um Typen auszulassen, die Sie niemals möchten, z. B. Bilder oder Videos, listen Sie nur die gewünschten Typen auf (z. B. ["web", "news"]). Legen Sie sie einmal für Ihre Anwendung statt pro Abfrage fest. Auto unterstützt dieselben Sprachen und Regionen wie die Websuche und responseFilter funktioniert in jeder Region gleich. Weitere Informationen finden Sie in der Auto-API-Referenz.
Inhaltsformate
Was gibt jedes Ergebnis zurück: Passagen oder das vollständige Dokument?
Die Websuche und die Nachrichtensuche geben den Inhalt jedes Ergebnisses im content Feld zurück. Wenn contentFormat auf passage gesetzt ist, erhalten Sie die Teile des Dokuments, die für Ihre Abfrage am relevantesten sind. Mit text, htmloder markdown, erhalten Sie das vollständige Dokument: die strukturierte Version der Seite, die Web IQ während der Indizierung erstellt. Passagen funktionieren für jede Anwendung; die vollständigen Dokumentformate benötigen vollständigen Dokumentzugriff. Bilder und Videos geben Ergebnisdetails wie Titel, URLs und Miniaturansichten zurück, nicht Seiteninhalte. Orte geben strukturierte Ortsdetails wie Adressen, Öffnungszeiten, Rezensionen und Fotos sowie Passagen im Zusammenhang mit der Abfrage zurück. Siehe Passagen und Inhaltsformate.
Was ist passage, und warum verwenden Sie es?
Legen Sie contentFormat=passage fest, und die API gibt für jedes Ergebnis nur die Segmente des Dokuments zurück, die für die Abfrage am relevantesten sind, nicht das vollständige Dokument. Das vollständige Dokument wird auf der Web IQ-Seite verarbeitet, und was zurückkommt, ist ein abfrageorientierter Extrakt, sodass Ihr LLM nicht über irrelevante Absätze hinausgeht, um den relevanten Satz zu finden.
- Tokeneinsparungen: Das LLM erhält statt des gesamten Dokuments einen Bruchteil des Dokuments.
- Bessere Faktentreue: Mit weniger themenfremden Inhalten im Kontext neigt das Modell weniger dazu, sich an einem randständigen Absatz zu orientieren.
Legen Sie contentFormat=passage für jede Websuche und jede Nachrichtenanfrage fest. Browse unterstützt auch passage: Senden Sie eine query und Browse gibt die Teile der Seite zurück, die für Ihre Abfrage am relevantesten sind.
Welches Format sollte ich verwenden?
Verwenden Sie passage für die Erdung. Es ist das empfohlene Format und funktioniert für jede Anwendung. Verwenden Sie text, html oder markdown, wenn Sie das gesamte Dokument benötigen, um z. B. eine vollständige Seite zusammenzufassen oder Inhalte aus einer vollständigen Seite zu extrahieren. Diese Formate benötigen vollständigen Dokumentzugriff.
Sollte ich bei jeder Anfrage contentFormat und maxLength festlegen?
Yes. Legen Sie beide sowohl in jeder Websuche als auch in jeder Nachrichtenanforderung fest, sodass Sie immer das gewünschte Format und die gewünschte Länge erhalten.
Wie lange kann das content Feld sein?
Bis zu maxLength Zeichen. Ohne vollständigen Dokumentzugriff sind Passagen höchstens 3.000 Zeichen pro Ergebnis, auch wenn maxLength höher ist. Mit vollständigem Dokumentzugriff kann content bis zu maxLength, bis zu 500.000 Zeichen. Vollständige Dokumente, die länger als maxLength sind, werden abgeschnitten.
Warum erhalte ich HTTP 403 (AuthContentFormatForbidden), wenn ich contentFormat auf text, html oder markdown setze?
In der Websuche und der Nachrichtensuche geben text, html und markdown das vollständige Dokument zurück und benötigen vollständigen Dokumentzugriff. Ohne dieses geben diese Formate HTTP 403 mit dem Fehlercode AuthContentFormatForbidden zurück.
passage funktioniert für jede Anwendung.
Wie erhalte ich das vollständige Dokument als text, html, oder markdown?
Öffnen Sie eine Web IQ Supportanfrage. Anwendungen, die bereits html oder text verwenden, funktionieren weiterhin wie heute.
Was gibt Browse zurück?
Der Browse-Vorgang liefert Inhalte für eine von Ihnen ausgewählte URL bis zu maxLength Zeichen. Wenn contentFormat auf passage festgelegt ist und einem query, gibt sie die Teile der Seite zurück, die für die Abfrage am relevantesten sind. Dies ist das Standardformat, es sei denn, Ihre Anwendung hat vollen Dokumentzugriff. Mit vollständigem Dokumentzugriff kann es auch das gesamte Dokument als text, html, oder markdown. Weitere Informationen finden Sie in der Browse-API-Referenz.
Warum erhalte ich HTTP 400 von „Durchsuchen“, wenn ich kein query sende?
Für eine Passagenanforderung ist ein query erforderlich, das nicht leer ist.
passage ist das Standardformat, es sei denn, Ihre Anwendung verfügt über vollständigen Dokumentzugriff. Schließen Sie also query mit bis zu 1000 Zeichen in jede Browse-Anforderung ein. Siehe Passagen und Inhaltsformate.
Wie sollte ich maxResults und maxLength abstimmen, um Kontextfenster und Token-Kosten zu verwalten?
Web IQ kann Passagen priorisieren, die für eine Abfrage relevant sind, anstatt unnötigen Seitenkontext zu liefern. Dadurch kann die Textmenge reduziert werden, die an Ihr Modell übergeben wird, und die Kosten für Eingabe-Token gesenkt werden. Die Vorteile hängen von Ihrem Modell, Ihren Eingabeaufforderungen, Abfragemix und Abrufeinstellungen ab.
Für die meisten Grounding-Szenarien liefern mehr Ergebnisse mit kürzeren Passagen bessere Ergebnisse als weniger Ergebnisse mit längeren Passagen bei ungefähr dem gleichen gesamten Token-Budget. Ein guter Ausgangspunkt ist maxResults=10 mit maxLength etwa 3.000 Zeichen im passage Format. Benchmark mit Ihren eigenen Abfragen und Ihrem Modell.
Warum geben Websuche und Nachrichtensuche kein snippet Feld zurück?
Dies ist beabsichtigt. Beide geben passage als abfrageabhängigen Extrakt (snippet) anstelle eines separaten, abfrageunabhängigen contentExtrakts zurück.
Antwortinhalt
Was ist der Maximalwert maxResults für die Websuche?
Die Websuche unterstützt bis zu 50 Ergebnisse pro Anforderung.
Welche Anforderungsparameter kann ich konfigurieren?
Die Websuche stellt maxResults, language und contentFormat, passage (region, text, html oder markdown), maxLength und safeSearch bereit. Die vollständige Parameterliste finden Sie in der API-Referenz .
Was ist der Unterschied zwischen lastUpdatedAt und crawledAt?
lastUpdatedAt ist das datum für die Aktualisierung von Inhalten des Herausgebers, das von der Websuche, Nachrichten, Videos, Bildern, Durchsuchen und Auto zurückgegeben wird, wenn verfügbar.
crawledAt ist die Zeit, zu der Web IQ die Seite zuletzt abgerufen hat, die von Websuche, Durchsuchen, Nachrichten und Auto zurückgegeben wird. Dies ist nicht der Zeitpunkt Ihrer Anfrage. Die Abdeckung beider Felder variiert je nach Ergebnis, und nicht jedes Ergebnis umfasst sie.
Was ist Browse Live Crawl und wann sollte ich es verwenden?
"Durchsuchen" gibt Inhalte aus dem Bing-Webindex zurück, der kontinuierlich aktualisiert wird, wenn unsere Crawler Änderungen im Web beobachten. Dies ist die Funktionsweise der Websuche im Allgemeinen: Suchergebnisse werden aus einem Index bereitgestellt, anstatt jede URL bei jeder Anforderung live abzurufen, und das ist es, was Browse seine Geschwindigkeit und Konsistenz verleiht.
Browse unterstützt Live Crawl für URLs, die im Index nicht verfügbar sind. Setzen Sie liveCrawl: "fallback" in der Anfrage, um einen Live-Abruf auszulösen, wenn die indizierte Kopie fehlt. Live-Crawling unterliegt Einschränkungen zur Schonung der Publisher sowie der Verfügbarkeit; fallback garantiert kein tatsächliches Crawling. Wenn indizierte Inhalte verfügbar sind, gibt Browse sie zurück. Wenn Sie den Parameter weglassen (oder ihn auf liveCrawl: "none" setzen), werden nur indizierte Inhalte ohne Live-Durchforstung zurückgegeben. Vollständige Parameterdetails finden Sie in der Browse-API-Referenz .
Live Crawl ist standardmäßig im Web IQ Browse verfügbar und wird mit einer begrenzten Kapazitätsobergrenze pro Sekunde bereitgestellt, separat von Ihrem gesamten Browse-QPS. Diese Obergrenze gilt gemeinsam für alle API-Schlüssel unter der AppID. Die meisten Browse-Workloads benötigen keinen Live Crawl und werden am besten über den standardmäßigen indizierten Pfad bedient; verwenden Sie Live Crawl, wenn eine URL im Index nicht verfügbar ist.
Kann Browse JavaScript-gerenderte Seiten abrufen?
Yes. Verwenden Sie renderDynamicPages: true zusammen mit liveCrawl: "fallback". Weitere Informationen finden Sie in der Browse-API-Referenz für den vollständigen Parametersatz und die Antwortdetails. Testen Sie repräsentative URLs, bevor Sie von diesem Verhalten in der Produktion abhängen.
Kann Browse Online-PDF-Dateien extrahieren?
PDF-Dateien, die online gehostet werden, sind heute kein dokumentiertes Browsen-Szenario. Wenn Sie über einen bestimmten PDF-Anwendungsfall verfügen, wenden Sie sich an den Web IQ-Support mit einer repräsentativen URL und dem erwarteten Verhalten, und Sie erhalten eine endgültige Antwort.
Abrechnung und Rechtliches
Was kostet Web IQ?
Web IQ verwendet verbrauchsbasierte Abrechnung pro Aufruf. Die Preisgestaltung hängt von den für Ihr Konto aktivierten APIs, Ihrer Nutzung und Ihren kommerziellen Bedingungen ab. Aktuelle Preise finden Sie unter Preisgestaltung. Web IQ wird über Azure in Rechnung gestellt, sodass Ihre Nutzung auf Ihre Microsoft Azure Verbrauchsverpflichtung (MACC) angerechnet wird und Ihre Azure Verbrauchsrabatte (ACD) und andere ausgehandelte Azure Rabatte für diese Tarife gelten. Commerce in der privaten Vorschau wird ebenfalls pro Aufruf abgerechnet: Suche, Angebote und Produktdetails teilen sich einen Abrechnungszähler und denselben Tarif.
Wie wird die Abrechnung in Azure angezeigt?
Die Web IQ-Nutzung wird über Ihre Web IQ-Ressource nutzungsbasiert erfasst und Ihrem Azure-Abonnement in Rechnung gestellt. Der Dienst selbst wird von Microsoft gehostet und nicht in Ihrem Mandanten bereitgestellt.
Um Ihre Web IQ-Kosten anzuzeigen, öffnen Sie die Kostenanalyse für Ihr Abonnement im Azure-Portal, verwenden Sie die Kosten nach Ressourcenansicht und filtern Sie nach dem Ressourcentypmicrosoft.webiq/accounts. Jede API, die Sie aufrufen (z. B. Websuche, Bilder oder Nachrichten), wird als eigener Zähler angezeigt. Auto hat zwei Meter, eine für /auto und eine für /auto mit mode: advanced. Die Commerce-APIs teilen sich einen Zähler.
Umfasst Web IQ eine SLA-, RTO- oder RPO-Zusicherung?
Nein Microsoft Web IQ enthält keine Vereinbarung zum Servicelevel. Die Web IQ-Nutzungsbedingungen sehen keine Zusagen zu Verfügbarkeit, Latenz, Recovery Time Objective (RTO) oder Recovery Point Objective (RPO) vor, und SLA-Bedingungen werden nicht für einzelne Kunden hinzugefügt.
Muss ich Zitate anzeigen?
Yes. Anlage A, Abschnitt 1 (LLM-Verwendung) der Web IQ Nutzungsbedingungen erfordert Quellzuordnung und einen Link zurück zu jeder Quelle, die für den angezeigten LLM-Inhalt verwendet wird, in der Nähe dieses Inhalts.
- Zitieren Sie nur die Quellen, die tatsächlich zum Generieren der Antwort verwendet wurden. Wenn Web IQ 10 Ergebnisse zurückgegeben hat und Ihr Modell 3 verwendet hat, zeigen Sie diese 3 an.
- Zitate müssen mit der Antwort sichtbar bleiben und mit einer einzigen Aktion erreichbar sein. Zeigen Sie sie nicht nur kurz an, verbergen Sie sie hinter mehreren Ebenen oder fordern Sie, dass Benutzer separat nach Quellen fragen.
- Verwenden Sie für eingeschränkte Schnittstellen wie Autos, Wearables, sprachgesteuerte Geräte oder Kioske einen persistenten QR-Code, der auf eine Seite verweist, die jedes Zitat auflistet, das für die aktuelle Antwort verwendet wird, eine Begleit-App, die die Antwort mit klickbaren Zitaten anzeigt, oder eine Bildschirmliste, die der Benutzer direkt öffnen kann.
Sie können die mit einer LLM-Zusammenfassung angezeigten Quelllinks zusammen mit ihr, im Chatverlauf eines Endbenutzers oder als Teil Ihres internen Arbeitsprodukts speichern. Siehe die Zwischenspeicherungsfrage unten.
Wie viel Quellinhalt kann mein KI-Agent oder meine Anwendung anzeigen?
Anlage A der Web IQ-Nutzungsbedingungen begrenzt die angezeigten Grounding-Inhalte aus einer beliebigen Quelle auf den kleineren Wert von 200 Zeichen oder das vom Websitebesitzer oder Webmaster angegebene Maximum. Wenden Sie für Sprach- oder Audiofunktionen den gleichen Grenzwert auf die gesprochene Ausgabe an. Zusätzliche Einschränkungen gelten für Zusammenfassungen und die Anzeige. Überprüfen Sie die Nutzungsbedingungen vor dem Entwerfen von Auszügen; diese Begrenzung ist keine Erlaubnis, ganze Quellseiten zu reproduzieren.
Können Bild- und Videoergebnisse verwendet werden, um ein LLM zu erden?
Bild- und Videometadaten und Alternativtext sind in der Definition von Grounding Content enthalten. Die Web IQ-Nutzungsbedingungen verbieten jedoch die Verwendung tatsächlicher Bilder oder Videos aus Ergebnissen für Grounding, einschließlich ihrer Einbindung in die LLM-Ausgabe oder der Erstellung abgeleiteter Bilder oder Videos daraus. Überprüfen Sie die Bestimmungen für Ihre geplante Implementierung.
Kann ich Web IQ-Inhalte zwischenspeichern oder speichern?
In der Regel nein. Die Web IQ-Nutzungsbedingungen verbieten das Kopieren, Speichern, Zwischenspeichern, Archivieren oder Erstellen einer Datenbank von Inhalten, außer soweit die Bedingungen dies erlauben (Abschnitt 3.2.15 und Anlage A, Abschnitt 4):
- Endbenutzer-Chatverlauf: Sie können LLM-Zusammenfassungen (die Zusammenfassungen, die Ihre Anwendung aus dem Grounding Content für Endbenutzer, Abschnitt 2.5) erstellt, auf einer nicht aggregierten, pro Endbenutzerbasis für den Chatverlauf jedes Endbenutzers speichern, solange anwendbares Recht dies zulässt.
- Internes Arbeitsprodukt: Sie können LLM-Zusammenfassungen und die Quelllinks speichern, die als integrierter Bestandteil Ihres internen Arbeitsprodukts angezeigt werden, z. B. Memos, Berichte, Präsentationen oder Sicherheits- und Überwachungsprotokolle, soweit es durch das Urheberrecht erlaubt ist. Sie können nicht als Ersatz für die Dienste oder Inhalte verwendet werden, z. B. um eine Datenbank mit Inhalten zu erstellen, Links zu indizieren, zu crawlen oder zu scrapen oder eine separate Suche anzubieten.
- Vorübergehende Verarbeitung von Atomaktionen: Inhalt kann nur so lange in einem vorübergehenden Verarbeitungszustand gehalten werden, wie es unbedingt erforderlich ist, um eine einzelne logische Anforderung oder einen Workflow auszuführen, der von einer LLM (eine "Atomaktion" initiiert wird, die mehrere interne Schritte oder agentische Interaktionen umfassen kann). Inhalte müssen umgehend gelöscht werden, wenn die Atomic Action abgeschlossen ist.
Außerhalb dieser Ausnahmen speichern Sie die Suchergebnisse selbst nicht: Die Nutzungsbedingungen erlauben keine abgeleiteten Datenbanken, permanente Zwischenspeicherung oder langfristige Archivierung von Inhalten.
Wo kann ich die Web IQ Nutzungsbedingungen lesen?
Die aktuellen Nutzungsbedingungen sind unter Microsoft Web IQ Nutzungsbedingungen veröffentlicht. Sie gelten zusammen mit Ihrem vorhandenen Microsoft-Kundenvereinbarung.