跳到主要内容

Call n8n Workflow Tool(调用 n8n 工作流工具) 节点

Call n8n Workflow Tool 节点是一种工具1,让智能体2能够运行另一个 n8n 工作流并获取其输出数据。

本页列出了 Call n8n Workflow Tool 节点的参数,并提供更多资源的链接。

信息

子节点中的参数解析

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

多数节点,包括根节点,可以接收任意数量的输入数据项,处理后输出结果。你可以用表达式引用输入数据项,节点会依次对每个数据项解析表达式。例如,输入包含五个 name 值时,表达式 {{ $json.name }} 会依次解析为每个名称。

在子节点中,表达式始终解析为第一个数据项。例如,输入包含五个 name 值时,表达式 {{ $json.name }} 始终解析为第一个名称。

节点参数 ​

描述 ​

为此工作流工具输入描述,告诉智能体何时使用它。例如:

调用此工具获取随机颜色。输入应为字符串,用逗号分隔要排除的颜色名称。

Source(来源) ​

指定 n8n 要调用的工作流,可选择以下任一方式:

  • Database(数据库):从列表选择工作流,或输入工作流 ID。
  • Define Below(在下方定义):复制完整的工作流 JSON。
注意

工作流来源为 Database(数据库),且智能体在生产环境运行而非手动或聊天测试面板时,子工作流必须已发布。否则,工具调用会以 Workflow is not active and cannot be executed 错误失败,错误文本作为工具结果返回智能体,在较长的智能体回复中可能被忽略。如果智能体报告无法获取数据,请检查子工作流是否已发布,以及其执行记录列表是否有运行记录。

Workflow Inputs(工作流输入) ​

工作流来源为 Database(数据库)时,选择子工作流并在其中定义 Workflow Input Schema(工作流输入架构)后,即可定义 Workflow Inputs(工作流输入)。

选择 Refresh(刷新)按钮,从子工作流获取输入字段。

可组合以下任意方式定义工作流输入值:

  • 提供固定值。
  • 使用表达式引用当前工作流的数据。
  • 选择字段右侧的 AI 按钮,让 AI 模型指定参数。
  • 在表达式中使用 $fromAI() 函数,控制模型填充数据的方式,并混合 AI 生成的输入与其他自定义输入。

要引用当前工作流的数据,请先选择 Expressions(表达式)模式,再将输入面板中的字段拖到目标字段。

开始使用 $fromAI() 函数时,选择字段右侧的“Let the model define this parameter”(让模型定义此参数)按钮,再使用框中的 X 恢复为用户定义值。字段会变成表达式字段,并预填 $fromAI() 表达式。随后可自定义表达式,添加其他静态或动态内容,或调整 $fromAI() 函数参数。

模板与示例 ​

浏览 Call n8n Workflow Tool(调用 n8n 工作流工具) 集成模板,或搜索所有模板

相关资源 ​

有关 LangChain 工具的更多信息,请参阅 LangChain 工具文档。

查看 n8n 的高级 AI 文档。

Footnotes​

  1. 在 AI 场景中,工具是附加资源,AI 可在响应请求时调用它获取特定信息或功能。AI 模型可以通过工具与外部系统交互,或完成具体、专门的任务。 ↩

  2. AI 智能体是能够响应请求、作出决策并为用户执行现实任务的人工智能系统。它们使用大型语言模型(LLM)理解用户输入,并根据可用的信息和资源,决定如何最好地处理请求。 ↩

本文为社区中文翻译。查看对应英文原文