Carregar um arquivo para um Genie Agent

Importante

O carregamento de arquivos CSV e Excel está em Public Preview. O carregamento de arquivos PDF está em Beta.

Carregue arquivos CSV, Excel e PDF diretamente em um Agente do Genie para que os usuários possam consultá-los em linguagem natural ao lado de tabelas do Catálogo do Unity. Isso é útil para validação rápida de dados, análise leve e trabalho com conjuntos de dados externos sem importação ou transformação manual.

Note

Os Agentes Genie eram anteriormente conhecidos como Genie Spaces.

Visão geral

Fazer upload de arquivos para um Agente Genie permite que você explore dados em uma conversa com o Agente Genie. Você pode adicionar arquivos a agentes que também incluem tabelas do Catálogo do Unity, tornando possível analisar os dados carregados junto com as fontes existentes. Em vez de importar e transformar conjuntos de dados manualmente, você pode arrastar e soltar um arquivo no chat e começar a consultá-lo imediatamente. Isso é útil para validação rápida de dados, análise leve e trabalho com conjuntos de dados externos sem configuração adicional.

Para permitir que um agente responda perguntas em arquivos não estruturados armazenados em volumes do Catálogo do Unity em vez de carregar um arquivo em uma única conversa, consulte Analisar arquivos em volumes com um Agente Genie.

Requirements

Requisitos de arquivo

Você pode carregar até 25 arquivos por conversa, independentemente do tipo de arquivo.

Arquivos CSV e Excel

Os uploads de CSV e Excel não estão disponíveis no modo agent.

  • Cada arquivo deve ter menos de 200 MB.
  • Cada arquivo deve conter menos de 100 colunas.
  • Os arquivos do Excel podem conter várias planilhas. O Genie exibe dados de exemplo da primeira planilha por padrão, mas todas as planilhas que podem ser analisadas estão disponíveis. Para consultar uma planilha específica, faça referência a ela pelo nome ao perguntar ao Genie.

Arquivos PDF

Importante

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

Os uploads de PDF exigem o modo agent.

  • Cada PDF deve ter menos de 20 MB.
  • Cada PDF não deve conter mais de 20 páginas.
  • Cada PDF é limitado a 15.000 caracteres.
  • PDFs carregados se aplicam somente à conversa atual. Novos threads de chat não incluem contexto de PDFs carregados anteriormente.
  • Os uploads de PDF só estão disponíveis por meio da interface do usuário. Não há suporte para uploads de arquivos baseados em API.

Carregar um arquivo

Somente o usuário que carregou o arquivo pode acessá-lo.

Carregue arquivos de uma das seguintes maneiras:

  • Arraste e solte o arquivo na janela de chat.
  • Clique no ícone Paperclip. Para selecionar um arquivo no navegador de arquivos.

Um agente do Genie mostra o ícone de clipe de papel.

Enviar um arquivo não envia mais uma mensagem automaticamente. Você pode adicionar um prompt para enviar junto com o arquivo, ou enviar o arquivo e então fazer perguntas sobre ele. Depois que o arquivo é carregado e processado, o Genie exibe os dados na resposta. Você pode fazer perguntas sobre o arquivo carregado e quaisquer outros dados no Agente do Genie.

Note

Os arquivos carregados são armazenados em um volume gerenciado do Unity Catalog específico para o usuário e o agente. O volume não é listável e não aparece no navegador de esquemas. As permissões em arquivos carregados não precisam ser gerenciadas manualmente. Os usuários recebem automaticamente privilégios USE CATALOG, USE SCHEMA, READ VOLUME e WRITE VOLUME nos seus arquivos carregados.

O Azure Databricks armazena arquivos enviados em armazenamento root gerenciado pelo cliente em workspaces clássicos e em armazenamento padrão em workspaces serverless.

Para obter mais informações sobre volumes gerenciados, consulte O que são volumes do Catálogo do Unity?.

Exibir arquivos disponíveis

Para exibir arquivos que foram carregados no agente, clique no ícone Paperclip. Para abrir o menu de arquivo. Se um arquivo de Excel carregado tiver várias planilhas, eles aparecerão como arquivos separados no menu.

Ajustar configurações de formato de arquivo

Para ajustar as configurações de formatação aplicadas a um arquivo:

  1. Clique no ícone Paperclip. Para abrir o menu de arquivo.
  2. Clique no ícone Chave Inglesa. O ícone de chave inglesa à direita do arquivo.
  3. Ajuste as configurações na caixa de diálogo Configurações de Formato de Arquivo .
  4. Clique em Aplicar alterações para visualizar suas alterações.
  5. Clique em Salvar para manter suas alterações e fechar a caixa de diálogo.

Remover um arquivo

Arquivos enviados para um Agente Genie não têm período fixo de retenção. Eles permanecem disponíveis até que uma das seguintes situações aconteça:

  • O usuário remove o arquivo clicando no ícone Lixeira. O ícone de lixeira ao lado do arquivo no menu de arquivos anexados.
  • A conversa é deletada.
  • O Agente Gênio foi deletado. Arquivos são removidos automaticamente do armazenamento gerenciado quando o agente é excluído.

Uma lista de arquivos expandida mostrando um ícone de lixo à direita de um nome de arquivo.

Desabilitar uploads de arquivo

Um administrador de workspace pode impedir a capacidade de carregar arquivos em um agente do Genie. Para fazer isso, desative Carregar dados usando a interface do usuário. Consulte Desabilitar a interface do usuário de dados de upload.

perguntas frequentes

Quem pode acessar arquivos carregados?

Somente o usuário que carregou o arquivo pode acessá-lo.

Quais dados são enviados para o LLM?

Um subconjunto dos dados de arquivos carregados é enviado para o modelo externo e usado para melhorar a qualidade da resposta e analisar corretamente os arquivos.

Por que não posso carregar um arquivo?

Se você não tiver pelo menos permissões CAN RUN no Genie Agent, a opção de upload não estará disponível. O administrador do seu espaço de trabalho também pode ter desativado a configuração Fazer upload de dados usando a interface do usuário do espaço de trabalho ou desabilitado a versão prévia Genie - Upload File no seu espaço de trabalho. Consulte Desabilitar a interface do usuário de dados de upload.