在 Azure AI 搜索中调试会话

调试会话是 Azure 门户中一个用于调试现有技能组的可视化编辑器，可在会话期间显示由索引器和技能组生成的单个扩充文档的结构和内容。 由于处理的是实时文档，因此会话是交互式的 - 你可以识别错误、修改和调用技能执行，并实时验证结果。 如果所做的更改解决了问题，则可将这些更改提交到已发布的技能组，以全局应用修复措施。

本文介绍了该编辑器的组织结构。 该编辑器的选项卡和分区将解包技能组的不同层，以便你可以检查技能组结构、流以及它在运行时生成的内容。

调试会话的工作方式

当你启动会话时，搜索服务将创建技能组、索引器的副本和一个数据源，其中包含用于测试技能组的单个文档。 所有会话状态都将保存到你提供的 Azure 存储帐户中由 Azure AI 搜索服务创建的新 Blob 容器。 生成的容器的名称具有前缀 ms-az-cognitive-search-debugsession。 必须提供前缀，因为前缀减少了将会话数据意外导出到帐户中的另一个容器的可能性。

扩充文档和技能组的缓存副本将加载到可视化编辑器中，以便你能够检查已扩充文档的内容和元数据，并且能够检查每个文档节点并编辑技能组定义的任何方面。 将缓存在会话中所做的任何更改。 除非提交这些更改，否则这些更改不会影响已发布的技能组。 提交更改将覆盖生产技能组。

如果扩充管道没有任何错误，则可使用调试会话来以增量方式扩充文档、测试和验证每个更改，然后再提交更改。

“AI 扩充”选项卡 > 技能图

视觉编辑器已组织成选项卡和窗格。 本部分介绍可视化编辑器的组件。

技能图提供技能组的可视层次结构并从上到下显示其执行顺序。 依赖于其他技能的输出的技能置于图中靠近下方的位置。 位于层次结构中同一级别的技能可并行执行。 图中技能的颜色编码标签表示技能组中要执行的技能的类型（文本或视觉）。

在“技能图”中，可选择要调试或增强的技能。 在右侧的详细信息窗格中可以编辑和浏览内容。

技能详细信息窗格

技能详细信息将显示在选项卡式布局中，并包括以下区域：

• 技能设置：技能定义的带格式版本。
• 技能 JSON 编辑器：相应定义的原始 JSON 文档。
• 执行：每次执行技能时所对应的数据。
• 错误和警告：会话启动或刷新时生成的消息。

在“执行”或“技能设置”中，选择 </> 符号可以打开表达式计算器，它可用于查看和编辑技能输入与输出表达式。

“技能设置”中的嵌套输入控件可用于为投影、复杂类型字段的输出字段映射或技能输入生成复杂的形状。 与表达式计算器配合使用时，嵌套输入可提供简单的测试和验证表达式生成器。

“执行”窗格

可针对单个文档多次执行一个技能组中的某个技能。 例如，对于从单个文档中提取的每个图像，将执行 OCR 技能一次。 “执行”窗格会显示技能的执行历史记录，有助于更深入地了解每次技能调用。

使用执行历史记录，可追溯生成特定扩充的技能。 单击某个技能输入会导航到生成该输入的技能，提供类似于堆栈跟踪的功能。 通过此操作，可识别下游技能中可能出现的问题的根本原因。

在调试某个自定义技能的错误时，可以选择在执行历史记录中生成技能调用请求。

“AI 扩充”选项卡 > 扩充的数据结构

“扩充数据结构”窗格显示通过技能组实现的文档扩充，详细介绍了每个扩充和起始技能的上下文。 表达式计算器还可用于查看每个扩充的内容。

表达式计算器

“表达式计算器”将显示技能的可执行元素。 它可用于在更新技能或投影的任何输入或上下文之前编辑路径和测试结果。

你可以从显示有 </> 符号的任何节点或元素（包括依赖项关系图的部件或扩充树中的节点）打开该计算器。

表达式计算器为你提供完全交互访问权限，以便可以测试技能上下文和输入以及检查输出。

限制

调试会话功能不支持 SharePoint Online 索引器。

后续步骤

了解调试会话的元素后，就可以在现有技能组上启动第一个调试会话了。