让AI指定工具参数#
在配置连接到工具代理的工具时，许多参数可由AI模型自动填充。AI模型将根据任务上下文及其他连接工具的信息来填写相应参数详情。
有两种实现方式可供选择，且支持随时切换。
让模型填充参数#
在工具编辑对话框中，每个适用参数字段的末端都会显示一个附加按钮：
激活此按钮后，AI代理将自动生成表达式，无需用户额外输入。字段内会显示提示信息，表明该参数已由模型自动定义。
若需手动定义参数，可点击输入框内的"X"图标恢复用户自定义值。请注意，"表达式"字段将保留此功能生成的表达式，此时您可参照后续章节说明进一步编辑补充细节。
警告
启用此功能将覆盖已手动定义的所有内容。
使用 $fromAI() 函数#
$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() 函数的具体应用：