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 访问。 当前可用的 API 是 Web 搜索、新闻、视频、图像和浏览。 Auto 在 beta 版中可用。

什么是 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 提供最高的事实依据满意度、最快的速度以及每次查询最少的令牌。 这正是 Copilot 和 ChatGPT 等 AI 助手每天依赖的同一平台，已在全球规模验证，可作为任何 AI 代理或应用的构建基础。

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

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

来源： Web IQ 基准结果 （质量、效率和速度部分）。

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

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

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

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

使用 Web Search API 为您的模型查找相关公共页面和段落，使用 News API 获取当前事件，使用 Images 和 Videos API 获取视觉和视频结果，以及当您已经知道 URL 时使用 Browse 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 资源。 资源处理标识、计量和计费。

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

Web IQ 部署在何处？

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

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

今天不行。 专用 API 是 Web 搜索、新闻、视频、图像和 Browse。 对于没有专用 API 的财务、体育、天气和其他主题，请使用 Web 搜索，这将返回相关的已爬网内容。 该内容是非结构化页面文本，而不是结构化 feed。

访问和引导

如何从评估迁移到生产？

1. 完成评估并确认服务满足你的要求。
2. 已为 Web IQ 启用Azure订阅。
3. 在该订阅中部署 Web IQ 资源，然后登录到 Web IQ 客户站点并连接资源。 这会创建生产 AppID，其默认限制为每秒 15 次查询（QPS）。
4. 若要使用 Entra ID 进行身份验证，请将应用程序的客户端 ID 添加到 Web IQ 客户网站中的 AppID。

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

可以使用哪些Azure订阅？

Web IQ 需要付费Azure订阅。 Azure信用不适用于 Web IQ。

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

使用有权访问 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 客户端凭据流。 将应用程序的客户端 ID 添加到 Web IQ 客户站点中的 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是否可以调用多个 AppID？

Yes. 可以授权单个 Entra 应用程序（客户端）ID 来调用一个或多个 AppID。 若要选择 AppID，请将其作为查询参数传递，例如 https://api.microsoft.ai/v3/search/web?appid=<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 标识，只要其应用程序（客户端）ID 已在 Web IQ 客户网站的“配置档案管理”页面关联到您的 Web IQ 应用程序配置档案。

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

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

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

网络和安全性

Web IQ 是否支持专用链接、专用终结点、VNet 集成或 IP 允许列表？

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 资源的默认限制为每秒 15 个查询（QPS）。 此限制适用于连接资源时创建的 AppID，Web IQ 客户网站会显示该 AppID。

该限制在该 AppID 的所有 API 密钥和 Entra ID 客户端之间共享。 超出限制的请求返回 HTTP 429。

是否可以提高速率限制？

Yes. 每个 Web IQ 资源的起始值为 15 QPS。 若要请求更高的限制，请联系 Web IQ 支持 部门，并说明您的预期流量和使用场景。

可以创建多少个 API 密钥？

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

隐私和数据处理

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 帐户团队并提供以下信息：

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

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

今天无。 Web IQ 不会做出特定于区域的数据驻留或区域内处理承诺，并且跨区域路由到最近的可用终结点是预期行为。 隐私适用 Microsoft 隐私声明。

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

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

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

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

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 是否返回隐藏或不面向用户的页面内容？

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

Microsoft如何保持索引质量？

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

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

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

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

No. 排除控制包括 robots.txt 合规性、法律和合规性删除（例如 DMCA 通知和法院命令）、垃圾邮件、恶意软件和钓鱼筛选以及成人内容筛选。 这些列表本身属于专有内容，并且会持续更新。 如果您对结果中特定类别内容的出现或未出现有疑虑，请联系 Web IQ 支持，讨论您的应用程序配置文件的配置方式是否满足这些要求。

Web IQ 涵盖哪些内容，以及内容有多及时？

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

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

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

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

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

对于单个域或小型列表，请使用标准查询运算符，例如，使用 site:example.com 包含某个域，使用 -site:example.com 排除某个域。 较大的可配置列表当前未作为客户可管理功能提供。

为什么看不到领英结果？

领英结果当前被排除。

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

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

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

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

查询行为和结果质量

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

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

最大查询长度是多少？

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

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

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

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

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

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

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

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

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

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

接地质量如何比较？

Microsoft在其公布的比较中报告了最高的grounding满意度，得分为79.05。 结果取决于查询集、模型和评估方法，因此根据自己的方案验证质量。

来源： Web IQ 基准结果。 3K Global，Blind Queries 从 prod 采样，配置：10 个结果，每个结果 10K 个字符（或等效）。

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

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

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

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

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

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

响应内容

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

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

Web 搜索支持哪些内容格式？

使用 passage 时，每个结果都会返回文档中与查询最相关的部分，最多返回 maxLength 个字符（在无法访问完整文档时，最多 3,000 个字符）。 这是用于接地的建议格式。 具有完整文档访问权限的应用程序也可以使用 text、html 和 markdown。 请参阅 段落和内容格式。

什么是 passage，为什么使用它？

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

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

在每个 Web 搜索和新闻请求上设置 contentFormat=passage 。 浏览不支持 passage，因为它获取你已选择的特定 URL，并且没有可供提取的查询。

Web 搜索的最大 maxResults 值是多少？

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

可以配置哪些请求参数？

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

lastUpdatedAt和crawledAt之间有什么区别？

lastUpdatedAt 是发布者提供的内容更新日期，在可用时，由 Web 搜索、新闻、视频、图像、浏览和自动返回。 crawledAt 是 Web IQ 上次提取由 Web 搜索、浏览、新闻和自动返回的页面的时间。这两个字段的覆盖范围因结果而异。

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

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

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

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

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

对于需要在请求时即时抓取 URL 的场景，例如实时监视、竞争性检查或在你已知刚刚发生更改时触发的工作流，Browse 支持 实时爬网。 当索引副本缺失或过时时，请在请求上设置 liveCrawl: "fallback"，以选择启用实时抓取。 省略参数（或设置 liveCrawl: "none"）仅返回索引内容。 有关完整参数详细信息，请参阅“浏览 API 参考”。

实时爬网默认在 Web IQ Browse 上可用，并且预配了适度的每秒容量上限，独立于总体 Browse QPS。 此上限在 AppID 下的所有 API 密钥之间共享。 大多数浏览工作负载不需要实时爬网，最适合使用标准索引路径；实时爬网应仅用于上述少数场景。

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 是否包含 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 码，该代码可解析为列出用于当前答案的每个引文的页面、一个带有可点击引文的配套应用，或者用户可以直接打开的屏幕上列表。

可将引用存储为单个最终用户聊天历史记录的一部分，最长可达 30 天。 请参阅下面的缓存问题。

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

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

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

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

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

一般来说，不是。 Web IQ 使用条款禁止复制、存储、缓存、存档或创建内容数据库，除少数例外情况外（第 3.2.15 节以及附件 A 和 B 的第 4 节）：

• 最终用户聊天历史记录（最多 30 天）：内容可针对单个最终用户的聊天历史记录，以非聚合方式按每个最终用户存储，最长可达 30 天。 对于 LLM 使用（附件 A），这一般涵盖内容;对于搜索使用（附件 B），它涵盖图像和视频 URL。
• 原子操作暂时性处理：内容只能在暂时处理状态中保留，且仅限于严格完成由 LLM 发起的单个逻辑请求或工作流所必需的时间（称为“原子操作”，其可能涉及多个内部步骤或代理交互）。 原子操作完成后，必须立即删除内容。
• 你自己的工作产品：根据版权法允许的范围，只要未创建工作产品来替代服务（例如，构建内容数据库、为爬网编制索引链接或提供单独的搜索），内容可以复制或存储为你自己的工作产品的集成部分。

在这些例外之外，使用条款不允许衍生数据库、永久性缓存或内容的长期存档。

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

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

完整文档访问权限

为什么将 contentFormat 设置为 html 时会出现 HTTP 403？

在 Web 搜索和新闻搜索中，text、html 和 markdown 返回完整的文档，可供具有完整文档访问权限的应用程序使用。 其他应用程序收到带有错误代码 AuthContentFormatForbidden 的 HTTP 403。 passage 适用于每个应用程序。 请参阅 段落和内容格式。

如何请求完全文档访问权限？

通过Azure Support打开 Web IQ 支持请求，然后选择完整页面内容类别。 已使用 html 或 text 的应用程序仍可像现在一样继续运行。