批量转换

批量转换工具使智能体能够使用实时 (JIT) 数据源批量处理 CSV 文件。它适用于要在 CSV 文件的每一行或记录中应用相同的转换逻辑，而无需提前设置存储桶或索引的场景。

批量转换获取在运行时提供的输入 CSV 文件，并对其应用用户定义的转换任务。该工具逐行处理文件，并生成一个或多个输出文件，其中包含原始数据以及转换逻辑生成的任何其他列或行。

典型用例包括：

• 使用模型生成的分数、标签或分类丰富 CSV 文件
• 将业务规则或决策逻辑应用于大型数据集
• 在自动化决策的同时提供解释或理由

数据源

• 批量转换仅支持 JIT 数据源。
• 仅支持 CSV 文件作为输入。
• 智能体输入会直接传递文件，并会在运行时自动解析文件。
• 无需配置外部存储，也无需创建索引。

有关详细信息，请参阅DeepRAG 和批量转换的最佳实践：JIT 策略与基于索引的策略对比。

配置批量转换

添加“批量转换”工具

1. 在设计模式下打开智能体。
2. 从内置工具列表中，将“批量转换”添加到智能体中。

添加后，“批量转换”工具将显示为专用工具节点，您可以从右侧面板进行配置。

配置输入

在设计时，您可以指定工具应如何接收输入：

• 源文件：来源是文件输入（例如input-csv ）。在运行时，这会自动解析为智能体运行时提供的文件。

  备注：

  您必须在 Data Manager 中配置文件类型参数。

• 批量转换任务- 特定于工具的指令，用于定义应如何执行批量转换。使用此字段确切告知工具如何处理输入文件，包括：

  • 要生成的新列或行
  • 应如何处理每一行
  • 要应用的任何规则、条件或决策逻辑

  例如，您可以指示该工具根据每行的内容生成两个新列，例如分数和推荐标志。这不是智能体提示词。智能体应仅包含一些高级指令，指示何时调用批量转换以及最终输出应如何。

  

• 输出列- 为批量转换生成的任何新列定义架构。对于每一列，请指定：

  • 列名称
  • 关于列所表示内容以及应如何解释其值的说明

  您可以添加新的输出列，编辑现有列名称或说明，或根据需要删除列。“批量转换任务”应描述用于填充这些已配置列的逻辑。

启用网页搜索基础（可选）

批量转换工具包含一个可选的网页搜索基础设置，该设置可控制是否允许模型在生成转换时使用网页搜索结果。

• 启用后，模型可以在处理每一行时使用从网页检索到的信息来补充输入文件数据。
• 禁用后，将严格使用输入文件的内容、任务中定义的说明以及显式提供给智能体的任何上下文执行转换。

运行批量转换

运行或调试智能体时，批量转换工具将作为智能体运行的一部分执行：

• 输入文件在运行时传递到工具中。
• 该工具会逐行处理文件。
• 系统随即会生成已转换的输出文件。
• 输出文件将作为智能体输出的一部分返回。

在执行期间，批量转换在“执行追踪”中显示为专用工具调用。您可以展开此步骤以检查详细的运行时信息。

检查执行详细信息

在执行追踪中，您可以查看工具调用输出中显示的详细信息，适用时还可以查看智能体输出中显示的详细信息：

• 输入 - 工具使用的输入文件，包括文件名、类型和元数据（在工具调用输出中可见）。
• 输出 - 生成的输出文件，包括文件 ID、文件名和 MIME 类型（定义文件输出时显示在工具调用输出中）。
• 提示上下文 - 智能体运行期间使用的系统和用户提示，有助于解释转换任务的执行方式。

您可以直接从执行追踪记录中下载输入和输出文件，以进行验证或故障排除。

定义文件输出后，最终智能体输出通常包含一条确认消息，指明已生成已生成的文件并提供输出文件名。

评估批量转换

通过评估，您可以衡量批处理输出的质量和正确性。除了评估文件级别的结果外，智能体还支持逐行评估，这对于 CSV 文件等结构化输出尤其有用。

逐行评估

逐行评估独立评估输出文件中的每一行，而不是将文件作为一个整体进行评估。这可让您更精细地了解各个记录根据评估标准执行的操作。在以下情况下，此模式特别有用：

• 每一行都代表一个独立的决策或分类。
• 您需要针对大文件的精细的通过/失败指标。
• 您想要深入了解单个故障。

配置逐行评估

逐行评估是在评估集设置中配置的：

1. 在评估集配置中启用逐行评估。
2. 选择要评估的输出文件。当智能体生成多个输出文件时，这是必需的。
3. 指定评估程序执行操作时应处理的文件类型（例如 CSV）。

配置后，系统将对所选输出文件的每一行执行评估。

CSV 列精确匹配评估程序

为支持结构化文件评估，可以使用名为“CSV 列精确匹配评估程序”的确定性评估程序。有关详细信息，请参阅智能体评估。

此评估程序:

• 比较预期输出和实际输出之间的一个或多个指定列
• 执行精确的字符串匹配
• 返回每行的通过/失败结果

CSV 列精确匹配评估程序非常适合验证分类输出，例如标签、匹配类型或状态字段。

运行和审核评估

配置评估集后：

1. 使用输入文件和相应的批量转换输出文件创建评估运行。
2. 计划或运行评估。
3. 分两个级别审核结果：
   • 文件级摘要，显示有多少行总体通过或失败。
   • 行级别向下钻取，显示每个单独行的通过/失败状态、值和元数据。

例如，评估可能显示 199 行中有 141 行通过了特定列的精确匹配检查。这样，您可以深入检查各个失败的行，将预期值与实际值进行比较，并查看执行详细信息，例如每行延迟。

逐行评估提供：

• 一目了然地了解成功的记录或失败的记录。
• 加快转换逻辑的调试速度。
• 用于跟踪一段时间内改进情况的量化指标。