# Almacenamiento de Archivos Generados

De forma predeterminada, los archivos generados por el **intérprete de código** en las conversaciones (hojas de cálculo, documentos, gráficos e imágenes) son **temporales**: dejan de estar disponibles poco tiempo después de generados. Con el **Almacenamiento de Archivos Generados**, cada organización guarda esos archivos en una **cuenta de almacenamiento de Azure propia**, en su tenant y en su suscripción.

{% hint style="info" %}
Esta función es **opcional**. Sin activarla, el intérprete de código sigue funcionando normalmente, con archivos temporales.
{% endhint %}

### Visión general

| Punto | Cómo funciona |
| --- | --- |
| **Quién configura** | Solo el **Administrador** de la organización. |
| **Dónde quedan los archivos** | En una cuenta de almacenamiento de Azure de **su suscripción**. |
| **Aislamiento** | Cada organización usa un **contenedor privado y exclusivo** de Omni. |
| **Quién paga** | **Azure cobra directamente a su suscripción**. Omni no traslada ni limita ese costo. |
| **Qué archivos** | Solo los archivos **nuevos**, generados por el intérprete de código y entregados en la conversación después de la activación. |
| **Destino** | Un destino por organización. |

**Lo que no se hace:**

* No hay migración del historial: los archivos generados antes de la activación siguen siendo temporales.
* La biblioteca de **Archivos** no se mueve.
* Los archivos intermedios de Python (borradores del código) no se guardan.
* Las respuestas en curso en el momento de la activación no se importan.

### Antes de empezar

* Debe ser **Administrador** en Power Omni.
* En Azure, necesita permiso para **crear recursos** y **asignar roles** en la suscripción o el grupo de recursos elegido. La configuración usa **su** autorización de Azure, que Omni no guarda.
* El proyecto de la organización debe usar **New Foundry**. Los proyectos en **Foundry Clásico** pueden tener la cuenta configurada, pero la activación solo es posible con New Foundry, y esos proyectos siguen con archivos temporales.
* Si su tenant lo exige, un administrador de Azure puede necesitar **conceder consentimiento** al permiso solicitado en el inicio de sesión.

### Cómo configurar

Vaya a **Configuración > Almacenamiento**. La primera vez, Omni también puede ofrecer este paso durante la configuración inicial, como un paso opcional que se puede omitir y retomar después.

{% stepper %}
{% step %}
#### Inicie la configuración

En la pantalla **Almacenamiento**, lea la introducción y haga clic en **Configurar almacenamiento**. El asistente tiene cuatro etapas: **Tipo**, **Destino**, **Retención** y **Revisión**. Cancelar antes de confirmar **no cambia nada en Azure**.
{% endstep %}

{% step %}
#### Elija el tipo

* **Crear una cuenta de almacenamiento**: Omni crea una cuenta dedicada, con las protecciones recomendadas.
* **Conectar una cuenta existente**: use una cuenta que ya tiene. Solo se crea un contenedor exclusivo de Omni (y un rol restringido a él); el resto de la cuenta **no se modifica**, y otras aplicaciones pueden seguir usando la misma cuenta.
{% endstep %}

{% step %}
#### Defina el destino

Al crear una cuenta nueva, indique:

* **Suscripción de Azure** y **Grupo de recursos**;
* **Nombre de la cuenta de almacenamiento**: de 3 a 24 caracteres, solo letras minúsculas y números, único en Azure;
* **Región**: Omni sugiere la región del proyecto de Foundry;
* **Redundancia**: **ZRS** (recomendada; copias en tres o más zonas de la misma región) o **LRS** (menor costo; copias en un único centro de datos, con riesgo de pérdida si el centro de datos falla). Ninguna opción replica los datos a otra región.

Al conectar una cuenta existente, selecciónela en la lista. Omni hace una **verificación de solo lectura** de la compatibilidad e informa si la cuenta se puede usar. Si aparece un aviso de contenedor existente, elimine en Azure el contenedor indicado y haga clic en **Verificar de nuevo**: Omni nunca reutiliza un contenedor existente.
{% endstep %}

{% step %}
#### Elija la retención

Elija por cuánto tiempo guardar los nuevos archivos: **7, 30, 60, 90, 180 o 365 días**, o **Ilimitada**. Omni sugiere **90 días**, pero **no aplica ninguna opción por usted**: la elección es obligatoria.
{% endstep %}

{% step %}
#### Revise y confirme

Revise el resumen y confirme que entiende que la cuenta pertenece a su suscripción y que Azure cobra el almacenamiento directamente a usted. Haga clic en **Confirmar e iniciar** e inicie sesión en Azure en la ventana que se abrirá.
{% endstep %}

{% step %}
#### Siga el progreso

La configuración continúa en Azure y el progreso queda guardado. **Cerrar la página no cancela el trabajo**: vuelva a abrir **Almacenamiento** para continuar donde quedó. Las etapas son:

1. **Implementación en Azure**: Azure crea los recursos;
2. **Propagación de los permisos**: el acceso de la aplicación al contenedor puede tardar de unos minutos a decenas de minutos;
3. **Validación del acceso**: Omni escribe, lee y elimina un archivo de prueba en el contenedor;
4. **Listo para activar**.

Si la pantalla deja de consultar automáticamente, use **Seguir verificando**, **Verificar implementación en Azure** o **Probar acceso al almacenamiento**. Si se necesita la acción de un administrador de Azure, corrija el permiso indicado o inicie sesión de nuevo en Azure y verifique otra vez. En caso de fallo, puede **Reintentar la misma configuración** o **Abandonar esta configuración** (no se elimina nada en Azure).
{% endstep %}

{% step %}
#### Active la preservación

Con el acceso validado, confirme la retención y la aceptación del costo y haga clic en **Activar preservación**. La activación vale para las **próximas respuestas**, incluso en conversaciones ya existentes.
{% endstep %}
{% endstepper %}

### Qué se crea en Azure

**Cuenta nueva**: cuenta de tipo **StorageV2**, rendimiento **Standard**, nivel **Hot**, acceso público a blobs deshabilitado y acceso solo mediante **Microsoft Entra ID** (claves de acceso deshabilitadas). La recuperación de blobs y contenedores eliminados (eliminación temporal) queda activa por **7 días**.

**Cuenta existente**: solo el contenedor exclusivo de Omni y la asignación del rol **Storage Blob Data Contributor**, restringida a ese contenedor, para la identidad de la aplicación. Las protecciones de la cuenta (eliminación temporal, política de ciclo de vida, etc.) **solo se leen y se muestran**, nunca se modifican.

La aplicación accede al contenedor con **su propia identidad**, sin claves de acceso. Omni no recibe de forma permanente permiso para administrar recursos en su suscripción.

### Cómo funciona en el día a día

1. En una conversación, el intérprete de código genera un archivo (por ejemplo, una hoja de cálculo) y lo entrega al usuario.
2. Si la preservación está activa y el proyecto es New Foundry, Omni copia el archivo al contenedor de la organización. El texto de la respuesta **no depende** de esa copia.
3. El archivo muestra su estado en la conversación:

| Estado | Significado |
| --- | --- |
| **Guardando** | La copia al almacenamiento de la organización está en curso. |
| **Guardado** | El archivo está guardado y disponible, con su validez (**disponible hasta** una fecha o **sin vencimiento**). |
| **Temporal** | Preservación inactiva o en pausa: el archivo puede dejar de estar disponible poco después de generado. |
| **No se pudo guardar** | La copia falló. El texto de la respuesta no se ve afectado. Hay reintentos automáticos mientras el origen siga disponible y se puede usar **Intentar guardar de nuevo**. |
| **Vencido / No disponible** | La validez terminó o el archivo fue eliminado. |

4. Los archivos guardados siguen disponibles para descarga después de que el origen temporal expira, incluso al reabrir el historial. Toda descarga pasa por Omni, que valida el acceso del usuario a esa conversación: **quien no tiene acceso a la conversación no accede al archivo**. La pantalla del administrador muestra volúmenes y salud, y no es un navegador de los archivos privados de los usuarios.

{% hint style="warning" %}
Si la escritura en el almacenamiento falla, Omni **no** usa otro almacenamiento como alternativa: el archivo queda como fallido y se conserva el texto de la respuesta.
{% endhint %}

### Retención y eliminación

* La retención vale **por archivo**: la validez se fija **en el momento en que el archivo se genera**. Cambiar la retención después afecta **solo a los archivos futuros**.
* Al vencer, el archivo **deja de ser accesible de inmediato** en Omni, y la eliminación física en Azure la hace la limpieza de Omni.
* Eliminar una conversación (o un proyecto que elimina conversaciones) revoca el acceso y programa la eliminación de los archivos correspondientes.
* La retención **ilimitada** mantiene los archivos, y el costo, hasta que se eliminen junto con la conversación.
* Omni **no modifica** las políticas de ciclo de vida de su cuenta: el vencimiento y la eliminación de los archivos de Omni los controla la aplicación.

### Administrar el destino activo

En **Configuración > Almacenamiento**, con el destino activo, el Administrador puede:

* Ver el **estado** (**Activo**, **En pausa** o **Acceso degradado**), la cuenta, el contenedor, el origen (cuenta creada por Omni o cuenta existente conectada), la retención y las protecciones leídas de la cuenta;
* Cambiar la **retención** de los nuevos archivos;
* Ver la **salud del acceso** y usar **Validar acceso ahora**;
* Ver el **volumen administrado** (archivos activos, pendientes de eliminación e inciertos) y **Actualizar** la medición;
* Abrir **Ver costo real en Azure**, que lleva al grupo de recursos en el portal de Azure;
* **Pausar** y **Reanudar** la preservación.

**Pausar** vale para las próximas respuestas: los nuevos archivos vuelven a ser temporales. No se elimina nada, ninguna validez cambia y los archivos ya guardados siguen disponibles hasta el vencimiento de cada uno. **Pausar no detiene el cobro** de Azure.

### Costos

{% hint style="warning" %}
El almacenamiento lo **cobra directamente Azure** a su suscripción. Omni **no limita el gasto**: las alertas de presupuesto de Azure avisan, pero no impiden el consumo. Este costo no forma parte de la factura de Power Omni ni de los Presupuestos de Omni.
{% endhint %}

El costo depende de:

* **Capacidad almacenada** y la **retención** elegida (la retención ilimitada acumula costo continuamente);
* **Región** y **redundancia** (LRS cuesta menos que ZRS);
* **Operaciones** y, cuando corresponda, **transferencia de datos**;
* **Copias de recuperación**: la eliminación temporal (7 días en cuenta nueva) se sigue cobrando mientras existan las copias, incluso después de que el archivo venza o se elimine en Omni;
* **Otros datos**: en una cuenta existente, el costo de la cuenta también incluye lo que otras aplicaciones guardan en ella.

El **volumen administrado** que muestra Omni es el tamaño lógico de los archivos que controla. **No es una factura ni un límite**, y no incluye copias de recuperación, versiones ni otros datos de la cuenta. Para el costo real, use **Ver costo real en Azure** (Cost Management) y, si es necesario, filtre por el recurso de la cuenta. El portal depende de sus permisos y puede abrirse en el directorio predeterminado: cambie de directorio si es necesario.

Consulte los precios de **Azure Blob Storage** y la **calculadora de precios de Azure**, de Microsoft, para estimar el valor.

### Preguntas frecuentes

**¿Se migrarán los archivos antiguos?** No. Solo se guardan los archivos generados después de la activación.

**¿Puedo usar la misma cuenta con otras aplicaciones?** Sí, al conectar una cuenta existente. Omni usa solo su contenedor y no modifica el resto de la cuenta.

**¿Puedo cambiar de cuenta después?** En esta versión hay un destino por organización, y el cambio o la eliminación de la cuenta desde Omni no está disponible.

**¿Omni ve mis datos en Azure?** El acceso se hace con la identidad de la aplicación, limitado al contenedor de la organización, sin claves de acceso.

**Cerré la página durante la configuración. ¿Qué pasa?** El trabajo en Azure continúa. Vuelva a abrir **Almacenamiento** para seguirlo.

**¿Por qué tarda la validación?** La propagación de los permisos en Azure puede tardar de unos minutos a decenas de minutos.
