分析文件

分析附加到智能体的文件：提取、合成或回答有关内容的查询。

操作

分析文件是附加到自主智能体的内置工具。它将一个或多个文件传递给大型语言模型 (LLM)，以提取、合成或回答有关其内容的查询。

这些文件可以是文档、图像或其他附件。智能体会在推理时决定何时调用工具，并传入文件和任务，工具返回结果供智能体使用。

何时使用此选项

当智能体需要一次读取混合文件类型、两个或多个附件，并回答问题或从中提取内容时，请连接分析文件。

在以下情况下，使用分析文件而非替代方案：

• 您有一个或多个不同类型（文档、图像、扫描）的文件，您希望智能体提取其内容或对其内容进行推理。
• 任务以自然语言（“总结此文档”、“此图像中的内容”、“提取关键点”）而非固定的字段架构描述。

对于其他形式的工作：

• 要在长文档（最多 1,000 页）中合成引文，请使用Summarize工具。
• 要使用经过训练的模型从文档中拉取结构化的输入字段，请使用提取节点。

向智能体添加工具

“分析文件”作为工具附加到自主智能体。它不会独立运行。

1. 将自主智能体添加到画布中。
2. 在节点面板中打开智能体工具类别，然后选择分析文件。流将工具节点添加到画布。
3. 将该工具连接到智能体的工具句柄。
4. 选择工具节点以打开其属性面板。
5. 按如下所述配置工具。

结果：分析文件工具已连接到智能体。智能体现在可以在推理时调用它。

配置参考

在属性面板的“分析文件设置”部分中配置工具。

字段	必填	默认	描述
工具说明	否	Analyze one or more files with an LLM to extract, synthesize, or answer queries about their content.	工具功能的自然语言描述，由智能体用于决定何时调用工具。对其进行优化，以限制智能体使用工具。
附件（数组）	否	Array of files, documents, images, or other attachments to process	智能体传递给工具的文件的说明。对其进行编辑，以告知智能体要发送的附件类型。
项目（文件）	否	空白	附件数组中单个文件的可选每个项目说明。如果数组级别的描述已足够，请将其留空。
分析任务 (字符串)	是	无	用于处理文件的任务、问题或说明。用简单的语言进行描述，例如summarize this document 、 extract key points或what is in this image 。
模拟设置	否	已收起	用于在不调用实时模型的情况下测试工具的调用示例。选择“添加示例调用” ，以定义示例。

输入和输出

输入

智能体在调用工具时会提供文件和任务。上述配置定义了智能体可以传递的内容以及工具的行为方式。

输出

该工具会将结果返回给调用它的智能体。当您需要直接在流中读取工具的输出时，请通过$vars.<nodeName>.output访问，其中<nodeName>是画布上“分析文件”节点的名称。

$vars.analyzeFiles1.output

在大多数流程中，您不会直接读取工具输出。智能体将使用结果作为其推理的一部分，并在$vars.<agentNode>.output上返回自己的结果。有关智能体的输出形状，请参阅“智能体” 。

示例

智能体处理带有混合附件（扫描的收据图像和 PDF 对账单）的传入电子邮件，并回答相关问题。

1. 将自主智能体添加到画布中。
2. 从面板中打开“智能体工具” ，然后选择“分析文件” 。
3. 将该工具连接到智能体的工具句柄。
4. 在“分析文件”工具中，编辑附件（数组）以描述智能体应发送的内容，例如The receipt image and statement PDF attached to the incoming email.
5. 将分析任务（字符串）设置为您要完成的工作：

Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.

6. 在智能体的用户提示中，指示其使用工具，例如： Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

当智能体运行时，它会带有附件调用“分析文件”，接收分析结果，并在$vars.agent1.output.content上返回其响应。

相关页面

• 代理
• 摘要
• 提取