批量转换

批量转换工具使智能体能够使用即时 (JIT) 数据源批量处理 CSV 文件。它专为以下场景而设计：您希望在 CSV 文件中对每行或每条记录应用相同的转换逻辑，而无需提前设置存储桶或索引。

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

典型用例包括：

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

数据源

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

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

配置批量转换

添加批量转换工具

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

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

配置输入

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

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

  备注：

  您必须在数据管理器中配置文件类型参数。

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

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

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

  

• 输出列 — 为批量转换生成的任何新列定义架构。为每列指定：

  • 列名称
  • 关于列代表什么以及应如何解释其值的描述

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

启用网页搜索锚定（可选）

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

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

备注：

Batch Transform with Web Search requires an LLM configuration for Gemini models.

运行批量转换

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

• 输入文件在运行时传递给工具。
• 工具对文件进行逐行处理。
• 生成转换后的输出文件。
• 返回输出文件，作为智能体输出的一部分。

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

查看执行详细信息

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

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

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

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