AI Agent Tool 节点#

AI Agent Tool 节点允许工作流中的根级智能体（agent）将其他智能体作为工具调用，从而简化多智能体的编排。

主智能体（primary agent）可以监督并委派任务给专精于不同任务和知识领域的 AI Agent Tool 节点。这使得你可以在单个工作流中使用多个智能体，而无需像子工作流那样处理上下文和变量管理的复杂性。你可以将 AI Agent Tool 节点嵌套多层，以支持更复杂的多层级应用场景。

本页面包含 AI Agent Tool 节点的参数说明，以及相关资源链接。

子节点中的参数解析#

当使用表达式处理多个数据项时，子节点的行为与其他节点有所不同。

大多数节点（包括根节点）可以接收任意数量的数据项作为输入，逐个处理这些数据项，并输出结果。你可以使用表达式引用输入项，节点会依次为每个输入项解析该表达式。例如，若有五个 name 值作为输入，表达式 {{ $json.name }} 会依次解析为每一个名字。

而在子节点中，表达式始终只解析为第一个数据项。例如，同样有五个 name 值作为输入时，表达式 {{ $json.name }} 始终解析为第一个名字。

节点参数#

使用以下参数配置 AI Agent Tool 节点：

Description（描述） : 向大语言模型（LLM）说明此智能体的目的和职责范围。一个清晰具体的描述有助于主智能体判断何时应将任务委派给该智能体处理。
Prompt (User Message)（提示词（用户消息）） : 提供给 LLM 的提示，说明需要执行的操作以及应返回的信息。
Require Specific Output Format（要求特定输出格式） : 是否要求节点采用特定的输出格式。启用后，n8n 会提示你连接一个输出解析器，具体选项请参见主智能体页面中关于输出格式的说明。
Enable Fallback Model（启用备用模型） : 是否启用备用模型。启用后，n8n 会提示你连接一个备用聊天模型，以便在主模型失败或不可用时使用。

节点选项#

使用以下选项来优化 AI Agent Tool（AI 代理工具）节点的行为：

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

模板与示例#

构建你的第一个 WhatsApp 聊天机器人 作者：Jimleuk 查看模板详情 使用 Seedance 生成 AI 病毒式视频并上传至 TikTok、YouTube 和 Instagram 作者：Dr. Firas 查看模板详情 能够抓取网页的 AI 代理 作者：Eduard 查看模板详情浏览 AI 代理工具集成模板，或搜索所有模板

使用 `$fromAI()` 为工具设置动态参数#

如需了解如何为应用节点工具动态填充参数，请参考使用 $fromAI() 让 AI 指定工具参数。