让 AI 指定工具参数#

在配置连接到 Tools Agent 的应用节点工具时，许多参数可以由 AI 模型自动填充。AI 模型会利用任务上下文和其他连接工具的信息来填写合适的参数细节。

有两种方式可以实现这一功能，您可以随时切换使用。

让模型自动填充参数#

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

激活此按钮后，AI Agent 会自动为您填充表达式，无需任何用户输入。字段中会显示一条消息，表明该参数已由模型自动定义。

如果您想自行定义参数，可以点击该框中的"X"恢复用户定义值。请注意，"expression"字段现在将包含此功能生成的表达式，但您可以按照下一节所述进一步编辑以添加额外细节。

/// 警告激活此功能将覆盖您可能已手动定义的任何内容。 ///

$fromAI() 函数利用 AI 技术动态填充连接到 Tools AI 代理的工具参数。您可以在应用节点（如 Gmail、Notion 或 Slack）的表达式中使用 $fromAI() 函数，这些节点作为工具连接到 AI 代理。

仅适用于节点工具

$fromAI() 函数仅适用于连接到 Tools Agent 的应用节点工具。无法在 Call n8n Workflow、Code、HTTP Request 或其他集群子节点中使用 $fromAI() 函数。

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

{{ $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() 表达式动态填充名称字段：

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

如果不需要可选参数，可以简化为：

$fromAI("name")

要动态填充库存商品数量，可以使用如下 $fromAI() 表达式：

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

如果只想用模型生成的动态值填充字段的一部分，也可以在普通表达式中使用。例如，如果希望模型填写电子邮件的 subject 参数，但始终在生成值前加上字符串"由AI生成："，可以使用以下表达式：

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

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