> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/advanced-ai/examples/using-the-fromai-function.md).

# 在 Duaer 里用 $fromAI 填工具参数

在 Duaer 里，$fromAI 标出由 AI Agent 在调用工具时填写的参数。键名只能含字母、数字、下划线和连字符。
## 让模型填参数

接到 AI Agent 的工具节点上，许多字段可以由模型根据任务上下文填写。字段旁的自动填充会写出表达式；也可以自己写 $fromAI。

$fromAI 只用于接到 Agent 的工具。它不是普通画布变量，也不会去读 [$vars](/zh/code/variables.md)。

## 写法和示例

最小写法：

```
$fromAI('email')
```

带说明、类型和默认值：

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

键名长度 1–64，只能含字母、数字、下划线和连字符，不能有空格。不合规则表达式会报错。

## 模型要求动态参数时

Google Gemini、Vertex 等在带工具时，要求至少有一个参数是动态的。一个 $fromAI 都没有，节点会提示你打开这一页。先给真正该由模型填的字段加上 $fromAI，不要为了过检查而乱加无意义的键。
## Questions

### Duaer 的 $fromAI 用在什么地方？

用在接到 AI Agent 的工具节点参数上。写法是 $fromAI('键名')，还可以带说明、类型和默认值。键名只能含字母、数字和下划线。

### 为什么 Duaer 里有的模型要求至少一个动态参数？

Google Gemini、Vertex 等在带工具调用时，要求至少有一个参数由模型填写。用 $fromAI 标出那个参数。一个都没有时，节点会链到这一页。

