让AI指定工具参数#

在配置连接到工具代理的工具时，许多参数可由AI模型自动填充。AI模型将根据任务上下文及其他连接工具的信息来填写相应参数详情。

有两种实现方式可供选择，且支持随时切换。

让模型填充参数#

在工具编辑对话框中，每个适用参数字段的末端都会显示一个附加按钮：

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

激活此按钮后，AI代理将自动生成表达式，无需用户额外输入。字段内会显示提示信息，表明该参数已由模型自动定义。

若需手动定义参数，可点击输入框内的"X"图标恢复用户自定义值。请注意，"表达式"字段将保留此功能生成的表达式，此时您可参照后续章节说明进一步编辑补充细节。

警告

启用此功能将覆盖已手动定义的所有内容。

$fromAI() 函数通过AI动态填充连接到工具AI代理的工具参数。

仅限工具使用

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

使用 $fromAI() 函数时，需传入必需的 key 参数：

{{ $fromAI('email') }}

$fromAI() 函数中的 key 参数及其他参数并非对现有值的引用，而应视为供 AI 模型用于填充正确数据的提示信息。

例如，若选择名为 email 的键，AI 模型将在其上下文环境、其他工具及输入数据中寻找电子邮件地址。在聊天工作流中，若无法从其他渠道获取该信息，模型可能会向用户询问电子邮件地址。您还可以选择传入其他参数（如 description）为 AI 模型提供额外上下文。

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

参数	类型	是否必填	说明
`key`	字符串	✅	代表参数键名的字符串，长度需在 1-64 个字符之间，仅可包含大小写字母、数字、下划线和连字符
`description`	字符串	❌	描述参数的字符串
`type`	字符串	❌	指定数据类型的字符串，可选值为 string、number、boolean 或 json（默认为 string）
`defaultValue`	任意类型	❌	参数的默认值

以下示例演示如何使用 $fromAI() 表达式动态填充姓名字段：

$fromAI("name", "The commenter's name", "string", "Jane Doe")

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

$fromAI("name")

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

$fromAI("numItemsInStock", "Number of items in stock", "number", 5)

若只想用模型中的动态值填充字段的某些部分，也可在常规表达式中使用。例如，若希望模型填写电子邮件的subject参数，但始终在生成值前添加字符串“由AI生成：”，可采用以下表达式：

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

您可以通过以下模板查看 $fromAI() 函数的具体应用：