n8n 中文文档

让AI指定工具参数

配置连接到工具代理的工具[^1]时,许多参数可以由AI模型本身填写。人工智能模型将使用任务中的上下文和其他连接工具中的信息来填写适当的详细信息。

有两种方法可以做到这一点,您可以在它们之间切换。

让模型填写参数

工具编辑对话框中每个适当的参数字段末尾都有一个额外的按钮:

参数字段末尾的星形图标按钮,用于让 AI Agent 自动填写该值

激活此按钮后,AI 代理[^2] 将为您填写表达式,无需任何进一步的用户输入。 该字段本身填充了一条消息,表明该参数已由模型自动定义。

如果您想自己定义参数,请点击此框中的 'X' 以恢复到用户定义的值。请注意,'表达式'字段现在将包含此功能生成的表达式,不过您现在可以进一步编辑它以添加额外的详细信息,如下一节所述。

警告

激活此功能将覆盖您可能已添加的任何手动定义。

使用$fromAI()函数

$fromAI() 功能使用 AI 动态填充连接到工具 AI 代理 的工具的参数。

提示

Only for tools 仅适用于工具

$fromAI() 功能仅适用于连接到 AI Agent 节点的工具。 $fromAI() 功能不适用于代码 工具或其他非工具集群子节点。

要使用 $fromAI() 函数,请使用必需的 key 参数调用它:

{{ $fromAI('email') }}

key 参数和 $fromAI() 函数的其他参数不是对现有值的引用。相反,将这些参数视为 AI 模型将用来填充正确数据的提示。

例如,如果您选择一个名为 email 的键,AI 模型将在其上下文、其他工具和输入数据中查找电子邮件地址。在聊天工作流中,如果在其他地方找不到电子邮件地址,它可能会要求用户提供电子邮件地址。您可以选择传递其他参数,如 description,为 AI 模型提供额外的上下文。

参数

$fromAI() 函数接受以下参数:

参数 类型 必需? 描述
key 字符串 ✅ 表示参数的键或名称的字符串。长度必须介于 1 到 64 个字符之间,并且只能包含小写字母、大写字母、数字、下划线和连字符。
description 字符串 ❌ 描述参数的字符串。
type 字符串 ❌ 指定数据类型的字符串。可以是字符串、数字、布尔值或 json(默认为字符串)。
defaultValue 任何 ❌ 用于参数的默认值。

示例

例如,您可以使用以下 $fromAI() 表达式动态填充带有姓名的字段:

$fromAI("name", "评论者的姓名", "string", "Jane Doe")

如果您不需要可选参数,可以将其简化为:

$fromAI("name")

要动态填充您库存中的物品数量,您可以使用这样的 $fromAI() 表达式:

$fromAI("numItemsInStock", "库存物品数量", "number", 5)

如果您只想用模型的动态值填写字段的部分内容,您也可以在正常表达式中使用它。例如,如果您希望模型填写电子邮件的 subject 参数,但始终在生成的值前加上字符串 'Generated by AI:',您可以使用以下表达式:

Generated by AI: {{ $fromAI("subject") }}

模板

您可以在以下模板中查看 $fromAI() 函数的运行情况[^3]:

[^1]:在 AI 环境中,工具是一种附加资源,AI 在响应请求时可以参考该资源来获取特定信息或功能。人工智能模型可以使用工具与外部系统交互或完成特定的、有重点的任务。 [^2]:AI 代理是能够响应用户请求、做出决策并执行现实世界任务的人工智能系统。他们使用大型语言模型 (LLM) 来解释用户输入,并就如何利用现有的信息和资源最好地处理请求做出决策。 [^3]:n8n 模板是由 n8n 和社区成员设计的预构建工作流程,您可以将其导入到您的 n8n 实例中。使用模板时,您可能需要填写凭据并调整配置以满足您的需求。

相关资源

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