批量转换

Add the Batch transform tool to an agent, configure its task and output columns, and read its result, with an example.

操作

批量转换是一个节点，用于逐行处理 CSV 文件，并向其中添加 AI 生成的列。您需要为它提供源 CSV、描述每行操作的任务以及要添加的列。系统会返回一个已填充这些列的新文件。

您可以将批量转换作为工具附加到自主智能体。智能体在推理时调用该工具，向其传递源文件和任务，并在其余工作中使用转换后的文件。

在“添加节点”面板中， “批量转换”位于“数据”下。

何时使用此选项

当智能体需要批量丰富或分类 CSV 的行，并且每一行都需要进行相同的 AI 驱动处理时，请使用批量转换。

典型任务：

• 将每一行归入一个类别，并将标签写入新列。
• 将自由文本字段中的值提取到其自己的列中。
• 根据每一行的现有列对每一行进行评分、汇总或标记。

如要从单个文档中提取结构化数据而不是转换表格行，请连接文档提取资源。要分析不是面向行的 CSV 的文件内容，请使用分析文件内置工具。

添加工具

将节点添加到画布中，然后将其连接到智能体。

1. 选择“自主智能体”节点，如果您的工作流还没有，请自行添加。
2. 打开“添加节点”面板，然后选择“数据”类别。
3. 选择“批量转换” 。Maestro Automate 会将节点添加到画布。
4. 在智能体工具句柄的“批量转换”节点之间绘制一条边。
5. 选择“批量转换”节点，以打开其属性面板，然后进行配置。

结果：批量转换工具已连接到智能体。智能体现在可以在推理时调用它。

配置参考

在属性面板的“批量转换设置”部分配置这些字段。

字段	必填	默认	描述
Source（文件）	是	无	要转换的 CSV 文件。引用工作流上游生成的文件或智能体在调用工具时提供的文件。
批量转换任务	是	无	工具应用于每行的说明。描述要分析的内容、要提取的内容，以及如何填充输出列。
输出列	是	无	工具添加到文件的列。定义至少 1 个包含名称和说明的列，最多添加 10 个列。
列名称	是	无	输出文件中新列的标头。
描述	是	无	列应包含的内容。该工具使用此值来决定为每行写入的内容，因此请具体说明预期格式。
网络搜索基础	否	已启用	该工具是否可以使用网页搜索来依据或丰富其结果。选择“禁用”以仅使用源文件和任务。

输入和输出

输入

批量转换从您配置的字段中获取输入：源 CSV、任务、输出列和网页搜索锚定设置。由于它作为工具运行，因此调用智能体在运行期间调用工具时会提供这些值。

输出

批量转换返回一个文件：附加并填充输出列的源 CSV。通过$vars.<nodeName>.output访问，其中<nodeName>是批量转换节点的名称。

$vars.batchTransform1.output

如果工具失败，节点会改为填充error对象。错误处理描述了错误形状以及如何在其上路由。

{
  "output": "file. The source CSV with the configured output columns added and populated.",
  "error": "object. Populated only on failure. See Error handling."
}

示例

对支持工单的 CSV 进行分类

智能体会收到支持工单的 CSV，在路由之前需要对每个工单进行分类并确定优先级。

将批量转换工具连接到智能体，并进行如下配置。

来源（文件）：工单 CSV，例如，在工作流开始时传入的文件。

批量转换任务：

For each ticket, read the Subject and Body columns. Classify the ticket into exactly one category: billing, technical, or account. Then assign a priority of high, medium, or low based on the urgency expressed in the text.

输出列：

• Category ：账单、技术或帐户之一，基于工单的主题和正文。
• Priority ：高、中或低之一，反映工单的紧急程度。

当智能体调用该工具时，批量转换会返回原始 CSV，其中为每行添加一个Category和一个Priority列。然后，智能体在剩余的任务中使用该文件（可在$vars.batchTransform1.output中获取）。

后续步骤

• 自主智能体：将批量转换作为工具进行调用的智能体。
• 文档提取: 从单个文档中提取结构化数据。
• 错误处理：工具失败时路由error对象。
• 社区：在 UiPath 论坛上与其他构建器一起提问和共享工作流。