让 AI 指定工具参数

配置连接到 Tools Agent 的工具¹时，许多参数可以由 AI 模型自行填写。模型会利用任务上下文和其他已连接工具提供的信息，填写适当的内容。

有两种方式可以实现，并且可以相互切换。

让模型填写参数

在工具的编辑对话框中，适用的参数字段末尾会多出一个按钮：

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

启用此按钮后，AI Agent² 会为你填写表达式，无需进一步输入。字段中会显示一条消息，说明参数已由模型自动定义。

如果想自行定义参数，请点击框内的“X”，恢复为用户定义的值。此时“Expression（表达式）”字段仍包含该功能生成的表达式，你可以继续编辑，按下一节的方法补充更多细节。

注意

启用此功能会覆盖此前添加的任何手动定义。

$fromAI() 函数通过 AI，为连接到 Tools AI 智能体的工具动态填写参数。

信息

仅适用于工具

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

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

{{ $fromAI('email') }}

key 参数及传给 $fromAI() 函数的其他参数，并不是对已有值的引用。可以将它们理解为提示，AI 模型会据此填写合适的数据。

例如，选择名为 email 的键后，AI 模型会在上下文、其他工具和输入数据中查找电子邮件地址。在聊天工作流中，如果无法从其他地方找到，可能会向用户询问。也可以传入 description 等其他可选参数，为模型提供更多上下文。

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

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

例如，可以使用以下 $fromAI() 表达式，为字段动态填写姓名：

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

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

$fromAI("name")

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

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

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

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

以下模板³展示了 $fromAI() 函数的实际用法：