环境
环境变量存储可复用的值，供重放、自动化和工作流中的请求引用。
创建和编辑变量
- 从左侧导航打开环境。
- 点击新建。
- 输入名称，以字母或下划线开头，后续字符可为字母、数字、下划线或连字符（最多 64 个字符）。
- 输入值。
- 如果值属于敏感信息（API 密钥、令牌、密码），开启机密。机密值在 UI 中会被遮蔽，并排除在 AI 上下文之外。
- 点击保存。
要编辑现有变量，点击其所在行并更新名称或值。
在请求中使用变量
使用 env. 前缀引用环境变量：
{{env.VARIABLE_NAME}}示例：
- 主机字段：
{{env.TARGET_HOST}}（存储主机名，而非完整 URL）。 - Authorization 请求头：
Bearer {{env.AUTH_TOKEN}}。 - 请求体：
{"tenant": "{{env.TENANT_ID}}"}；需要替换请求体中的内容时，在重放中启用请求体模板。
Ogma 在发送时解析有效的环境占位符。变量缺失会产生错误，而不会默默发送未解析的值。原始和十六进制重放发送会保留精确字节，不展开占位符。
变量作用域
选择全局，用于此 Ogma 工作区内各项目共享的值；选择项目，用于属于当前项目的值。同名项目值会覆盖全局值。重放还支持集合和会话覆盖；优先级依次为会话、集合、项目、全局。
转换与动态值
使用管道符追加转换，例如 {{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 助手分析请求或起草测试计划时，它可以读取非机密变量的名称和值作为上下文。机密变量绝不会包含在 AI 上下文中。
常见用途
| 变量 | 示例值 |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci...（标记为机密） |
TARGET_HOST | app.example.com |
API_KEY | sk-...（标记为机密） |
USER_ID | 12345 |