---
url: https://docs.ogmabox.com/it/app/environment.md
description: >-
  Gestisci le variabili di ambiente di Ogma per Ripetizione, Automazione, Flussi
  di lavoro e il contesto dei test.
---

# Ambiente {#environment}

Le variabili di ambiente memorizzano valori riutilizzabili che puoi referenziare nelle richieste di Ripetizione, Automazione e Flussi di lavoro.

## Creare e modificare variabili {#creating-and-editing-variables}

1. Apri **Ambiente** dalla navigazione a sinistra.
2. Fai clic su **Aggiungi variabile**.
3. Inserisci un nome che inizi con una lettera o un trattino basso, seguito da lettere, numeri, trattini bassi o trattini (massimo 64 caratteri).
4. Inserisci il valore.
5. Attiva **Segreto** se il valore è sensibile (chiavi API, token, password). I valori segreti sono mascherati nell'interfaccia ed esclusi dal contesto IA.
6. Fai clic su **Salva**.

Per modificare una variabile esistente, fai clic sulla sua riga e aggiorna il nome o il valore.

## Usare variabili nelle richieste {#using-variables-in-requests}

Referenzia una variabile di ambiente usando il prefisso `env.`:

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

Esempi:

* Campo Host: {{env.TARGET\_HOST}} (memorizza un nome di host, non un URL completo).
* Intestazione di autorizzazione: Bearer {{env.AUTH\_TOKEN}}.
* Corpo della richiesta: {"tenant": "{{env.TENANT\_ID}}"}; attiva l'interpolazione delle variabili nel modello del corpo in Ripetizione quando vuoi sostituzioni all'interno del corpo.

Ogma risolve i segnaposto di ambiente validi al momento dell'invio. Una variabile mancante produce un errore, anziché inviare silenziosamente un valore non risolto. Gli invii di Ripetizione in modalità Grezzo e Hex conservano i byte esatti e non espandono i segnaposto.

## Ambito delle variabili {#variable-scope}

Scegli **Globale** per i valori condivisi dai progetti di questo spazio di lavoro di Ogma, o **Progetto** per quelli del progetto attivo. I valori di progetto prevalgono sui valori globali con lo stesso nome. Ripetizione supporta anche valori sostitutivi a livello di raccolta e sessione; la priorità è sessione, raccolta, progetto e infine globale.

## Trasformazioni e valori dinamici {#transforms-and-dynamic-values}

Aggiungi trasformazioni con una barra verticale, ad esempio {{env.AUTH\_TOKEN|base64\_encode}} o {{env.SEARCH|url\_encode}}. La catena si applica da sinistra a destra. Controlla l'output con una richiesta di prova: i nomi di trasformazione non riconosciuti vengono ignorati, non segnalati come errori.

I valori integrati non richiedono una variabile salvata:

| Segnaposto | Valore |
| --- | --- |
| {{$timestamp}} | Ora Unix attuale in millisecondi. |
| {{$timestamp\_s}} | Ora Unix attuale in secondi. |
| {{$uuid}} | Un nuovo UUID. |
| {{$random(16)}} | 16 byte casuali rappresentati in esadecimale. |
| {{$date(%Y-%m-%d)}} | Data UTC attuale secondo un pattern di formato della data. |

I valori memorizzati non vengono espansi ricorsivamente. Se un valore contiene un altro segnaposto, quel testo annidato resta letterale.

## Accesso dell'assistente IA {#ai-assistant-access}

L'assistente IA può leggere i nomi e i valori delle variabili non segrete per fornire contesto quando gli chiedi di analizzare una richiesta o preparare un piano di test. Le variabili segrete non vengono mai incluse nel contesto IA.

## Usi comuni {#common-uses}

| Variabile | Valore di esempio |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...` (contrassegna come segreto) |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...` (contrassegna come segreto) |
| `USER_ID` | `12345` |

## Pagine correlate {#related-pages}

* [Ripetizione](./replay.md)
* [Automazione](./automate.md)
* [Flussi di lavoro](./workflows.md)