Environment Variable

Environment Variable devuelve el valor de una variable del entorno vinculado al flujo. Lo usas cuando un dato cambia según dónde se ejecuta el flujo, por ejemplo la dirección de una API de pruebas y la de producción, y no quieres escribirlo dentro de cada componente.

Como el valor se lee al ejecutar el flujo, el mismo flujo funciona con cualquier entorno que le vincules, siempre que la variable se llame igual en todos.

Cuándo usarlo

• El flujo llama a un sistema que tiene una dirección distinta en pruebas y en producción.
• Varios flujos usan el mismo identificador, como el de una hoja de cálculo o un canal, y quieres cambiarlo en un solo sitio.
• Quieres dar a un agente un dato de configuración, como el idioma de las respuestas o el nombre de la empresa, sin tocar el flujo.
• Necesitas un token guardado como variable secreta del entorno.

Configuración

Campo	Qué hace
Variable Key (obligatorio)	La variable cuyo valor quieres leer. El desplegable muestra las variables del entorno vinculado al flujo; pulsa el botón de actualizar si acabas de añadir una.

El flujo necesita tener un entorno vinculado. Consulta Vincular un entorno a un flujo.

Resultado

La salida Value es un texto con el valor de la variable. Si el flujo no tiene entorno, o la variable no existe en el entorno con el que se ejecuta, devuelve un texto vacío.

Puedes conectarla a cualquier campo que acepte texto: la dirección de un componente API Request, el prompt de un agente o un campo de otro componente.

Ejemplo

Una empresa tiene un flujo que consulta pedidos en su ERP. En el entorno Desarrollo la variable URL_API_PEDIDOS apunta al ERP de pruebas y en Producción al real.

1. Añade Environment Variable y elige URL_API_PEDIDOS en Variable Key.
2. Conecta Value al campo de dirección del componente que llama al ERP.
3. Prueba el flujo con el entorno Desarrollo. Al publicarlo con Producción, consultará el ERP real sin cambiar nada más.

Buenas prácticas

• Escribe las claves de las variables igual en todos tus entornos; si en uno falta, el componente devuelve un texto vacío sin avisar.
• Guarda tokens y contraseñas como variables secretas del entorno en lugar de escribirlos en los componentes.

Componentes relacionados

• Python Code y JS Code: también pueden leer las variables del entorno desde su código.