Microsoft Web IQ 常见问题

有关使用 Microsoft Web IQ 的常见问题的解答。 有关 API 详细信息和请求示例,请参阅 API 参考。

服务和部署

什么是 Microsoft Web IQ?

Microsoft Web IQ 是一套 AI 原生 Web 搜索和 grounding API,使 LLM、AI 代理和应用程序能够访问当前相关的 Web 信息。 这可以提供更准确、最新的 AI 答案,并附带用户可验证的来源。 Web IQ 为领先的前沿 AI 助手提供支持,包括Microsoft Copilot和 ChatGPT。

Web IQ 可通过 REST 在 https://api.microsoft.ai/v3 访问,也可通过 MCP 在 https://api.microsoft.ai/v3/mcp 访问。 每个 Web IQ AppID 都可以调用 Web 搜索、新闻、图像、视频、Browse、Places和 Auto。

什么是 Web grounding,AI 代理何时需要它?

Web grounding 使 AI 能够访问最新的 Web 信息,以便它可以基于训练数据之外的最新事实作答,并附带用户可核查的引用来源。 它最有助于经常变化的信息,如市场开发、竞争对手活动、新闻和监管更新。

Web IQ 是 LLM 吗? 它是否生成最终答案?

No. Web IQ 不是 AI 模型或 LLM。 它是一套 AI 原生 Web 搜索和 grounding API,可让 LLM、AI 代理和应用程序访问当前相关的 Web 信息。

Web IQ 不生成最终的 AI 答案。 它会从 Web 检索相关信息,所选的 LLM、AI 代理或应用程序逻辑使用该证据生成响应。

Web IQ 与其他 Web 搜索 API 和 grounding 服务有何不同?

大多数 Web 搜索 API 迫使用户在快速与准确、经济高效与完整之间做权衡。 在 Microsoft 发布的基准测试中,Web IQ 的 P95 延迟比所测试的次快服务快约 2 倍;Auto 和 Web Search 以低于对比服务的令牌数达到了更高的依据性满意度,其中 Auto 总体最高;并且 Auto 在 FreshSearch 新鲜度基准测试中得分最高。 这正是 Copilot 和 ChatGPT 等 AI 助手每天依赖的同一平台,已在全球规模验证,可作为任何 AI 代理或应用的构建基础。

Web IQ 的不同之处还在于其访问内容的方式。 它采用负责任的 Web 访问方法,将开放 Web 和结构化数据与内置的企业级安全性和保护相结合。

Web IQ 可与您已在使用的 AI 堆栈配合使用。 可以使用首选的 AI 模型并通过 REST API 或模型上下文协议(MCP)进行连接,而无需绑定到单个模型或平台。

来源:Web IQ 基准结果(P95 延迟、质量和令牌效率以及依据新鲜度部分)。

可以使用 Web IQ 构建哪些内容?

Web IQ 为 AI 代理和应用程序提供支持,这些代理和应用程序需要来自公共 Web 的全新外部信息。 内部团队可以使用它进行竞争情报、监测、法规研究、销售情报和内容优化。 面向客户的体验可用于研究、发现、推荐和专用代理。

它最适用于信息频繁更改、跨越许多外部源且需要以当前可归因 Web 内容为基础的方案。

哪种 Web IQ API 适合我的用例?

使用 Web 搜索 API 查找适用于您的模型的相关公共页面和段落,使用 新闻 API 获取当前事件信息,使用 图片 和 视频 API 获取视觉和视频结果,使用 地点 API 获取结构化地点信息,以及在您已经知道 URL 时使用 浏览 API。 检查 API 参考,了解帐户可用的功能和限制。

是否可以将 Web IQ 与现有的 AI 模型和代理框架配合使用?

Yes. Web IQ 允许将 Web 信息添加到所选的 AI 模型和代理工作流。 REST API 和 MCP 提供了如何连接它的灵活性。 请查看 SDK 和 MCP 集成文档 ,了解受支持的配置。

集成是什么样的?

AI 代理或应用程序调用 Web IQ 以获取 Web 证据,然后将所选结果传递给其模型以生成响应。 你可以控制信息的选择、使用和引用方式。 按照 快速入门 操作,连接第一个工作流,或 开始使用 Playground。

Web IQ 是否可以检索非上市公司信息?

No. Web IQ 检索公共 Web 信息。 对于企业环境,Microsoft 提供工作 IQ、Fabric IQ 和 Foundry IQ,各自承担不同的角色,从组织环境到业务数据和企业知识。

Web IQ 与 Foundry IQ、Work IQ 和 Fabric IQ 有何关联?

Microsoft IQ 汇集了四个集成层,为贯穿整个 Microsoft 的企业智能提供支持。 Web IQ 提供来自公共 Web 的信息。 工作 IQ 侧重于工作信号,Fabric IQ 侧重于业务数据,Foundry IQ 侧重于组织知识。 这些产品满足 AI 代理和应用程序的不同信息需求,在一起使用时功能最强大。

Web IQ 是否为 Azure 资源?

你在 Azure 订阅中部署 Web IQ 资源。 资源处理计量和计费。 在 Web IQ 中,应用程序的标识是它在 Web IQ 开发人员门户中连接资源时创建的 Web IQ AppID。

服务本身由 Microsoft 托管,并且是多租户的。 Web 检索和排名在 Microsoft 基础结构中运行,并且你的应用程序通过 HTTPS 调用 api.microsoft.ai。 Azure资源不托管 Web IQ,并且不在请求路径中。

Web IQ 资源与 Web IQ AppID 之间的区别是什么?

Web IQ 资源是你在 Azure 订阅中通过 Azure 门户或使用 Azure CLI 创建的 Azure 资源。 Web IQ 使用情况按流量计费,费用计入您的订阅。 资源不在请求路径中:你的应用程序直接调用 api.microsoft.ai 。

Web IQ AppID 是应用程序在 Web IQ 中的标识。 在 Web IQ 开发人员门户中连接 Web IQ 资源时会创建它。 有关应用程序如何使用 Web IQ 的所有设置都在 AppID 上进行:它可以调用的 API、其速率限制(默认为 15 QPS)、其 API 密钥,以及绑定到它的 Entra 应用程序(客户端)ID。 不要将其与应用注册的 Entra 应用程序(客户端)ID 混淆:该 ID 用于在应用程序获取令牌时向 Microsoft Entra ID 标识你的应用程序,并将其绑定到 Web IQ AppID。

连接资源会创建 AppID,因此大多数客户一开始都会各使用一个资源和一个 AppID。 如果需要多个 AppID(例如每个环境或工作负荷一个),Microsoft联系人可以告诉你这些选项。

Web IQ 部署在何处?

Web IQ 由 Microsoft 托管,并通过公共 https://api.microsoft.ai/v3 终结点提供。 应用程序调用 API,Web IQ 在服务器端执行 Web 检索。

是否有用于金融、体育或天气的专用 API?

没有专门的财务、体育或天气 API。 对于天气,当查询与天气有关时,Auto 会返回结构化天气结果(当前状况、每日预报和有效天气警报,并附有指向发布机构的链接)。 对于财务、体育和其他主题,请使用 Web 搜索,它将相关爬网内容作为非结构化页面文本而不是结构化源返回。

访问和引导

如何从评估迁移到生产?

  1. 完成评估并确认服务满足你的要求。
  2. 在付费Azure订阅中创建 Web IQ 资源,然后登录到 Web IQ 开发人员门户并连接资源。 这会创建你的生产 AppID,可以从个人资料管理中复制它。 它从每秒 15 个查询的默认限制(QPS)开始。
  3. 若要使用 Microsoft Entra ID 进行身份验证,请在开发人员门户中将应用注册的 Entra 应用程序(客户端)ID 绑定到该 AppID。

在现有 Microsoft 客户协议的背景下,Web IQ 的使用受 Web IQ 使用条款 约束。

可以使用哪些Azure订阅?

Web IQ 需要付费Azure订阅,包括通过 云解决方案提供商 (CSP) 合作伙伴购买的订阅。 Visual Studio、免费试用版和学生订阅以及Azure信用额度不适用于 Web IQ。 如果由于Azure帐户的状态而阻止了创建 Web IQ 资源,错误消息会要求你与Microsoft 帐户团队联系,他们可以请求评审。

应用程序可以调用哪些 API?

每个 Web IQ AppID 都可以调用 Web 搜索、新闻、图像、视频、浏览、位置和 Auto。如果在 允许的服务 下未列出 Auto,请使用您的 AppID 提交 Web IQ 支持请求。 若要查看 AppID 可以调用的 API,请登录到 Web IQ 开发人员门户,转到 配置文件管理,在左上角的下拉列表中选择 AppID(按名称),并选中 “允许的服务”。

如何获取对 Commerce API 的访问权限?

Commerce API(搜索、Offers 和产品详细信息)处于私有预览阶段,并且包含在具有完全文档访问权限的 AppID 中。 如果 AppID 没有应用 ID,请打开 Web IQ 支持请求,选择 身份验证和访问 作为问题类型,并包括 AppID 或公司名称和 Web IQ 资源的名称(如果还没有)。 Commerce 使用情况按次调用计费,请参阅 定价。 有关 API 参考,请参阅 Commerce。

商务 API 可以做什么? 它们是否支持结账?

有三个 Commerce API。 搜索会将产品查询转换为按相关性排序的产品,每个产品都包含卖家报价(价格、卖家、报价链接、图像、发货信息和状况)。 Offers 返回搜索结果中某个产品的符合条件的卖家报价。 产品详细信息返回产品的标题、说明和平均评分。 商务 API 不支持结帐、付款或其他交易:它们返回产品和优惠信息,其中包含指向商家处每个优惠的链接。

对于每个指向优惠的链接或导航,无论是由用户执行,还是由代表用户行事的代理执行,都要使用该响应中返回的每个优惠的 clickUrl 原样值。 不要去除、重写、缩短或重复使用它,也不要链接到 displayUrl,它仅标识商家或卖家。 只有在你自己的跟踪链接可原样传递原始链接时,才可以用其包装 clickUrl。 在应用程序代码中根据响应构建每个链接,而不是让模型重现它。 有关详细信息,请参阅 优惠链接和归属 以及 Web IQ 使用条款的附件B。

我应该使用哪个邮箱地址登录?

使用有权访问 Web IQ 的 Microsoft 登录地址:Microsoft 为你启用的地址,或者你在 Web IQ 开发人员门户中用于连接 Web IQ 资源的帐户。 这通常是用于Azure、Teams 或 Office 的地址,可能与邮箱地址不同。

若要确认,请登录到Azure门户并检查右上角的地址。

为什么登录时说我没有访问权限?

首先,确认Azure门户右上角显示的地址与有权访问 Web IQ 的地址完全匹配。 组织通常使用一个地址进行Microsoft登录,另一个地址用于电子邮件。

如果帐户标识符匹配,你的组织可能会阻止跨租户来宾访问 Microsoft Corporation 租户。 请让您的 IT 管理员允许该访问权限。

在哪里可以获得帮助?

请访问 Microsoft Web IQ 支持网站以获取产品帮助。 有关允许使用、隐私、存储或显示的问题,请参阅当前的 Web IQ 使用条款 和适用的客户协议。

API 身份验证

支持哪些身份验证方法?

Web IQ 支持:

  • 通过 OAuth 2.0 客户端凭据流获取 Microsoft Entra ID 持有者令牌。 建议对于生产工作负荷使用该存储类。
  • API 密钥在 x-apikey 请求标头中发送。

所有 API 流量都使用 HTTPS。

如何配置服务器到服务器身份验证?

在 Microsoft Entra ID 中注册应用程序并使用 OAuth 2.0 客户端凭据流。 在 Web IQ 开发人员门户中将应用注册的 Entra 应用程序(客户端)ID 绑定到 Web IQ AppID,获取访问令牌,并将其作为发送方式 Authorization: Bearer <access_token>发送。

有关完整的设置步骤,请参阅 身份验证。

是否可以管理自己的 API 密钥?

Yes. 可以从 Web IQ 开发人员门户根据需要创建任意数量的 API 密钥。 创建密钥不收取任何费用。

Web IQ 是否使用 Azure RBAC 进行 API 授权?

No. Web IQ 是一种通过 Internet 调用的Microsoft托管服务。 在 Azure 订阅中部署的 Web IQ 资源负责处理计量和计费,但它不在请求路径中,因此没有供 Azure RBAC 角色附加的服务资源。

Web IQ 授权每个 AppID 的请求。 每个 AppID 都有自己的内容资格配置文件和配额,未经授权的调用将返回 HTTP 403。 若要分隔团队或工作负荷(例如使用不同的访问策略或配额),请使用多个 AppID。

一个 Entra 应用程序(客户端)ID 是否可以调用多个 Web IQ AppID?

Yes. 可以授权单个 Entra 应用程序(客户端)ID 来调用一个或多个 AppID。 若要选择 AppID,请将其作为查询参数传递,例如 https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>。 API 解析 AppID,如下所示:

  • Entra 应用程序(客户端)ID 绑定到一个 AppID:如果未指定 AppID,或者指定 AppID,请求会成功(HTTP 200)。 如果指定了不同的 AppID,请求将返回 HTTP 403。
  • Entra 应用程序(客户端)ID 绑定到多个 AppID:必须指定一个。 缺少或空白的 AppID 返回 HTTP 400;绑定的 AppID 之一成功(HTTP 200):任何其他 AppID 返回 HTTP 403。
  • Entra 应用程序(客户端)ID 未绑定到任何 AppID:请求返回 HTTP 401。

API 密钥身份验证 (x-apikey) 不受影响。 每个 API 密钥都绑定到单个 AppID,因此对于使用密钥认证的调用,APPID 既不需要,也不被接受。

托管代理应使用什么身份验证:托管标识或 AgentID?

任意一种都可以。 托管标识和 AgentID 都是 Entra ID 标识,Web IQ 接受任何 Entra 标识,只要其 Entra 应用程序(客户端)ID 已从 Web IQ 开发人员门户的配置文件管理页面绑定到您的 Web IQ AppID。

使用哪一个取决于代理的托管位置:

  • 托管标识适合在 Azure 基础结构上运行的代理,例如 Foundry、应用服务、容器应用、AKS、Functions 或 VM。 系统分配的身份和用户分配的身份都起作用。
  • AgentID 适用于 Foundry 或 Copilot Studio 托管的、提供代理标识的代理。
  • 托管在Azure外部的代理(例如,在自己的 Kubernetes 群集或其他云上)可以使用标准 Entra 应用程序注册和客户端机密或联合凭据。

在每种情况下,调用都使用 OAuth 2.0 客户端凭据流并将令牌作为 Authorization: Bearer <access_token> 发送。 有关设置步骤,请参阅身份验证。 标头中的 x-apikey API 密钥仍然是原型的更简单选项。

网络和安全性

No. 今天不支持其中任何一项。 Web IQ 通过单个公共终结点 https://api.microsoft.ai/v3 使用 HTTPS,并通过 Entra ID 或 API 密钥进行身份验证访问。 API 终结点上没有基于 IP 的访问控制。

Azure订阅中的 Web IQ 资源处理计量和计费,但不在请求路径中,因此Azure网络控制(如 专用链接、VNet 集成、Azure 防火墙、NSG 和中心辐射型拓扑)在 Web IQ 端没有可附加的对象。 标识(Entra ID)集成与 Azure 保持一致;而网络层则不一致。

在您这边,请在出站控制中允许 api.microsoft.ai 主机名。

从 Azure 到 Web IQ 的流量是否经由 Microsoft 网络或 Azure 主干网络传输?

这并不保证。 客户端连接到公共 https://api.microsoft.ai 终结点,流量通过 HTTPS 在传输中受到保护。

Web IQ API 流量在Azure Front Door终止,它支持 TLS 1.2 和 TLS 1.3,这些密码套件:

  • 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 或其他出口检查工具是否会干扰 Web IQ?

配置为允许连接到 api.microsoft.ai时,它不应干扰。 这是标准的允许列表操作,而不是广泛的绕过。 相同的方法适用于其他安全 Web 网关,例如 Netskope。

是否可以将 Web IQ 置于Azure API 管理后面?

Yes. 可以在自己的Azure订阅中将Azure API 管理或其他网关放置在 Web IQ 前面,以便进行可观测性和治理,并且没有已知的阻止限制。 API 调用使用 API 密钥或 Entra ID 令牌,通过 TLS 从调用方发送到 https://api.microsoft.ai/v3,因此,部署在该流量前面的任何基础结构都是租户中您自己的基础结构。 Microsoft不会发布这些部署的参考体系结构;云体系结构团队负责该设计。

根据 Web IQ 使用条款,无论网关如何处理,都不得缓存或存储响应内容以构建衍生数据集。 操作遥测(如状态、延迟、标头和跟踪 ID)可以保留,例如,在 Application Insights 或Log Analytics中。

有哪些安全控制措施可用?

  • 身份验证:Entra ID(OAuth 2.0 客户端凭据)或 API 密钥。
  • 授权:按 AppID 对 API 的访问权限。 未经授权的调用返回 HTTP 403。
  • 速率限制:按 AppID 配额强制实施。 超出限制的请求返回 HTTP 429。
  • 传输:仅 HTTPS。

外围的网络策略由你负责。 如果你有要评估的特定体系结构要求,请联系 Web IQ 支持部门。

速率限制和 API 密钥

是否存在速率限制?

Yes. 每个 Web IQ AppID 的默认限制为每秒 15 个查询(QPS)。 Web IQ 资源通常具有一个 AppID,其 AppID 会在你连接该资源时创建。 Web IQ 开发人员门户显示限制。

该限制在所有 API 密钥和该 AppID 的绑定 Entra 应用程序(客户端)ID 之间共享。 超出限制的请求返回 HTTP 429。

是否可以提高速率限制?

Yes. 每个 Web IQ AppID 的起始 QPS 为 15。 若要请求更高的限制,请提供预期流量和用例,并提交Web IQ 支持请求。

可以创建多少个 API 密钥?

可以根据需要创建任意数量的密钥。 密钥创建是免费的,但一个 AppID 的所有密钥共享其速率限制。

隐私和数据处理

Web IQ 会记录 API 查询吗?

Yes. 出于操作目的记录 API 请求:服务可靠性、调试和质量改进。 这是 Microsoft 服务的标准。

  • 访问权限仅限于授权Microsoft工程和运营人员,并由Microsoft的内部访问控制策略管理。 其他客户或第三方无法访问日志中的数据。
  • 日志存储在Microsoft的生产基础结构中,并受Microsoft的标准安全控制,包括基于角色的访问控制和审计跟踪。
  • 日志在传输过程中(通过 HTTPS)加密,并使用 Microsoft 的标准加密做法进行存储时加密。

Microsoft根据 Microsoft 隐私声明充当数据控制者。

查询保留多长时间?

查询遥测的保留受 Web IQ 使用条款第 4 节约束,并规定 Microsoft 的处理受 Microsoft 隐私声明约束。 除了隐私声明所描述的内容之外,没有单独的特定于 Web IQ 的保留承诺。

是否可以关闭受管制或敏感工作负荷的查询日志记录?

查询文本作为标准请求遥测的一部分捕获,其处理受 Microsoft 隐私声明和 Web IQ 使用条款第 4 节的约束。

如果你有特定的法规或合规性要求,Web IQ 提供 Zero Query Logging,不在遥测中记录查询文本。 查询仍会被发送到Microsoft以处理请求;Zero Query Logging会使查询文本不进入我们的日志。 这不是自助式服务:需由我们的产品团队为你启用,可针对你的所有应用程序或仅特定应用程序。 若要提出请求,请联系 Microsoft 帐户团队并提供以下信息:

  • 适用的法规或合规性框架(例如 GLBA、HIPAA、GDPR 或 APPI)。
  • 部署方案的简短说明。

使用零查询日志记录时,不会保留查询文本、结果标题和 URL、IP 地址和 Entra 应用程序 ID。 AppID、跟踪 ID、计时、状态和计费字段会被保留,以便我们可以运行和计费服务。 你这边无需进行任何配置。

是否可以检查是否启用了零查询日志记录?

目前无法在 Web IQ Developer Portal 或 API 中找到。 如果需要确认(例如审核),请使用 AppID 打开 Web IQ 支持请求 ,Web IQ 支持部门会以书面形式确认该设置。

是否可以通过 API、Terraform 或Azure Policy启用或强制实施零查询日志记录?

今天不行。 对于所有应用程序或特定应用程序,我们的产品团队按请求启用零查询日志记录。 对于所有应用程序,系统会自动涵盖在组织的Microsoft Entra租户下创建的新应用程序,而无需其他请求。 没有可用于启用、强制执行或审核它的 API、Terraform 设置或 Azure Policy 定义。 可以使用现有Azure权限控制谁在订阅中创建 Web IQ 资源。 若要确认用于审计的设置,请使用 AppID 提交 Web IQ 支持请求。

Web IQ 提供哪些数据驻留承诺?

今天无。 Web IQ 不会做出特定于区域的数据驻留或区域内处理承诺,并且跨区域路由到最近的可用终结点是预期行为。 隐私适用 Microsoft 隐私声明。 Microsoft不承诺可访问该数据的人员所在位置或国籍。

Azure数据保护附录或欧盟数据边界是否涵盖 Web IQ?

No. Web IQ 使用条款的第 4.1 节将该服务排除在 Microsoft 产品和服务数据保护附录之外。

而是,Microsoft 和客户均作为根据《使用条款》处理的任何个人数据的独立数据控制者(第 4.4 节)。 Microsoft的处理受Microsoft隐私声明(第 4.2 节)的约束,你负责向最终用户发出适当的通知。

对于国际传输,使用条款在需要时纳入标准合同条款(第4.6.1节)。 该传输机制依据《使用条款》(位于 Microsoft 客户协议 下)实现,而不是依据数据保护附录。

Web IQ 目前不会做出欧盟数据边界、特定于区域的数据驻留或区域内处理承诺。

是否为特定的隐私法(如日本 APPI)提供 DPA 或合规性声明?

No. Web IQ 被排除在Microsoft产品和服务数据保护附录(Web IQ 使用条款第 4.1 节)之外,我们不会针对特定隐私法发布声明。 Microsoft的书面立场是《使用条款》第 4 部分,以及第 4.2 节所述适用于 Web IQ 的 Microsoft 隐私声明。 第 4 节涵盖:

  • 与请求相关的Microsoft,包括查询、最终用户的 IP 地址、请求时间和返回的结果(第 4.2 节)。
  • Microsoft和客户作为独立数据控制者(第 4.4 节)。
  • 数据主体请求(第 4.5 节)。
  • 除分包商和第三方外,不得向第三方传输个人数据,其条款至少与使用条款(第 4.7.2 节)一样具有保护性。
  • 有关监管投诉的合作(第4.8条)。

Web IQ 不会 在查询中检测或屏蔽个人数据 ,也不会做出 数据驻留承诺。 你的法律团队最适合评估根据适用于你的法律的义务如何满足你的义务:我们很高兴回答后续问题。

Web IQ 是否在查询中检测或屏蔽个人数据?

No. Web IQ 不会在入站查询中执行服务器端检测或屏蔽个人数据。 如果工作负荷可能会发送个人或敏感数据,请在调用 Web IQ 之前对其进行脱敏处理,例如将Azure AI 语言 PII 检测作为预处理步骤。 这样一来,任何敏感内容都不会离开你的环境,并且你可以完全控制到达 API 的内容。

Web IQ 是否支持受管制行业?

Yes. Web IQ 支持一系列企业和管控用例。 如果你有专门的合规性、治理或行业要求,请联系 Web IQ 支持部门。

内容安全和覆盖范围

应用了哪些内容安全控制?

Web IQ 在爬取时进行质量和安全分类、成人内容筛选,以及针对每个客户的内容适用性规则。 默认情况下,安全搜索在服务器端 strict 强制执行。 Web 搜索结果还包括一个用于额外客户端处理的 isAdult 字段。

Web IQ 是否保护 LLM 免受检索内容中的提示注入?

Microsoft Web IQ 从 Web 检索并对内容进行排序;它不执行、解释或处理嵌入在检索内容中的指令。 Web IQ 通过必应现有的质量、可信度、垃圾邮件和恶意内容筛选来补充这种检索行为。

防止间接提示注入、越狱尝试和指令遵循攻击主要是下游模型和业务流程层的责任。 将提示和检索的内容视为不受信任的输入,并应用分层控件,如 Prompt Shields、Azure AI 内容安全、系统提示隔离、最小特权工具访问、依据验证和输出验证。 不应将 Web IQ 视为提示注入缓解的唯一执行点。

Web 内容在 Web IQ 返回之前是如何处理的? 是否对类似提示词的指令进行过滤?

Microsoft Web IQ 在检索时不直接在原始页面 HTML 上运行。 在编制索引期间,Web 内容规范化为结构化文档表示形式,旨在保留有意义的内容和文档结构。 Web IQ 返回的段落是从该表示形式中选择的,这使得能够在整个 API 范围内更一致地进行提取和检索。 必应现有的质量、安全、垃圾邮件和恶意内容筛选也作为索引管道的一部分执行。

Web IQ 无法保证返回的内容没有脚本或恶意软件,并且这种规范化不能保证识别或删除类似提示的文本。 将检索的内容视为不受信任的输入,并应用上一答案中所述的模型层和编排层保护。

Web IQ 是否返回隐藏或不面向用户的页面内容?

Microsoft Web IQ 尝试返回通过普通用户交互可见的内容,包括通过普通页面控件或客户端呈现显示的内容。 这不作保证。 页面结构和实现各不相同,因此应用程序不应假定每个返回的内容片段在页面的初始状态中可见,或者每个隐藏元素将始终被排除。

Microsoft如何保持索引质量?

页面根据质量、权威和可信度进行评估。 检测到并排除恶意、垃圾邮件和网络钓鱼内容,并不断刷新索引。 它与Microsoft自己的 AI 产品依赖的索引相同。

Web IQ 如何尊重发布者内容首选项?

Web IQ 旨在遵循受支持的发布者控件,包括适用的 robots.txt 指令和其他Microsoft识别的发布者信号。

是否有已排除网站或被阻止类别的已发布列表?

No. 排除控制包括 robots.txt 合规性、法律和合规性删除(例如 DMCA 通知和法院命令)、垃圾邮件、恶意软件和钓鱼筛选以及成人内容筛选。 这些列表本身属于专有内容,并且会持续更新。 如果您担心结果中特定类别的内容出现或未显示,请联系 Web IQ 支持 部门,讨论 Web IQ AppID 的配置是否满足这些要求。

Web IQ 涵盖哪些内容,以及内容有多及时?

Web IQ 不断检索网页、新闻、图像和视频结果中的新鲜信息,以帮助 AI 代理或应用程序回答其模型训练数据之外的问题。

可用性和新鲜度因 API、源类型和用例而异;并非所有内容都有统一的新鲜度保证。 选择源和检索设置时,请考虑工作负荷的时效性要求。

Web IQ 支持哪些语言和市场?

Web IQ 来自全球 Web,但覆盖范围因语言、市场、主题和源类型而异。 查看支持的语言和区域页,了解每个 API 接受的代码,并评估其覆盖范围是否符合预期用户所需的信息。

中国客户应致电 https://api.microsoftol.com/v3;新闻搜索在中国不可用(基本 URL)。

是否可以配置域允许或拒绝列表?

对于单个域或小型列表,请使用标准查询运算符,例如,使用 site:example.com 包含某个域,使用 -site:example.com 排除某个域。 若要在 Web 搜索或新闻搜索中重复使用一组命名的包含和排除规则,请为具有可用范围管理的计费帐户 创建 Web IQ 范围 。 命名范围支持每个列表最多 10,000 个规范化的唯一选择器,但受 组合的定义大小限制的约束。

为什么看不到领英结果?

领英结果当前被排除。

为排除的 URL 调用 Browse 时会发生什么情况?

Browse 返回 HTTP 403。 底层排除列表未公开。

如何让 Web IQ 发现我的网站?

Web IQ 基于与 Microsoft 自家 AI 产品使用的相同 Web 索引构建。 使用标准 Web 发现做法,例如站点地图、IndexNow、Bing 网站管理员工具和适当的 robots.txt 策略。 没有单独的 Web IQ 提交路径。

命名搜索范围

如何控制和筛选 Web IQ 的结果?

使用 范围 筛选 Web 搜索和新闻搜索结果,其中包含要包括或排除的可重用 URL、网站、域或路径列表。 创建命名作用域,然后使用 scopeName 请求参数将其选中。 排除项优先于包含项。 请参阅“使用范围筛选结果”。

Web IQ 计费帐户与 AppID 或 Entra 客户端 ID 有何不同?

Web IQ 计费帐户将 Web IQ AppID、帐户访问权限和分配的范围集合分组。 Web IQ AppID 选择应用程序的运行时搜索配置。 Entra 应用程序(客户端)ID 标识获取 Entra 令牌的应用注册;它不是两个 Web IQ ID 中的任何一个。 请参阅 关键概念 和 授权资源发现。

是否可以使用我的搜索凭据创建作用域?

搜索访问权限不会自动授予管理访问权限。 调用 Web IQ 管理 API 的应用程序需要仅限应用的 Entra 令牌,并对预期的计费帐户具有 CustomerApiAccess。 人工帐户管理员单独授予此权限。 请参阅 授予管理 API 对应用程序的访问权限。

为什么“Scopes”页显示没有计费帐户可用?

“范围”页仅列出您的登录账号可以访问的计费帐户。 检查两个事项:

  1. 您已在 Web IQ Developer Portal 中连接了您的 Web IQ 资源。 如果这样做,AppID 会显示在 配置文件管理下。 如果没有,请按照Azure 门户中的“创建 Web IQ 资源”操作。
  2. 使用用于连接资源的同一地址登录。

如果两者均为 true 且页面仍为空,请打开 Web IQ 支持请求,选择 身份验证和访问 作为问题类型,并包括 AppID 和登录地址。

范围是否特定于一个 Web IQ AppID?

No. 计费帐户中的 Web IQ AppID 使用其分配的范围集合。 名称在该集合内大小写不敏感,且必须唯一。 分配给同一集合的帐户共享其定义,因此编辑或删除会影响这些定义的所有使用者。 仅知道名称并不能获得对其他账户作用域的访问权限。

空的 included 列表是否会禁用作用域?

No. 空的包含列表允许所有未被排除的源。 如果这两个列表均为空,范围本身不会施加任何网站限制。 排除始终优先于包含。

如果搜索找不到我的作用域,该怎么办?

failOnMissingScope 默认值为 true:报告的范围应用失败会返回错误,而不是未限定范围的结果。 不正确的名称或不完整的传播可能导致范围缺失。 如果显式设置 false,则搜索可以在没有作用域的情况下针对整个索引进行,并报告 scopeApplied: false。 仅当不受范围限制的结果可接受时,才使用该设置。 请参阅 命名范围错误。

scopeApplied=true 是否意味着搜索使用了我的最新作用域定义?

No. scopeApplied: true 表示已为该请求应用作用域。 它不标识使用的版本或保证全局传播。 如果未报告任何应用程序结果,则该字段是可选的;不要假定它始终存在,或对于没有 scopeName 的请求为 false。

如果在推出期间使用以前的定义是不可接受的,请在 切换调用方之前在新名称下创建和验证范围。 目前还没有就绪性端点或范围版本控制。 完全全局传播通常需要大约 10 分钟,但在某些情况下最多可能需要 30 分钟。 目前没有传播 SLA,无法保证这些时间。 切换调用方不是全局原子的。

查询行为和结果质量

我应该使用自然语言或关键字查询吗?

两者都可以正常工作。 自然语言查询通常适用于 contentFormat=passage,而关键字查询对于精确查找(如公司名称、股票代码或特定主题)非常有用。 避免过长或复合查询;将多个信息需求拆分为单独的 API 调用。

最大查询长度是多少?

最大长度为 1,000 个字符,较长的查询将被拒绝。 更短、专注的查询通常会产生更好的结果:如果查询包含大量上下文,检索可能不会专注于正确的信号。

是否可以按日期筛选 Web 搜索结果?

Web 搜索目前不提供日期范围筛选器,我们建议避免硬日期筛选器,除非确实需要一个筛选器。 新鲜度已纳入基于查询的排名中,而添加硬性日期约束几乎总是会降低相关性。 对于新闻方案,请使用新闻 API,而不是按日期筛选 Web 搜索结果。

lastUpdatedAt 是发布者上次更新内容的日期,而不是上次检查页面的 Web IQ 日期,因此较旧的日期并不意味着最近未检查该页面。 它在响应中返回,它不是请求筛选器,不是每个结果都包含它。 可以使用它对应用程序中的结果进行排序或筛选。

Web 搜索是否可以处理包含多个问题的提示?

每个 Web 搜索请求处理一个查询。 如果提示包含多个问题或意向,请在应用程序中将其拆分为单独的查询,针对每个查询调用 Web 搜索,并在生成答案之前合并结果。

Web IQ 是否可以支持多步骤代理工作流?

Yes. 代理可以在任务期间需要额外网络证据时调用 Web IQ。 检索延迟在工作流中尤其重要,这些工作流在生成应答之前进行多次调用。

我的 AI 代理或应用程序应如何处理检索到的证据?

使用与问题相关的证据并跟踪哪些来源支持答案。 使检索的内容与控制代理的说明分开。 当信息来源相互矛盾或证据不完整时,请明确说明这种不确定性,而不是用没有依据的说法来填补空白。

接地质量如何比较?

在 Microsoft 发布的比较中,Auto 和 Web 搜索以低于对比服务的令牌计数实现了更高的 grounding 满意度,而 Auto 的 grounding 满意度总体最高。 结果取决于查询集、模型和评估方法,因此根据自己的方案验证质量。

来源: Web IQ 基准结果。 2,850 个随机采样的全球查询,于 2026 年 11 月 8 日至 9 日进行评估。

Web IQ 是否会区别对待健康信息来源?

Web IQ 的排名模型使用来源可信度信号。 对于与健康相关的查询,这些信号参考了由国家医学科学院独立制定的原则。 这适用于 Web 搜索,以及来自 Web 搜索的 Auto 结果;它不适用于新闻。 这是自动的:无需开启任何内容。 我们不会发布来源列表或来源数量。 若要将结果限制为你选择的站点,请使用 Scopes。

为什么结果不同于 Bing.com?

Web IQ 针对 LLM 使用、事实密度、段落质量和低延迟进行优化。 Bing.com 是一种使用者体验,其中包含其他排名信号、个性化、视觉答案和可能无法通过 API 重新分发的内容。 预计会有一些排名差异。

相同的请求是否可以返回不同的结果?

由于索引会持续刷新,且更新会在各个数据中心之间传播,因此出现一些差异是正常的。 在短时间内发出的相同请求,其结果应保持大致稳定。 如果在几秒钟内看到相同查询的重大差异,请联系 Web IQ 支持部门。

为什么查询返回的结果少于预期?

在计算结果之前,请检查原始 Web IQ 响应。 最常见的原因是客户端设置或下游管道步骤在对其进行衡量之前会筛选出有效结果。 此外,请验证 maxResults、内容资格、SafeSearch 行为以及查询中的任何 site: 或 -site: 运算符。

语言、区域和位置如何影响结果?

查询的语言本身最重要;参数languageregion扮演辅助角色,其效果可能因 API 而异。 任何受支持的语言都适用于任何受支持的区域,例如en与IN、AU或NZ。 区域会影响排名、源和单位(例如 °C 或 °F)的组合,但不影响日期格式。 有关全局主题的查询仍返回全局结果。 对于“我附近的天气”等本地查询,位置比区域更重要。

这两个参数采用双字母代码;任何其他值返回 HTTP 400。 如果不支持双字母区域,则 Web IQ 使用 US。 如果不支持双字母语言代码,则使用该区域的默认语言。 这两种情况都不返回错误。 这在 Web 搜索、新闻搜索和 Auto 中的工作方式相同。请参阅 支持的语言和区域。

Auto 和 Auto Advanced 之间有什么区别?

它们是同一 API 的两种模式。 自动(默认值)选取问题的来源,并在一次调用中返回引用的证据。 Auto Advanced 会针对复杂问题运行额外的检索轮次;若要使用它,请设置 "mode": "advanced"。 它单独定价;请参阅 定价。

是否需要使用 responseFilter 和 Auto?

No. 自动确定查询需要哪些证据(Web、新闻、天气等),并在一次调用中返回它,因此无需单独调用每个 API。 responseFilter 列出 Auto 可以包含的证据类型;如果省略它,则所有类型都符合条件。 若要省略你永远不需要的类型,如图像或视频,请仅列出所需的类型(例如,["web", "news"])。 为应用程序设置一次,而不是针对每个查询设置一次。 Auto 支持与 Web 搜索相同的语言和区域,并且 responseFilter 在每个区域中的工作方式都相同。 请参阅 Auto API 参考。

内容格式

每个结果返回什么:段落或完整文档?

Web 搜索和新闻搜索在 content 字段中返回每个结果的内容。 将contentFormat设为passage后,可以获取与查询最相关的文档部分。 通过 text、html或 markdown,您可获得完整文档:即 Web IQ 在编制索引期间构建的页面结构化版本。 文本片段适用于每个应用程序;完整文档格式需要完整的文档访问权限。 图像和视频返回结果详细信息,例如标题、URL 和缩略图,而不是页面内容。 位置返回结构化位置详细信息,例如地址、营业时间、评论和照片,以及与查询相关的段落。 请参阅 段落和内容格式。

什么是 passage,为什么使用它?

设置 contentFormat=passage 后,API 对每个结果仅返回文档中与查询最相关的段落,而不是完整文档。 完整文档在 Web IQ 端进行处理,返回的是针对查询的摘录,因此 LLM 不必浏览不相关的段落来查找相关句子。

  • 令牌节省:LLM 接收文档的一小部分,而不是全部文档。
  • 事实准确性更高:上下文中的非主题内容较少,模型不太可能受某个离题段落影响。

在每个 Web 搜索和新闻请求上设置 contentFormat=passage 。 浏览还支持 passage:发送一个 query,Browse 会返回与查询最相关的页面部分。

我应使用哪种格式?

用于passage接地。 这是建议的格式,适用于每个应用程序。 当你需要整个文档时,使用 text、html 或 markdown,例如对完整页面进行汇总或提取。 这些格式需要完整的文档访问权限。

我应该在每个请求中设置 contentFormat 和 maxLength 吗?

Yes. 在每个 Web 搜索和新闻请求上将两者都设置,以便始终获得所需的格式和长度。

字段可以有多长content?

最多 maxLength 个字符。 如果没有完整文档访问权限,摘录每个结果最多为 3,000 个字符,即使 maxLength 设置得更高。 具有完整文档访问权限,content 最多可达 maxLength,最多 500,000 个字符。 超过 maxLength 的完整文档会被截断。

为什么当我将 text 设置为 AuthContentFormatForbidden、html 或 markdown 时,会收到 HTTP 403(contentFormat)?

在“Web 搜索”和“新闻搜索”中,text、html 和 markdown 返回完整文档,需要完全的文档访问权限。 如果没有它,这些格式将返回带有错误代码 AuthContentFormatForbidden 的 HTTP 403。 passage 适用于每个应用程序。

如何获取以text、html或markdown格式提供的完整文档?

提交Web IQ 支持请求。 已使用 html 或 text 的应用程序仍可像现在一样继续运行。

Browse 返回的内容是什么?

浏览返回你选择的 URL 的内容,最多 maxLength 个字符。 将 passage 设置为 contentFormat 和 query 时,它将返回与查询最相关的页面部分。 这是默认格式,除非应用程序具有完整的文档访问权限。 通过完全的文档访问权限,它还可以将整个文档返回为 text、html 或 markdown。 请参阅 浏览 API 参考。

当我不发送 query 时,为什么 Browse 会返回 HTTP 400?

篇章请求需要 query 不为空。 passage 是默认格式,除非应用程序具有完整的文档访问权限,因此请在每个 Browse 请求中包含 query,最多 1000 个字符。 请参阅 段落和内容格式。

如何调整 maxResults 和 maxLength 以管理上下文窗口和令牌成本?

Web IQ 可以优先处理与查询相关的段落,而不是提供不必要的页面上下文。 这可以减少传递给模型的文本量,并降低输入令牌成本。 收益取决于模型、提示、查询组合和检索设置。

对于大多数 grounding 场景,在总令牌预算大致相同的情况下,较多较短段落的结果通常比较少较长段落的结果提供更好的输出。 一个很好的起点是使用 passage 格式,maxLength 约为 3,000 个字符,并配合 maxResults=10。 使用自己的查询和模型进行基准测试。

为什么 Web 搜索和新闻搜索不返回 snippet 字段?

这是设计造成的。 两者都返回passage,作为依赖于查询的提取(snippet),而不是单独的、独立于查询的content。

响应内容

Web 搜索支持每个请求最多 50 个结果。

可以配置哪些请求参数?

Web 搜索提供 maxResults、region 和 contentFormat、passage(text、language、html 或 markdown)、maxLength 和 safeSearch。 有关完整参数列表,请参阅 API 参考 。

lastUpdatedAt和crawledAt之间有什么区别?

lastUpdatedAt 是发布者报告的内容更新日期,由 Web 搜索、新闻、视频、图像、浏览和自动返回(如果可用)。 crawledAt 是 Web IQ 上次提取页面的时间,由 Web 搜索、浏览、新闻和自动返回。这不是你的请求的时间。 这两个字段的覆盖范围因结果而异,并非每个结果都包含它们。

什么是 Browse Live Crawl?何时应使用它?

浏览返回来自必应 Web 索引的内容;当爬网程序检测到 Web 上的变化时,该索引会持续刷新。 这是 Web 搜索的一般工作原理:搜索结果来自索引,而不是在每次请求时实时抓取每个 URL,这正是 Browse 速度快且一致的原因。

浏览支持对索引中不可用的 URL 进行 实时爬网 。 在请求上设置 liveCrawl: "fallback",以便在缺少索引副本时请求实时获取。 实时爬网受发布者设定的礼貌性限制和可用性的约束;fallback 不保证实际爬网。 如果索引内容可用,则“浏览”将返回它。 省略参数(或设置 liveCrawl: "none")仅返回索引内容,而不进行实时爬网。 有关完整参数详细信息,请参阅“浏览 API 参考”。

实时爬网默认在 Web IQ Browse 上可用,并且预配了适度的每秒容量上限,独立于总体 Browse QPS。 此上限在 AppID 下的所有 API 密钥之间共享。 大多数浏览工作负载不需要实时爬网,最好使用标准索引路径;当索引中没有该 URL 时使用实时爬网。

Browse 是否可以检索 JavaScript 呈现的页面?

Yes. 将 liveCrawl: "fallback" 与 renderDynamicPages: true 一起使用。 有关完整参数集和响应详细信息,请参阅 Browse API reference。 在生产环境中依赖于此行为之前测试代表性 URL。

Browse 是否可以提取在线 PDF 文件?

联机托管的 PDF 目前不是已记录的浏览场景。 如果你有特定的 PDF 用例,请使用具有代表性的 URL 和预期行为联系 Web IQ 支持 部门,并得到明确的答案。

Web IQ 的成本是多少?

Web IQ 使用基于消耗的按呼叫定价。 定价取决于为您的帐户启用的 API、您的使用情况和您的商业条款。 请参阅定价以了解当前费率。 Web IQ 通过Azure计费,因此你的使用量计入Microsoft Azure消耗承诺(MACC),而你的Azure消费折扣(ACD)和其他协商Azure折扣适用于这些费率。 商业版(私人预览版)也按次调用计费:搜索、Offers 和产品详细信息共享一个计量项和相同的费率。

Azure中如何显示计费?

Web IQ 使用情况会通过 Web IQ 资源计量,并向 Azure 订阅计费。 服务本身Microsoft托管,未在租户中预配。

若要查看 Web IQ 成本,请在 Azure 门户中为订阅打开成本分析,使用按资源查看的成本并筛选资源类型microsoft.webiq/accounts。 调用的每个 API(例如 Web 搜索、图像或新闻)都显示为自己的计量。 自动有两米,一个用于/auto和一个。/automode: advanced 商务 API 共享一个计量。

Web IQ 是否包含 SLA、RTO 或 RPO 承诺?

No. Microsoft Web IQ 不包括服务级别协议。 Web IQ 使用条款不承诺运行时间、延迟、恢复时间目标(RTO)或恢复点目标(RPO)目标,并且不会为单个客户添加 SLA 条款。

是否需要显示引文?

Yes. 附件 A 中 Web IQ 使用条款 的第 1 部分(LLM 使用)要求提供来源署名,并在显示的 LLM 内容附近附上指向所用各来源的链接。

  • 仅引用实际用于生成答案的来源。 如果 Web IQ 返回了 10 个结果,并且模型使用了 3,则显示这 3 个结果。
  • 引文必须与答案保持可见,并且可通过单个操作访问。 不要只是短暂地显示它们、将它们隐藏在多个屏幕之后,或要求用户单独请求信息来源。
  • 对于受约束的界面(如汽车、可穿戴设备、语音优先设备或信息亭),请使用一个持久 QR 码,该代码可解析为列出用于当前答案的每个引文的页面、一个带有可点击引文的配套应用,或者用户可以直接打开的屏幕上列表。

可以将与 LLM 摘要一起显示的源链接连同该摘要一并存储在最终用户的聊天历史记录中,或作为内部工作产品的一部分。 请参阅下面的缓存问题。

我的 AI 代理或应用程序可以显示多少源内容?

《Web IQ 使用条款》附件 A 规定,显示的来自任何单一来源的 Grounding Content 以 200 个字符或网站所有者或网站管理员指定的最大值两者中的较小值为限。 对于语音或音频体验,对口头输出应用相同的限制。 附加限制适用于摘要和显示。 在设计摘录之前查看使用条款;此限制并不表示有权重现整个源页面。

图像和视频结果是否可以用于为 LLM 提供依据?

图像和视频元数据和替换文字包含在“Grounding Content”的定义中。 但是,Web IQ 使用条款禁止使用结果中的实际图像或视频用于 grounding、将其包含在 LLM 输出中,或者基于它们创建衍生图像或视频。 查看计划实施的条款。

是否可以缓存或存储 Web IQ 内容?

一般来说,不是。 Web IQ 使用条款禁止复制、存储、缓存、存档或创建内容数据库,除非条款允许(第 3.2.15 节和附件 A,第 4 节):

  • 最终用户聊天历史记录:只要适用法律允许,您即可为每位最终用户的聊天历史记录,以非汇总的、按最终用户分别的方式存储 LLM 摘要(即应用程序为最终用户基于 Grounding Content 创建的摘要,第 2.5 节)。
  • 内部工作产品:可以根据版权法允许的范围,将 LLM 摘要和源链接作为内部工作产品的集成部分(如备忘录、报表、演示文稿或安全和审核日志)存储。 它们不能用作服务或内容的替代项,例如,构建内容数据库、索引链接、爬网或抓取,或提供单独的搜索。
  • 原子操作暂时性处理:内容只能在暂时处理状态中保留,只需严格地完成 LLM 启动的单个逻辑请求或工作流(可能涉及多个内部步骤或代理交互)。 原子操作完成后,必须立即删除内容。

在这些例外之外,请勿自行存储搜索结果:使用条款不允许衍生数据库、永久性缓存或内容的长期存档。

在哪里可以阅读 Web IQ 使用条款?

当前条款发布于 Microsoft Web IQ 使用条款。 它们与您现有的 Microsoft 客户协议 一并适用。