Carregar um ficheiro para um Agente Genie

Importante

O carregamento de ficheiros CSV e Excel é feito em Pré-visualização pública. O carregamento de ficheiros PDF está em Beta.

Carregue ficheiros CSV, Excel e PDF diretamente para um Agente Genie para que os utilizadores possam consultá-los em linguagem natural juntamente com tabelas do Unity Catalog. Isto é ú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 Génio eram anteriormente conhecidos como Espaços Génio.

Overview

Carregar ficheiros para um Agente Genie permite-lhe explorar dados numa conversa com um Agente Genie. Pode adicionar ficheiros a agentes que também incluem tabelas do Catálogo Unity, tornando possível analisar dados carregados juntamente 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 a perguntas entre ficheiros não estruturados armazenados em volumes do Catálogo Unity em vez de carregar um ficheiro para uma única conversa, consulte Analisar ficheiros em volumes com um Agente Genie.

Requirements

  • Os Agentes Génio devem estar ativados no seu espaço de trabalho. Veja Criar e gerir um Agente Génio.
  • A definição de administrador do espaço de trabalho Carregar dados através da IU deve estar ativada. Consulte Desativar a interface de carregamento de dados.
  • Um administrador de espaço de trabalho deve ativar a pré-visualização na página Visualizações. Use a opção Genie - Upload File para gerir o acesso.
  • Para carregar ficheiros PDF (Beta), um administrador de espaço de trabalho deve ativar a opção Carregar PDFs Locais para Agentes Genie a partir da página de Pré-visualizações. Aplicam-se os seguintes requisitos adicionais:
  • Pelo menos PODE EXECUTAR permissões no Agente Génio. Consulte as ACLs do Genie Agent.

Requisitos aplicáveis aos ficheiros

Podes carregar até 25 ficheiros por conversa, independentemente do tipo de ficheiro.

Ficheiros CSV e Excel

Uploads CSV e Excel não estão disponíveis no modo Agente.

  • Cada ficheiro tem de ter menos de 200 MB.
  • Cada arquivo deve conter menos de 100 colunas.
  • Os ficheiros Excel podem conter várias folhas. O Genie exibe dados de amostra da primeira planilha por padrão, mas todas as planilhas que podem ser analisadas estão disponíveis. Para consultar uma folha específica, refira-se a ela pelo nome ao perguntar ao Genie.

Ficheiros PDF

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Os uploads de PDF requerem o modo Agente.

  • Cada PDF deve ter menos de 20 MB.
  • Cada PDF deve conter no máximo 20 páginas.
  • Cada PDF está limitado a 15.000 caracteres.
  • Os PDFs carregados aplicam-se apenas à conversa atual. Novos tópicos de chat não incluem contexto de PDFs previamente carregados.
  • Os carregamentos em PDF só estão disponíveis através da interface. O carregamento de ficheiros baseado em API não é suportado.

Carregar um ficheiro

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

Carregue ficheiros de uma das seguintes formas:

  • Arraste e solte o arquivo na janela de chat.
  • Clique no ícone Clipe de papel para selecionar um arquivo do navegador de arquivos.

Um Agente Génio mostra o ícone do clipe de papel.

Carregar um ficheiro deixa de enviar uma mensagem automaticamente. Podes adicionar um prompt para enviar com o ficheiro, ou carregar o ficheiro e depois fazer perguntas sobre ele. Depois que o arquivo é carregado e processado, o Genie exibe os dados na resposta. Pode fazer perguntas sobre o ficheiro carregado e quaisquer outros dados no Agente Genie.

Note

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

O Azure Databricks armazena ficheiros carregados em armazenamento root gerido 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 Unity?.

Ver ficheiros disponíveis

Para ver os ficheiros que foram carregados para o agente, clique no ícone Paperclip para abrir o menu de ficheiros. Se um ficheiro Excel carregado tiver várias folhas, elas aparecem como ficheiros separados no menu.

Ajustar as definições de formato de ficheiro

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

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

Remover um ficheiro

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

  • O utilizador remove o ficheiro clicando no ícone Lixo. O ícone de lixo ao lado do ficheiro no menu Ficheiros Anexados.
  • A conversa é apagada.
  • O Agente Génio é eliminado. Os ficheiros são automaticamente removidos do armazenamento gerido quando o agente é eliminado.

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

Desativar carregamentos de ficheiros

Um administrador de espaço de trabalho pode impedir a possibilidade de carregar ficheiros para um Agente Genie. Para fazer isso, desative Carregar dados usando a interface do usuário. Consulte Desativar a interface de carregamento de dados.

FAQ

Quem pode aceder aos ficheiros carregados?

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

Que dados são enviados para o LLM?

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

Por que não consigo carregar um arquivo?

Se não tiver pelo menos permissões CAN RUN no Agente Genie, a opção de upload não está disponível. O administrador do seu espaço de trabalho também pode ter desativado a definição do espaço de trabalho Carregar dados através da IU ou desativado a pré-visualização Genie - Upload File para o seu espaço de trabalho. Consulte Desativar a interface de carregamento de dados.