Secretos

Algunos proyectos usan un servicio externo, como el envío de correos o una herramienta de IA. Ese servicio te da una clave de API, y el proyecto guarda esa clave en Secretos, fuera del código y fuera del chat.

El agente pide el valor

Cuando tu pedido necesita una clave, el agente muestra una tarjeta en el chat: "La app necesita una variable de entorno. Ingresa el valor y la guardo."

1. Revisa el nombre. El agente ya completó la Clave, como RESEND_API_KEY.
2. Pega el valor. Copia la clave desde tu cuenta del servicio y pégala en el campo Valor.
3. Haz clic en Guardar. La tarjeta muestra "Guardada", y el agente sigue con el trabajo.

El agente nunca ve el valor, porque la tarjeta lo guarda directo en el proyecto. Si todavía no tienes la clave, haz clic en Ahora no. No pegues la clave en el chat: el agente lee todo lo que escribes ahí.

Ejemplo de pedido:

El agente crea algunos secretos por su cuenta, y aparecen en la lista del panel.

Secreto o público

En la tarjeta y en el panel, el campo Tipo decide quién ve el valor.

• Secreto. Solo la app usa el valor, y nadie lo vuelve a leer, ni tú ni el agente. Úsalo para contraseñas y claves de API.
• Público. Cualquier persona que abre la app puede ver el valor. Úsalo para direcciones e IDs, nunca para información sensible.

El agente propone el tipo, y puedes cambiarlo antes de guardar.

Vista previa y producción

El campo Entorno decide dónde vale el valor: Vista previa, Producción o Todos, que vale en los dos.

• En el preview. El proyecto empieza a usar el valor nuevo en unos segundos, sin que hagas nada.
• En la app en el aire. El valor nuevo entra cuando publicas de nuevo.

Una clave de prueba en Vista previa y la clave real en Producción te dejan probar sin tocar lo que ya está vendiendo.

Agregar, reemplazar y eliminar

Los secretos del proyecto están en el panel Secretos. Cada fila muestra la clave, el entorno y el tipo. Solo el Propietario y quien es Editor agregan y eliminan. Quien es Lector solo ve la lista.

1. Abre el panel Secretos. Haz clic en Agregar secreto.
2. Completa el formulario. Elige el Tipo, escribe la Clave y el Valor, y elige el Entorno.
3. Haz clic en Guardar.

Un secreto no se edita, y el valor reemplazado no vuelve. Para reemplazar el valor, agrega la misma clave en el mismo entorno, y el valor nuevo reemplaza al anterior.

Eliminar no se puede deshacer. Para quitar un secreto, haz clic en Eliminar en su fila y confirma. Una fila marcada Gestionada por la Conexión viene de un servicio vinculado al proyecto y no se quita desde aquí.