代理

“自主智能体”节点：为 AI 智能体配置模型、提示、工具和资源，以便进行推理并完成任务。

操作

运行您在画布上创作的 AI 智能体。您为它提供模型、指令、工具和上下文，它会对您的数据进行推理，以完成任务并返回结果。

该节点在面板中标记为“自主智能体” 。将其用于 AI 驱动的决策、内容生成、分类、提取或执行任何受益于推理（而非固定逻辑）的步骤。

自主智能体在循环中进行推理。它会读取提示，决定是否调用工具或查阅其上下文，合并返回的内容，然后重复执行操作，直到找到答案或达到迭代限制。您可以使用模型、提示和连接到节点句柄的资源来塑造该循环。

何时使用此流程以及 BPMN 流程

情况	使用
您想直接在此流程中定义智能体模型、提示词和工具	自主式智能体
您希望调用已在组织中发布的智能体	BPMN 流程
您需要一个基于规则的固定分支（无需推理）	决策还是转换

自主智能体是内联编写的：其配置位于节点上，并随流移动。BPMN 流程是对单独进行版本控制和部署的智能体的引用。

添加智能体

添加节点，然后在属性面板中对其进行配置。

1. 选择输出句柄上的+按钮，或从底部工具栏中打开节点面板。
2. 选择“智能体”类别，然后选择“自主智能体” 。Flow 会添加节点并打开其属性面板。
3. 如下所述配置模型和提示。

结果：自主代理节点将添加到画布中，且其属性面板处于打开状态，可供配置。

配置参考

字段	必填	默认	描述
模型	否	组织默认智能体模型	智能体使用的大型语言模型 (LLM)。从选取器中选择一个模型，该选取器列出了您组织可用的模型。
系统提示	是	无	智能体的角色和长期指令：它是谁以及它应该如何表现。编写适用于每次调用的持久指导原则，例如智能体的角色、约束条件和输出预期。
用户提示	是	无	此调用所对应的任务。使用表达式引用工作流数据，例如$vars.start.output.request 。
温度	否	0	采样随机性，从0到1 。值越低，响应的确定性越高；值越高，响应就越多样化或更具创意。
每个响应的最大令牌数量	否	16384	每个模型响应的最大长度。上限取决于所选模型。
最大迭代次数	否	25	智能体停止之前的推理和工具调用步骤的最大数量。接受1到100之间的值。
防护机制	否	无	约束智能体行为和输出的规则，例如阻止不允许的内容或将智能体限制在定义的范围内。防护机制适用于整个智能体。

输入和输出变量

在属性面板的“变量”选项卡中声明智能体与流的其余部分交换的数据。

• 输入变量是您传递到智能体并绑定到工作流数据的值。智能体可以在推理时引用它们。新的智能体不以任何输入变量开头。
• 输出变量是智能体返回的结构化字段。每个智能体都从一个输出变量content开始，用于保存响应文本。添加更多输出变量，以使智能体返回结构化数据。

您声明的每个输出变量都将成为智能体output对象上的一个字段。为每个变量指定名称和类型，然后在系统提示中指示智能体以填充名称。智能体在单个结构化output中一起返回所有已声明的字段。

资源

自主智能体由您连接到其句柄的资源节点组成。节点具有三个资源句柄，每个句柄在画布中都有自己的标签：工具、上下文和升级。将资源连接到句柄，然后在该资源自己的属性面板中配置该资源。资源随流移动。

每个句柄仅接受其匹配的资源类型。画布会阻止无法容纳的连接，因此您无法将工具连接到上下文句柄。

工具

将工具连接到工具句柄，为智能体提供在推理时可以调用的功能。智能体在其循环中决定是否以及何时调用每个已连接的工具。每个工具都带有描述，告诉智能体该工具的用途，因此请在工具公开时编写清晰的描述。

您可以连接的工具类型包括：

• 内置工具，三个现成的工具，如下所述。
• 连接器工具，使智能体可以调用 Integration Service 操作，例如发送电子邮件或在下游系统中创建记录。
• RPA 工作流和API 函数工具，使智能体可以将已发布的 RPA 流程或 API 工作流作为工具调用。
• 模型上下文协议 (MCP) 服务器工具，公开在 MCP 服务器上发布的工具。

内置工具

Flow 附带三个内置工具。每个都是独立的资源，您可以连接到工具句柄，并在其自己的面板中进行配置。

• 分析文件：使用 LLM 分析一个或多个文件，以提取、合成或回答有关其内容的问题。描述智能体将传递的文件以及要对这些文件运行的分析任务。
• 批量转换：逐行处理和转换 CSV 文件。提供源文件，描述每行的任务，并定义该工具添加的输出列。您可以为转换启用或禁用网页搜索锚定。
• 汇总：生成带有引文的跨文档合成（最多 1,000 页）。提供来源，描述要合成的内容，然后选择文件扩展名。当来源是 PDF 时，您可以打开或关闭引文。

Context

将上下文资源连接到上下文句柄，使智能体基于您的数据。智能体在推理时会利用这些基础数据，而不是仅依赖模型。上下文资源指向组织中的上下文索引。

配置智能体从索引中检索的方式，包括检索模式（语义、结构化、DeepRAG 或批量转换）、查询、要返回的结果数量、相关性阈值以及是否包含引文。要创建新的上下文索引，请使用句柄的“添加”面板上的“新建上下文”操作，该操作将在新选项卡中打开索引创建内容。

升级

连接升级句柄，以便在智能体遇到不应该单独决策的案例时路由到人员。智能体暂停，人工处理升级，智能体得出结果继续。您可以附加以下两个升级资源中的任何一个：

• 升级: 路由到 Action 应用任务。配置操作应用程序、收件人、通知、传递给应用程序的输入以及应用程序的结果如何映射回智能体。
• Action 应用升级：路由到编码 Action 应用程序，具有相同的收件人、通知、输入和结果映射配置。

两个升级资源的配置方式相同。当您的升级目标是编码操作应用程序而不是标准操作应用程序时，请选择操作应用程序升级。要附加任一资源，需要 1.2 版或更高版本的自主代理节点。

输入和输出

输入

智能体通过上游节点的输入句柄以及您声明的任何输入变量接收数据。

输出

智能体返回一个output对象，其中包含您声明的输出变量。默认字段为content ，即响应文本。使用$vars.<node>.output.<field>访问字段，例如：

$vars.agent1.output.content

如果代理发生故障，节点会改为填充error对象。请参阅错误处理，了解错误形状以及如何在此形状上进行路由。

{
  "output": {
    "content": "string. The agent's response text, plus any output variables you declared."
  },
  "error": "object. Populated only on failure. See Error handling."
}

根据结果创建分支

关注带有决策的智能体，以根据其返回的内容进行路由：

Autonomous Agent → Decision ($vars.agent1.output.content.includes("approved"))
  → True:  continue processing
  → False: escalate or terminate

读取下游脚本节点中已声明的输出字段：

return $vars.agent1.output.content;

示例

示例 1：对传入请求进行分类

其作用：将支持请求分类为退款、投诉或问题，并将标签作为结构化输出返回。

系统提示词：

You are a support triage assistant. Classify each request into exactly one category: refund, complaint, or question. Respond with only the category.

用户提示词：

Classify this request: $vars.start.output.request

声明输出变量category （字符串）。智能体返回：

{
  "output": {
    "category": "refund"
  }
}

在$vars.agent1.output.category上路由下游 Switch。

示例 2：以端到端方式解析发票查询

功能：通过阅读发票、将答案基于策略、在需要执行操作时调用工作流，以及在金额超过阈值时升级，来回答客户的发票问题。

连接智能体的句柄：

• 上下文：保存您的计费策略的上下文索引，因此智能体可根据已批准的指南得出答案。
• 工具：一个“分析文件”内置工具，用于读取附加的发票，以及一个在计费系统中发放退款的RPA 工作流工具。
• 升级：升级资源，用于将高价值案例路由给 Action 应用程序中的审核人。

系统提示词：

You are a billing support agent. Use the billing policy in your context to answer invoice questions. Read the attached invoice before answering. If a refund is warranted and the amount is at or below 200, issue it with the refund workflow. If the amount exceeds 200, escalate for review instead of acting. Always return a structured result.

用户提示词：

Resolve this customer query: $vars.start.output.query
Invoice: $vars.start.output.invoiceFile

声明输出变量resolution （字符串）、 refundIssued （布尔值）和amount （数字）。已解决的案例返回：

{
  "output": {
    "resolution": "Refund issued for duplicate charge.",
    "refundIssued": true,
    "amount": 48.5
  }
}

使用对$vars.agent1.output.refundIssued决策来关注智能体，以在确认消息和后续路径之间进行分支。智能体会通过升级自行处理超过阈值的案例，因此该分支流中不需要额外的逻辑。

常见问题

系统会先显示输入验证错误，然后您才能进行调试。“模型”、“系统提示词”和“用户提示词”均为必填项。在每个设置完成之前，节点会报告验证错误。

循环项目的表达式无法在智能体内部解析。在提示中引用循环的当前项目时，请使用循环的当前项目表达式，例如$vars.loop1.currentItem.<field> 。引用错误的作用域会使值在运行时无法解析。

智能体如预期返回结构化数据文本。默认情况下，智能体仅返回content 。为所需的每个结构化字段声明一个输出变量，并在系统提示中指示智能体填充这些变量。

连接的批量转换工具报告验证错误。批量转换需要至少一个输出列。定义工具在调试流程之前应添加的列。

您无法将操作应用程序升级连接到智能体。Actions 应用升级需要 1.2 或更高版本的自主代理节点。如果连接被阻止，则升级节点。

相关页面

• 编排 AI 智能体
• BPMN 流程
• 人工任务