通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用必应自定义搜索提供事实依据（预览版）

“通过必应自定义搜索提供事实依据”工具让你的 Azure AI 代理可以在可配置的公共 Web 域集中进行搜索。 它允许你定义要从中绘制的 Web 部分，以便用户只能看到所选域和子域的相关结果。 首先需要在 Azure 门户中创建“通过必应自定义搜索提供事实依据”资源。

部署资源后，转到 Azure AI Foundry 门户中的 配置，然后创建一个配置实例，仅包括用户感兴趣的网站内容。 有关如何创建自定义配置的说明，请参阅 设置部分。

配置该工具后，可以将其连接到 Azure AI 代理。 当用户发送查询时，代理将决定是否应利用“通过必应自定义搜索提供事实依据”。 如果是这样，它将使用必应搜索你指定的域并返回相关的区块。 最后，Azure AI 代理将使用返回的区块生成响应以返回到用户

重要

  • 使用“通过必应自定义搜索提供事实依据”可能会产生费用。 有关详细信息，请参阅定价页。
  • 通过代码优先体验（如 Azure CLI）创建和使用“通过必应自定义搜索提供事实依据”资源，或者通过部署模板进行部署，即表示你同意受使用条款提供的条款的约束并遵守这些条款，这些条款可能会不时更新。
  • 将 Grounding 与必应自定义搜索配合使用时，客户数据将被转移到 Azure 符合性边界之外，并交由 Grounding 配合必应自定义搜索服务处理。 “使用必应自定义搜索进行基础设置”不受相同的数据处理条款（包括处理位置）的约束，并且没有与 Azure AI Foundry 代理服务相同的合规性标准和认证，如“通过必应自定义搜索提供事实依据使用条款”中所述。 你有责任评估在代理中将 Grounding 与必应自定义搜索配合使用是否符合你的需求和要求。

“通过必应自定义搜索提供事实依据”工作原理

用户查询是指最终用户发送给代理的消息，例如“有什么瓶装水可用？”（假设您创建了 Contoso 产品网站的一个实例）。 说明是开发人员可以提供的系统消息，用于共享上下文，并向 AI 模型提供有关如何使用各种工具或行为的说明。

当用户发送查询时，客户的 AI 模型部署首先处理查询（根据提供的说明），然后执行必应自定义搜索查询（这对开发人员可见）。 “通过必应自定义搜索提供事实依据”将相关的搜索结果返回到客户的模型部署，然后生成最终输出。

注释

将 Grounding 与必应自定义搜索配合使用时，必应自定义搜索查询、配置实例、工具参数和资源密钥将发送到必应，并且不包含任何特定于最终用户的信息。 资源密钥发送到必应仅出于计费和速率限制目的。

授权将在“使用必应自定义搜索进行基础设置”服务和 Azure AI Foundry 代理服务之间发生。 出于事实依据的目的生成和发送到必应的任何必应自定义搜索查询会与资源密钥和配置实例一起传输到“通过必应自定义搜索提供事实依据”服务的 Azure 合规性边界之外。 “使用必应自定义搜索进行基础设置”受必应的条款约束，并且没有与 Azure AI 代理服务相同的合规性标准和认证，如“使用必应自定义搜索进行基础设置使用条款”中所述。 你有责任评估在代理中使用“通过必应自定义搜索提供事实依据”是否满足你的需求和要求。

开发人员和最终用户无权使用必应自定义搜索从 Grounding 返回的原始内容。 但是，模型响应包含带有用于生成响应的网站的链接的引文，并被允许使用代理服务提供的机制进行存储。 可以通过访问创建的线程中的数据来检索模型响应。 根据“通过必应自定义搜索提供事实依据”的“使用和显示要求”，这些引用必须以 Microsoft 提供的确切形式保留和显示。

设置

注释

只能将 Azure OpenAI 模型与“通过必应自定义搜索提供事实依据”配合使用。

  1. 按照快速入门中的步骤创建 Azure AI 代理。

  2. 在 Azure 门户中创建“通过必应自定义搜索提供事实依据”资源。 需要在订阅或资源组中具有所有者或参与者角色才能创建它。 确保在 Azure AI 代理、AI 项目和其他资源所在的同一资源组中创建这项“通过必应自定义搜索提供事实依据”资源。

  3. 创建了“通过必应自定义搜索提供事实依据”资源后，可以创建配置实例。

    1. 转到创建的“通过必应自定义搜索提供事实依据”资源

    2. 在左侧面板中选择 “资源管理 ”。

    3. 选择“配置”。

    4. 选择“ 创建新配置”。

创建或更新配置时，请输入以下信息：

  1. 你的配置的名称。 可以随时更改此频率。

  2. 在以下至少一个字段中包括用于定义搜索切片的 URL：

    注释

    “通过必应自定义搜索提供事实依据”仅会返回已公开且已由必应编制索引的域和网页的结果。

    • 域 (例如， https://www.microsoft.com)
    • 域和路径（例如） https://www.microsoft.com/surface
    • 网页 （例如， https://www.microsoft.com/en-us/p/surface-earbuds/8r9cpq146064）

    1. 允许搜索的域。 对于允许的域，如果要包含子页，请确保域最多具有 2 个子页级别。

    2. 要从搜索空间中排除的阻止域。

  3. 确定是否要包含子页。 子页切片指定域路径。 必应会搜索路径处和路径下找到的所有内容。 可以在路径中最多指定两个子文件夹。 例如，www.microsoft.com/windows/。

  4. 根据需要调整排名。

  5. 在 Azure AI Foundry 门户中，导航到你的代理的“代理”屏幕，向下滚动“知识”右侧的“设置”窗格。 然后选择“添加”。

    AI Foundry 门户中代理屏幕的屏幕截图。

  6. 选择“使用必应自定义搜索提供事实依据”工具。

  7. 选择以创建新连接或使用现有连接

    1. 对于新连接，选择你的“使用必应自定义搜索提供事实依据”资源。

  8. 连接到资源后，选择配置名称。

  9. 保存该工具并开始与代理聊天。

自定义搜索配置功能

“通过必应自定义搜索提供事实依据”是一项功能强大的工具，可用于选择一个 Web 的子空间来限制代理的事实依据知识。 可在此处找到有关如何充分利用此功能的一些提示：

  1. 如果你拥有要在搜索中包含但必应未编制索引的公共网站，请参阅 必应网站管理员文档 ，了解有关获取网站索引的详细信息。 如果索引不更新，Webmaster 文档还提供了有关如何让必应爬遍您的网站的详细信息。

  2. 只能阻止某些域，并针对 Web 的其余部分（例如竞争对手的网站）执行搜索。

可选参数

使用必应自定义搜索工具将 Grounding 添加到代理时，可以传递以下参数。 这些参数会影响“通过必应自定义搜索提供事实依据”工具的输出，并且 AI 模型可能不会完全使用所有输出。 有关 API 版本支持以及如何传递这些参数的信息，请参阅 代码示例 。

名称 价值 类型 必选
count 响应中要返回的搜索结果数。 默认值为 5，最大值为 50。 传递的实际数字可能小于请求数。 多个页面的结果可能会有一些重叠。 此参数仅影响网页结果。 AI 模型可能不使用必应返回的所有搜索结果。 UnsignedShort 否
freshness 按以下不区分大小写的年龄值筛选搜索结果：
日：返回必应在过去 24 小时内发现的网页。
周：返回必应在过去 7 天内发现的网页。
月：返回必应在过去 30 天内发现的网页。 若要获取必应在特定时间范围内发现的文章，请以以下形式指定日期范围：YYYY-MM-DD..YYYY-MM-DD。 例如，freshness=2019-02-01..2019-05-30。 若要将结果限制为单个日期，请将此参数设置为特定日期。 例如，freshness=2019-02-04。		 字符串 否
market 结果来源的市场。 通常， mkt 是用户发出请求的国家/地区。 然而，如果用户所在的国家/地区不是必应提供搜索结果的地方，则可能是其他国家/地区。 市场必须采用以下形式： <language>-<country/region> 例如，en-US。 字符串不区分大小写。 有关可能的市场值的列表，请参阅 “市场代码”。 如果已知，建议你始终指定市场。 指定市场有助于必应路由请求，并返回适当且最优的响应。 如果指定市场代码中未列出的市场，必应会根据可能会更改的内部映射使用最适合的市场代码。 字符串 否
set_lang 可用于用户界面字符串的语言。 可以使用 2 个字母或 4 个字母代码指定语言。 首选使用 4 个字母代码。
有关支持的语言代码的列表，请参阅必应支持的语言。
如果 setlang 包含有效的 2 字母非特定区域性代码 (fr) 或有效的 4 字母特定区域性代码 (fr-ca)，必应会加载本地化字符串。 例如，对于 fr-ca，必应会加载 fr 非特定区域性代码字符串。
如果 setlang 无效（例如 zh）或者必应不支持该语言（例如 af、af-na），则默认为 en（英语）。
若要指定 2 个字母代码，请将此参数设置为 ISO 639-1 语言代码。
若要指定 4 个字母的代码，请使用格式 <language>-<country/region>，其中 <language> 为 ISO 639-1 语言代码（中性区域性），<country/region> 为 ISO 3166 国家/地区代码（特定区域性）。 例如，可以使用 en-US 表示美国英语。
虽然是可选的，但应始终指定语言。 通常，将 setLang 设置为与 mkt 指定的相同语言，除非用户希望界面语言显示为其他语言。		 字符串 否