n8n 中文文档

AI代理工具节点

AI 代理工具节点允许工作流程中的根级代理[^1] 调用其他代理作为工具来简化多代理编排。

主代理可以监督并将工作委托给专门从事不同任务和知识的AI代理工具节点。这允许您在单个工作流程中使用多个代理,而无需管理子工作流程所需的上下文和变量的复杂性。您可以将 AI Agent Tool 节点嵌套到多个层中,以实现更复杂的多层用例。

本页面列出了 AI Agent Tool 节点的参数,并提供了更多资源的链接。

提示

Parameter resolution in sub-nodes 子节点参数解析

使用表达式处理多个项目时,子节点的行为与其他节点不同。

大多数节点,包括根节点,接受任意数量的项目作为输入,处理这些项目,并输出结果。您可以使用表达式引用输入项目,节点会依次为每个项目解析表达式。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 会依次解析为每个名称。

在子节点中,表达式始终解析为第一项。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 始终解析为名字。

节点参数

使用这些参数配置 AI Agent Tool 节点:

  • Description 描述:向法学硕士描述该代理人的目的和责任范围。良好的具体描述会告诉父代理何时将任务委托给该代理进行处理。
  • Prompt (User Message) 提示(用户消息):LLM 的提示,解释要执行哪些操作以及要返回哪些信息。
  • Require Specific Output Format 需要特定的输出格式:是否希望节点需要特定的输出格式。打开时,n8n 会提示您连接输出解析器之一在代理主页上描述。
  • Enable Fallback Model 启用回退模型:是否启用后备模型。启用后,n8n 会提示您连接备份聊天模型,以便在主模型出现故障或不可用时使用。

节点选项

使用这些选项优化 AI Agent Tool 节点的行为:

  • System Message(系统消息): 在对话开始前发送给代理的消息。
  • Max Iterations(最大迭代次数): 模型在停止前生成响应的最大运行次数。
  • Return Intermediate Steps(返回中间步骤): 是否在最终输出中包含代理采取的中间步骤。
  • Automatically Passthrough Binary Images(自动传递二进制图像): 是否应该将二进制图像作为图像类型消息自动传递给代理。
  • Batch Processing(批量处理): 是否启用以下批量处理选项以进行速率限制:
    • Batch Size(批量大小): 并行处理的项目数。这有助于速率限制,但可能会影响日志输出顺序。
    • Delay Between Batches(批次间延迟): 批次之间等待的毫秒数。

模板和示例

浏览AI Agent Tool节点文档集成模板或搜索所有模板

$fromAI() 刀具的动态参数

要了解如何动态填充应用程序节点工具的参数,请参阅让AI使用$fromAI()指定工具参数。

[^1]:AI 代理是能够响应用户请求、做出决策并执行现实世界任务的人工智能系统。他们使用大型语言模型 (LLM) 来解释用户输入,并就如何利用现有的信息和资源最好地处理请求做出决策。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。