---
url: https://docs.ogmabox.com/zh/app/environment.md
description: 管理用于重放、自动化、工作流和测试上下文的 Ogma 环境变量。
---

# 环境 {#environment}

环境变量存储可复用的值，供重放、自动化和工作流中的请求引用。

## 创建和编辑变量 {#creating-and-editing-variables}

1. 从左侧导航打开**环境**。
2. 点击**新建**。
3. 输入名称，以字母或下划线开头，后续字符可为字母、数字、下划线或连字符（最多 64 个字符）。
4. 输入值。
5. 如果值属于敏感信息（API 密钥、令牌、密码），开启**机密**。机密值在 UI 中会被遮蔽，并排除在 AI 上下文之外。
6. 点击**保存**。

要编辑现有变量，点击其所在行并更新名称或值。

## 在请求中使用变量 {#using-variables-in-requests}

使用 `env.` 前缀引用环境变量：

```
{{env.VARIABLE_NAME}}
```

示例：

* 主机字段：{{env.TARGET\_HOST}}（存储主机名，而非完整 URL）。
* Authorization 请求头：Bearer {{env.AUTH\_TOKEN}}。
* 请求体：{"tenant": "{{env.TENANT\_ID}}"}；需要替换请求体中的内容时，在重放中启用请求体模板。

Ogma 在发送时解析有效的环境占位符。变量缺失会产生错误，而不会默默发送未解析的值。原始和十六进制重放发送会保留精确字节，不展开占位符。

## 变量作用域 {#variable-scope}

选择**全局**，用于此 Ogma 工作区内各项目共享的值；选择**项目**，用于属于当前项目的值。同名项目值会覆盖全局值。重放还支持集合和会话覆盖；优先级依次为会话、集合、项目、全局。

## 转换与动态值 {#transforms-and-dynamic-values}

使用管道符追加转换，例如 {{env.AUTH\_TOKEN|base64\_encode}} 或 {{env.SEARCH|url\_encode}}。转换链从左到右执行。请通过测试请求检查输出：无法识别的转换名称会被跳过，不会报错。

内置值无需保存为变量：

| 占位符 | 值 |
| --- | --- |
| {{$timestamp}} | 当前 Unix 时间，单位为毫秒。 |
| {{$timestamp\_s}} | 当前 Unix 时间，单位为秒。 |
| {{$uuid}} | 新生成的 UUID。 |
| {{$random(16)}} | 以十六进制表示的 16 个随机字节。 |
| {{$date(%Y-%m-%d)}} | 使用日期格式模式表示的当前 UTC 日期。 |

存储的值不会递归展开。如果值中包含另一个占位符，嵌套文本会保持字面内容不变。

## AI 助手访问 {#ai-assistant-access}

当你让 AI 助手分析请求或起草测试计划时，它可以读取非机密变量的名称和值作为上下文。机密变量绝不会包含在 AI 上下文中。

## 常见用途 {#common-uses}

| 变量 | 示例值 |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...`（标记为机密） |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...`（标记为机密） |
| `USER_ID` | `12345` |

## 相关页面 {#related-pages}

* [重放](./replay.md)
* [自动化](./automate.md)
* [工作流](./workflows.md)