让 AI 指定工具参数#
在配置连接到 Tools Agent（工具代理）的工具时，许多参数可以由 AI 模型自动填充。AI 模型会利用任务上下文以及其它已连接工具的信息，自动填入合适的参数值。 有两种方式可以实现这一功能，你可以在这两者之间切换。
让模型填充参数#
在工具的编辑对话框中，每个适用的参数字段末尾都有一个额外的按钮： 显示参数字段右侧有星星图标的图像 激活此按钮后，AI Agent 将自动为你生成表达式，无需进一步的手动输入。该字段将显示一条消息，表明参数已由模型自动定义。
如果你想手动定义该参数，可点击该框中的 'X' 按钮，恢复为用户自定义值。请注意，此时“表达式”字段中将包含此前该功能生成的表达式，但你现在可以进一步编辑它，以添加更多细节（如以下部分所述）。
警告 启用此功能将覆盖你可能已手动输入的任何内容。
使用 $fromAI() 函数#
$fromAI() 函数利用 AI 动态填充连接到 Tools AI Agent 的工具参数。
仅适用于工具
$fromAI() 函数仅适用于连接到 AI Agent 节点的工具。该函数不支持 Code 工具，也不支持 其他非工具类集群子节点。
要使用 $fromAI() 函数，请调用并传入必需的 key 参数：
1| ``` {{$fromAI('email')}}
---|---
`key` 参数以及 `$fromAI()` 函数的其他参数并不是对现有值的引用。相反，你可以将这些参数视为 AI 模型用来填充正确数据的提示（hints）。
例如，如果你选择一个名为 `email` 的 key，AI 模型会在其上下文、其他工具和输入数据中查找电子邮件地址。在聊天工作流中，如果无法在其他地方找到邮箱地址，它还可能会向用户询问。你也可以选择性地传入如 `description` 等其他参数，以向 AI 模型提供额外的上下文信息。
### 参数#
`$fromAI()` 函数接受以下参数：
参数 | 类型 | 是否必需？ | 说明
---|---|---|---
`key` | string | !✅ | 表示参数的键名或名称的字符串。长度必须在 1 到 64 个字符之间，且只能包含小写字母、大写字母、数字、下划线和连字符。
`description` | string | !❌ | 描述该参数的字符串。
`type` | string | !❌ | 指定数据类型的字符串。可选值为 string、number、boolean 或 json（默认为 string）。
`defaultValue` | any | !❌ | 该参数的默认值。
### 示例#
例如，你可以使用以下 `$fromAI()` 表达式来动态填充一个姓名字段：1
| ```
$fromAI("name","The commenter's name","string","Jane Doe")---|--- 如果你不需要可选参数，可以简化为：
1| ``` $fromAI("name")
---|---
要动态填充库存中的商品数量，你可以使用如下 `$fromAI()` 表达式：1
| ```
$fromAI("numItemsInStock","Number of items in stock","number",5)---|---
如果你想仅用模型生成的动态值填充某个字段的一部分内容，也可以将其用于普通表达式中。例如，如果你想让模型填写电子邮件的 subject 字段，但始终在生成的内容前加上前缀“Generated by AI:”，则可以使用以下表达式：
1| ``` Generated by AI: {{$fromAI("subject")}}
---|---
模板#
你可以在以下 模板（templates） 中查看 $fromAI() 函数的实际应用：
- Angie，基于 Telegram 语音和文本的个人 AI 助手
- 使用 AI 文本分类器自动处理客户支持问题
- 通过 Pitch Deck AI 视觉、聊天机器人和 QDrant 向量数据库扩展交易流程