Entorno
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
- Abre Entorno desde la navegación izquierda.
- Haz clic en Añadir variable.
- 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).
- Introduce el valor.
- 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.
- 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
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
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
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
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
| 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 |