---
url: https://docs.ogmabox.com/pl/app/environment.md
description: >-
  Zarządzaj zmiennymi środowiskowymi Ogma na potrzeby ponownego wysyłania,
  automatyzacji, przepływów pracy i kontekstu testów.
---

# Środowisko {#environment}

Zmienne środowiskowe przechowują wartości wielokrotnego użytku, do których można odwoływać się w żądaniach w panelach Ponowne wysyłanie, Automatyzacja i Przepływy pracy.

## Tworzenie i edytowanie zmiennych {#creating-and-editing-variables}

1. Otwórz **Środowisko** w lewym panelu nawigacji.
2. Kliknij **Nowa**, aby dodać zmienną.
3. Wprowadź nazwę zaczynającą się od litery lub podkreślenia, po których mogą występować litery, cyfry, podkreślenia lub łączniki (maksymalnie 64 znaki).
4. Wprowadź wartość.
5. Włącz **Sekret**, jeśli wartość jest poufna (klucze API, tokeny, hasła). Wartości sekretów są maskowane w interfejsie i wykluczane z kontekstu AI.
6. Kliknij **Zapisz**.

Aby edytować istniejącą zmienną, kliknij jej wiersz i zmień nazwę lub wartość.

## Używanie zmiennych w żądaniach {#using-variables-in-requests}

Odwołuj się do zmiennej środowiskowej za pomocą prefiksu `env.`:

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

Przykłady:

* Pole hosta: {{env.TARGET\_HOST}} (zapisz nazwę hosta, a nie pełny URL).
* Nagłówek autoryzacji: Bearer {{env.AUTH\_TOKEN}}.
* Treść żądania: {"tenant": "{{env.TENANT\_ID}}"}; włącz szablony treści w panelu Ponowne wysyłanie, jeśli chcesz podstawiać wartości w treści.

Ogma podczas wysyłania podstawia wartości zmiennych w poprawnych symbolach zastępczych środowiska. Jeśli zmienna nie istnieje, Ogma zgłasza błąd zamiast bez ostrzeżenia wysłać symbol zastępczy niezastąpiony wartością. Wysyłanie w trybach Surowe (Raw) i Szesnastkowy (Hex) w panelu Ponowne wysyłanie zachowuje dokładne bajty i nie rozwija symboli zastępczych.

## Zakres zmiennych {#variable-scope}

Wybierz **Globalny** dla wartości współdzielonych przez projekty w tym obszarze roboczym Ogma lub **Projekt** dla wartości należących do aktywnego projektu. Wartości projektu zastępują wartości globalne o tej samej nazwie. Ponowne wysyłanie obsługuje też nadpisania na poziomie kolekcji i sesji; kolejność pierwszeństwa to sesja, kolekcja, projekt, a następnie wartości globalne.

## Transformacje i wartości dynamiczne {#transforms-and-dynamic-values}

Dodawaj transformacje za pomocą pionowej kreski, na przykład {{env.AUTH\_TOKEN|base64\_encode}} lub {{env.SEARCH|url\_encode}}. Łańcuch jest stosowany od lewej do prawej. Sprawdź wynik żądaniem testowym: nierozpoznane nazwy transformacji są pomijane, a nie zgłaszane jako błędy.

Wartości wbudowane nie wymagają zapisanej zmiennej:

| Symbol zastępczy | Wartość |
| --- | --- |
| {{$timestamp}} | Bieżący czas Unix w milisekundach. |
| {{$timestamp\_s}} | Bieżący czas Unix w sekundach. |
| {{$uuid}} | Nowy UUID. |
| {{$random(16)}} | 16 losowych bajtów w zapisie szesnastkowym. |
| {{$date(%Y-%m-%d)}} | Bieżąca data UTC zgodnie ze wzorcem formatu daty. |

Zapisane wartości nie są rozwijane rekurencyjnie. Jeśli wartość zawiera inny symbol zastępczy, tekst tego zagnieżdżonego symbolu pozostaje bez zmian.

## Dostęp asystenta AI {#ai-assistant-access}

Asystent AI może odczytywać nazwy i wartości zmiennych nieoznaczonych jako sekrety, aby uzyskać kontekst, gdy poprosisz go o analizę żądania lub przygotowanie planu testów. Zmienne oznaczone jako sekrety nigdy nie są uwzględniane w kontekście AI.

## Typowe zastosowania {#common-uses}

| Zmienna | Przykładowa wartość |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...` (oznacz jako sekret) |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...` (oznacz jako sekret) |
| `USER_ID` | `12345` |

## Powiązane strony {#related-pages}

* [Ponowne wysyłanie](./replay.md)
* [Automatyzacja](./automate.md)
* [Przepływy pracy](./workflows.md)