---
url: https://docs.ogmabox.com/es/app/environment.md
description: >-
  Gestiona las variables de entorno de Ogma para Reenvío, Automatización, Flujos
  de trabajo y el contexto de las pruebas.
---

# Entorno {#environment}

Las variables de entorno almacenan valores reutilizables que puedes referenciar en solicitudes de Reenvío, Automatización y Flujos de trabajo.

## Crear y editar variables {#creating-and-editing-variables}

1. Abre **Entorno** desde la navegación izquierda.
2. Haz clic en **Añadir variable**.
3. Introduce un nombre que empiece por una letra o un guion bajo, seguido de letras, números, guiones bajos o guiones (máximo 64 caracteres).
4. Introduce el valor.
5. Activa **Secreta** si el valor es sensible (claves de API, tokens, contraseñas). Los valores secretos se ocultan en la interfaz y se excluyen del contexto de IA.
6. Haz clic en **Guardar**.

Para editar una variable existente, haz clic en su fila y actualiza el nombre o el valor.

## Utilizar variables en solicitudes {#using-variables-in-requests}

Referencia una variable de entorno con el prefijo `env.`:

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

Ejemplos:

* Campo Host: {{env.TARGET\_HOST}} (almacena un nombre de host, no una URL completa).
* Cabecera de autorización: Bearer {{env.AUTH\_TOKEN}}.
* Cuerpo de solicitud: {"tenant": "{{env.TENANT\_ID}}"}; activa las plantillas de cuerpo en Reenvío cuando quieras realizar sustituciones dentro del cuerpo.

Ogma resuelve los marcadores de entorno válidos al enviar. Si falta una variable, se produce un error en lugar de enviar silenciosamente un valor sin resolver. Los envíos de Reenvío en modos Raw y Hex conservan los bytes exactos y no expanden los marcadores.

## Ámbito de las variables {#variable-scope}

Elige **Global** para valores compartidos por los proyectos de este espacio de trabajo de Ogma, o **Proyecto** para valores del proyecto activo. Los valores de proyecto prevalecen sobre los globales con el mismo nombre. Reenvío también admite sobrescrituras de colección y sesión; la prioridad es sesión, colección, proyecto y después global.

## Transformaciones y valores dinámicos {#transforms-and-dynamic-values}

Añade transformaciones con una barra vertical, por ejemplo {{env.AUTH\_TOKEN|base64\_encode}} o {{env.SEARCH|url\_encode}}. La cadena se aplica de izquierda a derecha. Comprueba el resultado con una solicitud de prueba: los nombres de transformación no reconocidos se omiten y no se notifican como errores.

Los valores integrados no necesitan una variable guardada:

| Marcador | Valor |
| --- | --- |
| {{$timestamp}} | Hora Unix actual en milisegundos. |
| {{$timestamp\_s}} | Hora Unix actual en segundos. |
| {{$uuid}} | Un UUID nuevo. |
| {{$random(16)}} | 16 bytes aleatorios representados en hexadecimal. |
| {{$date(%Y-%m-%d)}} | Fecha UTC actual según un patrón de formato de fecha. |

Los valores almacenados no se expanden de forma recursiva. Si un valor contiene otro marcador, ese texto anidado permanece literal.

## Acceso del asistente de IA {#ai-assistant-access}

El asistente de IA puede leer los nombres y valores de las variables no secretas para aportar contexto cuando le pides que analice una solicitud o redacte un plan de pruebas. Las variables secretas nunca se incluyen en el contexto de IA.

## Usos habituales {#common-uses}

| Variable | Valor de ejemplo |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...` (marcar como secreto) |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...` (marcar como secreto) |
| `USER_ID` | `12345` |

## Páginas relacionadas {#related-pages}

* [Reenvío](./replay.md)
* [Automatización](./automate.md)
* [Flujos de trabajo](./workflows.md)