Skip to content

让 AI 指定工具参数#

在配置连接到工具代理的应用节点工具时,许多参数可以由 AI 模型本身填写。AI 模型将使用任务的上下文和来自其他连接工具的信息来填写适当的详细信息。

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

让模型填写参数#

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

显示参数字段右侧星星图标的图像

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

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

Warning

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

使用 $fromAI() 函数#

$fromAI() 函数使用 AI 动态填写连接到工具 AI 代理的工具参数。您可以在连接到 AI 代理作为工具的应用节点(如 GmailNotionSlack)内的表达式中使用 $fromAI() 函数。

仅适用于节点工具

$fromAI() 函数仅适用于连接到工具代理的应用节点工具。无法将 $fromAI() 函数与调用 n8n 工作流代码HTTP 请求其他集群子节点一起使用。

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

1
{{ $fromAI('email') }}

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

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

参数#

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

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

示例#

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

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

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

1
$fromAI("name")

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

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

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

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

模板#

您可以在以下模板中看到 $fromAI() 函数的实际应用: