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.
Este recurso é opcional. Sem ativá-lo, o interpretador de código continua funcionando normalmente, com arquivos temporários.
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.
-
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.
-
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.
-
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:
- Implantação no Azure: o Azure cria os recursos;
- Propagação das permissões: o acesso da aplicação ao contêiner pode levar de alguns minutos a dezenas de minutos;
- Validação do acesso: o Omni grava, lê e exclui um arquivo de teste no contêiner;
- 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).
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
- Em uma conversa, o interpretador de código gera um arquivo (por exemplo, uma planilha) e o entrega ao usuário.
- 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.
- 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. |
- 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.
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.
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
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.
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.