環境
環境變數儲存可重複使用的值，供重送、自動化和工作流程中的請求參照。
建立和編輯變數
- 從左側導覽開啟環境。
- 按一下新增。
- 輸入名稱，以字母或底線開頭，後續可使用字母、數字、底線或連字號（最多 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 |