Appearance
为低代码应用设置变量
变量用于保存低代码应用运行过程中需要读取或更新的数据。当前版本提供应用变量、用户变量和系统变量三类变量；它们的生命周期、可编辑范围和适用场景不同。
本文以当前 AIOS 低代码应用编辑器为准，介绍变量页面入口、三类变量的差异、创建与保存方式，以及如何在测试数据中检查用户变量。
进入变量页面
- 进入 AI 编程 > 项目管理。
- 找到一个低代码应用并打开编辑器。
- 确认页面顶部已切换到 业务逻辑。
- 在左侧资源栏底部展开 设置，单击 变量。
变量页面顶部包含两个页签：
- 变量设置：创建和维护应用变量、用户变量，查看系统变量。
- 测试数据：查看或修改当前测试环境中的用户变量值。
认识三类变量
| 变量类型 | 数据保存方式 | 是否可新增 | 是否可修改 | 适合保存什么 |
|---|---|---|---|---|
| 应用变量 | 每次新请求按默认值重新初始化 | 是 | 是 | 单次请求中的临时状态、计算结果和流程控制数据 |
| 用户变量 | 按用户持久化保存 | 是 | 是 | 用户偏好、昵称、设置以及需要跨请求保留的数据 |
| 系统变量 | 由平台在请求运行时产生 | 否 | 否，只读 | 平台提供的用户或运行环境信息 |
应用变量
应用变量用于在同一次请求涉及的多个开发场景之间传递数据。每次发起新请求时，变量都会从配置的默认值重新初始化，因此不适合保存需要长期保留的信息。
当前页面可为应用变量配置以下字段：
- 名称：变量在工作流中的标识，必填。
- 描述：说明变量的用途，建议填写。
- 类型：支持
String、Number、Boolean、Object和Array。 - 默认值：新请求开始时使用的初始值。
例如，可以创建 score 变量，类型选择 Number，默认值设为 0。工作流可在当前请求中更新分数；下一次新请求开始时，score 会重新变为 0。
用户变量
用户变量按用户保存，适合存放需要跨请求读取的数据，例如用户昵称、语言偏好或个性化设置。
当前用户变量区域提供以下字段：
- 名称：变量在工作流中的标识，必填。
- 描述：变量用途说明。
- 默认值：首次使用该变量或尚未写入用户数据时采用的值。
当前页面不提供用户变量的类型选择器。创建后，可以在工作流中读取或更新变量，也可以在 测试数据 页签中直接检查测试值。
系统变量
系统变量由平台提供，开发者不能新增、删除或修改。当前版本的变量页面在 用户信息 分类下展示以下变量：
| 名称 | 类型 | 说明 | 支持渠道 |
|---|---|---|---|
sys_uuid | string | 使用者标识、发布渠道与应用组合后的用户标识编码值 | 全部渠道 |
sys_uuid 适合在工作流或数据库操作中区分不同使用者。它是平台生成的组合标识，不应当作账号资料中的原始用户 ID 使用。
系统变量由平台统一提供，请以变量页面实际展示的内容为准。
创建应用变量
- 打开 变量设置 页签。
- 展开 应用变量。
- 单击 新增子项。
- 填写变量名称和描述。
- 从类型下拉框选择
String、Number、Boolean、Object或Array。 - 根据类型填写默认值。
- 单击页面右上角的 保存。
配置时注意：
- 同一应用中的变量名称应保持唯一，并使用便于工作流识别的名称。
Number和Boolean的默认值应与所选类型一致。Object和Array用于保存结构化数据，引用前应确认下游节点能够处理相同结构。- 修改已被工作流引用的变量名称或类型后，应同步检查相关节点配置。
创建用户变量
- 打开 变量设置 页签。
- 展开 用户变量。
- 单击 新增子项。
- 填写名称、描述和默认值。
- 单击 保存。
例如，创建名为 nickname 的用户变量，并设置默认值“新用户”。工作流首次读取时可取得默认值；工作流更新该变量后，后续请求可以继续读取该用户对应的新值。
在工作流中使用变量
读取变量
在支持变量引用的工作流节点中，打开参数值选择器，然后从应用变量、用户变量或系统变量中选择目标变量。运行时，节点会读取当前请求或当前用户对应的变量值。
常见用法包括：
- 在大模型提示词中读取用户昵称或偏好。
- 在条件判断中读取应用变量，决定后续执行分支。
- 在数据库查询条件中引用
sys_uuid，筛选当前使用者的数据。 - 在结束节点中组合变量值，生成最终输出。
修改变量
需要更新应用变量或用户变量时，在工作流中添加变量赋值节点，并设置：
- 要写入的目标变量。
- 写入值，可以是固定值，也可以引用上游节点输出。
- 后续节点读取更新后的变量值。
系统变量为只读数据，不能作为变量赋值节点的写入目标。
查看和修改测试数据
- 在变量页面切换到 测试数据。
- 在列表中查看用户变量的名称、当前取值和修改时间。
- 如需测试其他值，直接修改 取值 输入框。
- 单击右上角 保存。
- 需要重新读取当前数据时，单击“取值”标题旁的刷新按钮。
应用变量会在每次新请求中按默认值初始化，因此不会作为持久化数据列在这里。sys_uuid 等系统变量由平台在请求运行时产生，也不在当前测试数据列表中手动编辑。
修改或删除变量
- 在 变量设置 中直接修改应用变量或用户变量的字段，然后单击 保存。
- 单击变量行右侧的删除图标可移除应用变量或用户变量。
- 系统变量不能修改或删除。
删除或重命名变量前，应先检查工作流中的引用。引用仍指向旧变量时，节点可能读取不到值或在运行时失败。
常见问题
为什么测试数据中看不到应用变量？
应用变量是请求级临时数据，每次新请求都会按默认值重新初始化，不属于测试数据页展示的持久化用户数据。
为什么系统变量不能编辑？
系统变量由平台在请求运行时产生，只能读取，不能新增、删除或赋值。
修改变量后，工作流中仍然使用旧配置怎么办？
先保存变量设置，再打开引用该变量的工作流节点，重新选择变量并保存工作流。变量被重命名或更改类型后，原有节点不会自动适配新的业务含义。