n8n-让 AI 自动填写工具参数

[!info] 文章概述
本文详细介绍了 n8n 中 AI 自动填写工具参数的两种方式：通过界面按钮自动填充和使用 $fromAI() 函数。这些功能可以帮助用户更快速地配置工作流中的工具参数。

1- 让 AI 自动填写工具参数

在配置与 Tools Agent 连接的 app node 工具时，许多参数可以由 AI 模型自动填写。

AI 模型会根据任务上下文和其他关联工具的信息，智能填充合适的参数值。

您可以通过以下两种方式实现这一功能，并可以随时切换。

1.1- 自动填充参数

在工具的编辑对话框中，每个支持自动填充的参数字段末尾都有一个特殊按钮：

参数字段右侧的星星按钮

点击该按钮后，AI Agent 会自动生成表达式并填充到字段中，无需用户手动输入。字段中会显示一条提示信息，表明该参数已由 AI 模型自动定义。

如果您希望手动修改参数，可以点击字段中的 “X” 按钮，恢复为手动输入模式。此时，" 表达式 " 字段会保留 AI 生成的表达式，您可以进一步编辑或补充细节（如下文所述）。

[!note] 注意

启用自动填充功能会覆盖您之前手动输入的任何内容。

1.2- 使用 $fromAI() 函数

$fromAI() 函数能够动态填充与 Tools AI agent 连接的工具参数。您可以在 app node（如 Gmail、Notion 或 Slack）的表达式内调用 $fromAI() 函数，这些节点作为工具连接到 AI Agent。

仅适用于 Node Tools

$fromAI() 函数仅适用于与 Tools Agent 连接的 app node 工具，不能用于 Call n8n Workflow、Code、HTTP Request 或其他 cluster sub-nodes。

调用 $fromAI() 函数时，需传入 key 参数：

{{ $fromAI('email') }}

key 参数和其他参数并非直接引用现有值，而是为 AI 模型提供提示，帮助其生成合适的数据。

例如，若指定 key 为 email，AI 模型会从上下文、其他工具或输入数据中查找电子邮件地址。在聊天工作流中，如果找不到相关地址，模型可能会直接向用户询问。您还可以通过 description 等参数为模型提供额外上下文。

1.3- 参数说明

$fromAI() 函数支持以下参数：

参数 类型 是否必需？ 描述
key 字符串 是 参数的名称或标识符，长度限制为 1-64 个字符，仅支持字母、数字、下划线和连字符。
description 字符串 否 参数的描述信息。
type 字符串 否 参数的数据类型，可选值为 string、number、boolean 或 json（默认为 string）。
defaultValue 任意 否 参数的默认值。

1.4- 示例

以下是一些 $fromAI() 函数的用法示例：

  1. 动态填充评论者姓名：

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

  2. 简化版本（仅指定 key）：

    $fromAI("name")

  3. 动态填充库存数量：

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

  4. 结合静态文本使用：

    由 AI 生成：{{ $fromAI("subject") }}

1.5- 应用模板

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