Armazenamento de Arquivos Gerados

Guarde na sua própria assinatura do Azure os documentos e imagens gerados nas conversas: configuração passo a passo, funcionamento, retenção e custos.

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.

  1. 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.

  2. 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.
  3. 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.

  4. 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.

  5. 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.

  6. 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).

  7. 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.

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.
  1. 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.

Atualizado