---
url: https://docs.ogmabox.com/zh-Hant/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)