有关 Azure AI 搜索中 AI 扩充的提示

注意

Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。

本文提供了一些技巧，帮助你开始了解和使用 AI 扩充功能以及索引过程中使用的技能集。

提示 1：从简单开始，从小处做起

Azure 门户中的 导入数据 向导支持 AI 扩充。无需编写任何代码，即可创建和检查扩充管道中使用的所有对象：索引、索引器、数据源和技能组。

另一种简单的开始方式是创建一个数据源，其中仅包含少量文档或表中的几行数据，这些文档或数据行能够代表你要编制索引的文档。小型数据集是提高查找和解决问题速度的最佳方式。将示例放入端到端流程中运行，并检查结果是否满足您的需求。对结果感到满意后，即可向数据源添加更多文件。

有时候，一个小的故障就会让索引器无法运行。如果你打算逐个解决问题，那种情况是没问题的。但是，你可能希望忽略特定类型的错误，以便索引器可以继续，并可以看到哪些流实际工作。

若要在开发过程中忽略错误，请设置 maxFailedItems 并 maxFailedItemsPerBatch -1 作为索引器定义的一部分。

{
  // rest of your indexer definition
   "parameters":
   {
      "maxFailedItems":-1,
      "maxFailedItemsPerBatch":-1
   }
}

注意

最佳做法是将生产工作负荷设置为 maxFailedItemsmaxFailedItemsPerBatch 0。

调试会话是一个可视化编辑器，可以显示技能组的依赖项图、输入和输出以及定义。它的工作原理是使用当前索引器和技能组配置从搜索索引加载单个文档。然后，可以运行整个技能组，其范围限定为单个文档。在调试会话中，可以识别和解决错误、验证更改，并将更改提交到父技能组。有关操作指南，请参阅教程：调试会话。

如果缺少内容，请检查Azure门户中已删除的文档。在搜索服务页中，打开索引器并查看成功的文档列。选择它可查看索引器执行历史记录并查看特定错误。

如果问题与文件大小有关，你可能会看到如下错误：“blob <file-name>”的大小为 <file-size> 字节，这超出了当前服务层级的文档提取最大大小限制。有关索引器限制的详细信息，请参阅 Service limits。

内容未显示的第二个原因可能与输入/输出映射错误有关。例如，输出目标名称为“People”，但索引字段名称为“people”（小写）。系统返回整个管道的 201 个成功消息，因此你认为索引成功，而实际上字段为空。

即使情况很简单，图像分析也是计算密集型操作，因此当图像特别大或特别复杂时，处理时间可能会超过允许的最长时间。

对于拥有技能组的索引器，技能组的执行时间上限在大多数级别为2小时。如果技能集处理无法在该时间段内完成，您可以将索引器设置为每两小时定期运行，以便索引器能够从上次中断的位置继续处理。

计划的索引编制将从最后一个已知的良好文档处继续。在周期性计划中，索引器可以在数小时或数天之内处理图像积压，直到所有未处理的图像都被处理完。有关计划语法的详细信息，请参阅计划索引器。

注意

如果计划的索引器在同一文档上重复失败，服务将降低其运行频率（最多每 24 小时一次），直到它取得进展。修复基础问题后，按需运行索引器。如果索引器取得进展，则会恢复为其配置的时间间隔。如果索引器在成功运行后未返回到其配置的计划，请参阅计划行为常见问题解答。

对于并行索引编制，请将数据分配到多个容器中，或同一容器的多个虚拟文件夹中。然后创建多个数据源和索引器对。所有索引器都可使用同一技能组并写入同一目标搜索索引，因此你的搜索应用无需了解这种分区。