# Armazenamento de Arquivos Gerados

Por padrão, os arquivos gerados pelo **interpretador de código** nas conversas (planilhas, documentos, gráficos e imagens) são **temporários**: deixam de estar disponíveis pouco tempo depois de gerados. Com o **Armazenamento de Arquivos Gerados**, cada organização passa a guardar esses arquivos em uma **conta de armazenamento do Azure da própria organização**, no seu tenant e na sua assinatura.

{% hint style="info" %}
Este recurso é **opcional**. Sem ativá-lo, o interpretador de código continua funcionando normalmente, com arquivos temporários.
{% endhint %}

### Visão geral

| Ponto | Como funciona |
| --- | --- |
| **Quem configura** | Somente o **Administrador** da organização. |
| **Onde ficam os arquivos** | Em uma conta de armazenamento do Azure da **sua assinatura**. |
| **Isolamento** | Cada organização usa um **contêiner privado e exclusivo** do Omni. |
| **Quem paga** | O **Azure cobra diretamente a sua assinatura**. O Omni não repassa nem limita esse custo. |
| **Quais arquivos** | Apenas os arquivos **novos**, gerados pelo interpretador de código e entregues na conversa, depois da ativação. |
| **Destino** | Um destino por organização. |

**O que não é feito:**

* Não há migração do histórico: arquivos gerados antes da ativação continuam temporários.
* A biblioteca de **Arquivos** não é movida.
* Arquivos intermediários do Python (rascunhos do código) não são guardados.
* Respostas em andamento no momento da ativação não são importadas.

### Antes de começar

* Você precisa ser **Administrador** no Power Omni.
* Você precisa ter, no Azure, permissão para **criar recursos** e **atribuir papéis** na assinatura ou no grupo de recursos escolhido. A configuração usa a **sua** autorização do Azure, que o Omni não guarda.
* O projeto da organização precisa usar o **New Foundry**. Projetos no **Foundry Clássico** podem ter a conta configurada, mas a ativação só é possível com New Foundry, e esses projetos continuam com arquivos temporários.
* Se o tenant exigir, um administrador do Azure pode precisar **conceder consentimento** à permissão solicitada no login.

### Como configurar

Vá em **Configurações > Armazenamento**. Na primeira vez, o Omni também pode oferecer o passo durante a configuração inicial, como um passo opcional que pode ser pulado e retomado depois.

{% stepper %}
{% step %}
#### Inicie a configuração

Na tela **Armazenamento**, leia a introdução e clique em **Configurar armazenamento**. O assistente tem quatro etapas: **Tipo**, **Destino**, **Retenção** e **Revisão**. Cancelar antes de confirmar **não altera nada no Azure**.
{% endstep %}

{% step %}
#### Escolha o tipo

* **Criar uma conta de armazenamento**: o Omni cria uma conta dedicada, com as proteções recomendadas.
* **Conectar uma conta existente**: use uma conta que você já tem. Só um contêiner exclusivo do Omni (e um papel restrito a ele) é criado; o restante da conta **não é alterado**, e outras aplicações podem continuar usando a mesma conta.
{% endstep %}

{% step %}
#### Defina o destino

Ao criar uma conta nova, informe:

* **Assinatura do Azure** e **Grupo de recursos**;
* **Nome da conta de armazenamento**: de 3 a 24 caracteres, apenas letras minúsculas e números, único no Azure;
* **Região**: o Omni sugere a região do projeto do Foundry;
* **Redundância**: **ZRS** (recomendada; cópias em três ou mais zonas da mesma região) ou **LRS** (menor custo; cópias em um único datacenter, com risco de perda em caso de falha do datacenter). Nenhuma opção replica os dados para outra região.

Ao conectar uma conta existente, selecione a conta na lista. O Omni faz uma **verificação somente leitura** da compatibilidade e informa se a conta pode ser usada. Se aparecer um aviso de contêiner existente, apague no Azure o contêiner indicado e clique em **Verificar de novo**: o Omni nunca reaproveita um contêiner já existente.
{% endstep %}

{% step %}
#### Escolha a retenção

Escolha por quanto tempo guardar os novos arquivos: **7, 30, 60, 90, 180 ou 365 dias**, ou **Ilimitada**. O Omni sugere **90 dias**, mas **não aplica nenhuma opção por você**: a escolha é obrigatória.
{% endstep %}

{% step %}
#### Revise e confirme

Confira o resumo e marque a ciência de que a conta pertence à sua assinatura e de que o Azure cobra o armazenamento diretamente de você. Clique em **Confirmar e iniciar** e entre no Azure na janela que será aberta.
{% endstep %}

{% step %}
#### Acompanhe o progresso

A configuração segue no Azure e o progresso fica salvo. **Fechar a página não cancela o trabalho**: reabra **Armazenamento** para continuar de onde parou. As etapas são:

1. **Implantação no Azure**: o Azure cria os recursos;
2. **Propagação das permissões**: o acesso da aplicação ao contêiner pode levar de alguns minutos a dezenas de minutos;
3. **Validação do acesso**: o Omni grava, lê e exclui um arquivo de teste no contêiner;
4. **Pronto para ativar**.

Se a tela parar de consultar automaticamente, use **Continuar verificando**, **Verificar implantação no Azure** ou **Testar acesso ao armazenamento**. Se for preciso a ação de um administrador do Azure, corrija a permissão indicada ou entre de novo no Azure e verifique outra vez. Em caso de falha, é possível **Tentar de novo a mesma configuração** ou **Abandonar esta configuração** (nada é excluído no Azure).
{% endstep %}

{% step %}
#### Ative a preservação

Com o acesso validado, confirme a retenção e a ciência do custo e clique em **Ativar preservação**. A ativação vale para as **próximas respostas**, inclusive em conversas já existentes.
{% endstep %}
{% endstepper %}

### O que é criado no Azure

**Conta nova**: conta do tipo **StorageV2**, desempenho **Standard**, camada **Hot**, acesso público a blobs desabilitado e acesso somente por **Microsoft Entra ID** (chaves de acesso desabilitadas). A recuperação de blobs e de contêineres excluídos (exclusão reversível) fica ativa por **7 dias**.

**Conta existente**: apenas o contêiner exclusivo do Omni e a atribuição do papel **Storage Blob Data Contributor**, restrita a esse contêiner, para a identidade da aplicação. As proteções da conta (exclusão reversível, política de ciclo de vida etc.) são **somente lidas e exibidas**, nunca alteradas.

A aplicação acessa o contêiner com a **própria identidade**, sem chaves de acesso. O Omni não recebe permanentemente permissão para gerenciar recursos na sua assinatura.

### Como funciona no dia a dia

1. Em uma conversa, o interpretador de código gera um arquivo (por exemplo, uma planilha) e o entrega ao usuário.
2. Se a preservação estiver ativa e o projeto for New Foundry, o Omni copia o arquivo para o contêiner da organização. O texto da resposta **não depende** dessa cópia.
3. O arquivo exibe seu estado na conversa:

| Estado | Significado |
| --- | --- |
| **Salvando** | A cópia para o armazenamento da organização está em andamento. |
| **Salvo** | O arquivo está guardado e disponível, com a validade (**disponível até** uma data ou **sem validade**). |
| **Temporário** | Preservação inativa ou pausada: o arquivo pode deixar de estar disponível pouco depois de gerado. |
| **Não foi possível salvar** | A cópia falhou. O texto da resposta não é afetado. Há novas tentativas automáticas enquanto a origem estiver disponível e é possível usar **Tentar salvar de novo**. |
| **Expirado / Indisponível** | A validade terminou ou o arquivo foi excluído. |

4. Arquivos salvos continuam disponíveis para download depois que a origem temporária expira, inclusive ao reabrir o histórico. Todo download passa pelo Omni, que valida o acesso do usuário àquela conversa: **quem não tem acesso à conversa não acessa o arquivo**. A tela do administrador mostra volumes e saúde, e não é um navegador dos arquivos privados dos usuários.

{% hint style="warning" %}
Se a gravação no armazenamento falhar, o Omni **não** usa outro armazenamento como alternativa: o arquivo fica como falho e o texto da resposta é mantido.
{% endhint %}

### Retenção e exclusão

* A retenção vale **por arquivo**: a validade é fixada **no momento em que o arquivo é gerado**. Alterar a retenção depois afeta **somente os arquivos futuros**.
* Ao expirar, o arquivo **deixa de ser acessível imediatamente** no Omni, e a remoção física no Azure é feita pela limpeza do Omni.
* Excluir uma conversa (ou um projeto que remove conversas) revoga o acesso e agenda a exclusão dos arquivos correspondentes.
* A retenção **ilimitada** mantém os arquivos, e o custo, até que sejam excluídos junto com a conversa.
* O Omni **não altera** políticas de ciclo de vida da sua conta: a expiração e a exclusão dos arquivos do Omni são controladas pela aplicação.

### Gerenciar o destino ativo

Em **Configurações > Armazenamento**, com o destino ativo, o Administrador pode:

* Ver o **status** (**Ativo**, **Pausado** ou **Acesso degradado**), a conta, o contêiner, a origem (conta criada pelo Omni ou conta existente conectada), a retenção e as proteções lidas da conta;
* Alterar a **retenção** dos novos arquivos;
* Ver a **saúde do acesso** e usar **Validar acesso agora**;
* Ver o **volume gerenciado** (arquivos ativos, aguardando exclusão e incertos) e **Atualizar** a medição;
* Abrir **Ver custo real no Azure**, que leva ao grupo de recursos no portal do Azure;
* **Pausar** e **Retomar** a preservação.

**Pausar** vale para as próximas respostas: os novos arquivos voltam a ser temporários. Nada é excluído, nenhuma validade muda e os arquivos já salvos continuam disponíveis até a validade de cada um. **Pausar não interrompe a cobrança** do Azure.

### Custos

{% hint style="warning" %}
O armazenamento é **cobrado diretamente pelo Azure** na sua assinatura. O Omni **não limita o gasto**: alertas de orçamento do Azure avisam, mas não impedem o consumo. Esse custo não entra na fatura do Power Omni nem nos Orçamentos do Omni.
{% endhint %}

O custo depende de:

* **Capacidade guardada** e **retenção** escolhida (a retenção ilimitada acumula custo continuamente);
* **Região** e **redundância** (LRS custa menos que ZRS);
* **Operações** e, quando aplicável, **transferência de dados**;
* **Cópias de recuperação**: a exclusão reversível (7 dias em conta nova) continua cobrada enquanto as cópias existirem, mesmo depois de o arquivo expirar ou ser excluído no Omni;
* **Outros dados**: em uma conta existente, o custo da conta também inclui o que outras aplicações guardam nela.

O **volume gerenciado** exibido no Omni é o tamanho lógico dos arquivos controlados por ele. **Não é fatura nem limite**, e não inclui cópias de recuperação, versões ou outros dados da conta. Para o custo real, use **Ver custo real no Azure** (Cost Management) e, se necessário, filtre pelo recurso da conta. O portal depende das suas permissões e pode abrir no diretório padrão: troque de diretório se preciso.

Consulte os preços do **Armazenamento de Blobs do Azure** e a **Calculadora de preços do Azure**, da Microsoft, para estimar o valor.

### Perguntas frequentes

**Os arquivos antigos serão migrados?** Não. Apenas arquivos gerados depois da ativação são guardados.

**Posso usar a mesma conta com outras aplicações?** Sim, ao conectar uma conta existente. O Omni usa só o contêiner dele e não altera o restante da conta.

**Posso trocar de conta depois?** Nesta versão há um destino por organização, e a troca ou exclusão da conta pelo Omni não está disponível.

**O Omni vê meus dados no Azure?** O acesso é feito com a identidade da aplicação, limitado ao contêiner da organização, sem chaves de acesso.

**Fechei a página durante a configuração. O que acontece?** O trabalho no Azure continua. Reabra **Armazenamento** para acompanhar.

**Por que a validação demora?** A propagação das permissões no Azure pode levar de alguns minutos a dezenas de minutos.
