处理文件

智能体 支持将文件作为输入和输出来处理。 这使您可以从 Maestro 流程、RPA 工作流或独立智能体运行中传递文件，并从生成文件的工具接收文件。

本节概述了如何配置智能体以接受文件、哪些工具支持文件处理、已知限制，以及用于在不同执行环境中集成文件输入的示例。

准备智能体以接受文件

1. 打开智能体定义。
2. 在“数据管理器”中，创建新输入。
3. 使用类型选取器将输入类型更改为“文件”。

智能体还必须包含至少一个能够处理 文件的工具。 没有工具，智能体就无法直接处理文件。以下工具可以接受或生成文件：

• RPA 工作流 – 包含处理文件的活动的流程。

• IXP – 用于从结构化、半结构化或非结构化文档中提取字段的自定义模型或模板化模型。

• 分析文件 – 将兼容的文件直接发送到模型。

  

以下工具与文件输入或输出尚不兼容。 预计在即将推出的版本中提供文件支持。

• API 工作流
• MCP 服务器
• Integration Service 活动 – 作为解决方法，您可以使用 RPA 工作流来处理文件操作。
• 升级 – 要处理文件，请先将文件上传到存储桶，然后使用文档查看器和应用程序文件变量导入并显示该文件。

从 Maestro 流程传递文件

要在 Maestro 流程中将文件传递给智能体：

1. 确保流程包含输出文件的活动或工作流。
2. 或者，如果流程在开始时收到文件，则请添加 file 类型的参数。

3. 使用文件输入添加智能体，并将文件变量映射到智能体的输入。
4. 在Debug或部署模式下运行流程；智能体可以接收Runtime/runtime文件。

从 RPA 工作流传递文件

要从 RPA 工作流传递文件：

1. 确保工作流中的活动或触发器生成文件。
2. 使用运行作业活动并引用具有文件输入的智能体。

备注：

文件支持需要 Studio Desktop 2025.10.0 或更高版本。

在评估中使用文件

当智能体定义“文件”类型的输入参数时，评估设置让您能够上传或选择在评估运行期间用作测试输入的文件。因此可以根据真实文档或图像（例如屏幕截图、PDF 或其他支持的文件类型）验证智能体行为。

要在评估中使用文件：

1. 打开智能体，然后导航到“评估集”。
2. 创建新的评估或编辑现有评估。
3. 在“输入设置”面板中，找到“文件”输入字段。
4. 上传新文件或从可用评估文件中选择一个文件。
5. 保存评估并运行评估集。

选定的文件以与 Runtime 文件输入相同的方式传递给智能体，确保评估和生产运行之间的行为一致。

在评估中处理文件输入时，您可以：

• 直接从评估设置流程中上传文件
• 查看以前上传的文件
• 选择要用于给定的评估输入的文件

在评估设置期间选择的文件仅用于评估运行，不会影响生产智能体的执行。

备注：

在模拟模式下，不支持文件。