使用 Azure 门户调试搜索问题

  • 5 分钟

首次创建搜索服务时，必须对要编制索引的数据做出一些假设。 你可以选择索引以及如何引入该数据。 但是，在运行创建的索引器之前，你无法确定你做出了所有正确的选择。

在这里，你将了解如何在 Azure AI 搜索中使用调试会话工具，查看调试，然后修复特定技能，并查看在本地调试自己的自定义技能的方法。

调试会话工具是一种交互式视觉编辑器，可让你在扩充文档时逐步浏览文档的扩充管道。 可以单步执行每个技能，进行更改和修复，然后实时重新运行索引器。 修复任何问题后，可以更新并重新发布索引器，以便重新运行索引器以扩充索引中的所有文档。

为调试会话指定名称并选择要调试的索引后，搜索服务会将所需的一切复制到 Azure 存储帐户。 该副本包括技能集、索引器、源数据和最终索引中文档的扩充版本。

Azure AI 搜索中调试会话工具的屏幕截图。

会话由技能图、扩充数据源、技能详细信息窗格、执行窗格和错误/警告窗格组成。

通过技能详细信息窗格，可以展开表达式计算器来检查值并测试输入和输出。

使用调试会话调试技能集

若要创建调试会话，请在 Azure 门户中导航到搜索服务并执行以下步骤：

创建调试会话

  1. 在“概述”窗格中的“搜索管理”下选择 “调试会话 ”。

  2. 选择“+ 添加调试会话”。

  3. 在“调试会话名称”中提供一个名称，该名称可帮助你记住调试会话所针对的技能组、索引器和数据源。

  4. 在 存储连接字符串中，找到用于缓存调试会话的常规用途存储帐户。

  5. 在“索引器模板”中，选择驱动所需调试的技能组的索引器。 索引器和技能集的副本都用于初始化会话。

  6. 在“待调试文档”中，选择索引中的第一个文档或选择特定文档。

    新的调试会话窗格的屏幕截图。

  7. 选择“ 保存会话 ”以开始。

浏览和编辑技能

通过调试会话，可以探索文档在通过每个 AI 技能时如何扩充文档。 可以选择技能、查看输入和输出，甚至查看技能的 JSON 定义。

  1. 在依赖项关系图中，选择技能。

    表达式计算器的屏幕截图。

  2. 在右侧的详细信息窗格中，选择“执行”选项卡，然后在“输出”中，通过选择<组织旁边的/>来打开表达式计算器。

  3. 若要编辑技能，请选择“ 技能设置 ”选项卡。

    显示在调试会话中编辑技能的屏幕截图。

  4. 对技能的 JSON 进行任何更改，然后选择“ 保存”。

  5. 若要测试更改是否已修复问题，请选择“ 运行”。

  6. 如果问题现已解决，并且你想要发布更改，请在窗格顶部选择 “提交更改...”。

  7. 若要完成调试会话，请选择“ 保存会话”。

验证字段映射

如果输入数据与目标索引的架构不完全匹配，则可以修改索引器。 在索引过程中，使用字段映射来重塑和修复数据中的这种不匹配。

  1. 选择 Skill Graph，并检查是否已选择 依赖项关系图 。

    显示字段映射窗格的屏幕截图。

  2. 选择扩充管道中的第二步“ 字段映射”。

  3. 对应将数据映射到的位置进行任何更改。

  4. 选择“保存”。

  5. 选择最后一步“ 输出字段映射”。

  6. 可以在详细信息窗格中修复技能的输出字段映射。

  7. 选择“保存”。

  8. 若要测试更改是否已修复问题，请选择“ 运行”。

  9. 如果问题现已解决，并且你想要发布更改，请在窗格顶部选择 “提交更改...”。