Pular para o conteúdo principal
Última atualização em

Faça o upload de um arquivo para um Genie Agent

info

Visualização

O carregamento de arquivos CSV e Excel está em Pré-visualização Pública. O recurso de upload de arquivos PDF está em versão beta.

Faça upload de arquivos CSV, Excel e PDF diretamente em um Genie Agent para que os usuários possam consultá-los em linguagem natural juntamente com tabelas do Unity Catalog. Isso é útil para validação rápida de dados, análise leve e para trabalhar com datasets externos sem importação ou transformação manual.

nota

Genie Agents eram anteriormente conhecidos como Genie Spaces.

Visão geral​

Carregar arquivos em um Genie Agent permite explorar dados em uma conversa do Genie Agent. É possível adicionar arquivos a agentes que também incluem tabelas do Unity Catalog, possibilitando a análise de dados carregados juntamente com as fontes existentes. Em vez de importar e transformar datasets manualmente, é possível 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 datasets externos sem configuração adicional.

Requisitos​

  • Genie Agents devem ser habilitados em seu workspace. Consulte Criar e gerenciar um Genie Agent.

  • A configuração de administrador do workspace **Upload de dados usando a IU** deve estar habilitada. Consulte Desabilitar a IU de upload de dados.

  • O administrador workspace deve ativar a pré-visualização na página de Pré-visualizações. Use a opção Genie - Carregar arquivo" para gerenciar o acesso.

  • Para fazer upload de arquivos PDF (Beta), um administrador do workspace deve habilitar a opção **Fazer upload de PDFs locais para Genie Agents** na página Pré-visualizações. Aplicam-se os seguintes requisitos adicionais:

    • O recurso parceiros-Powered AI deve estar habilitado. Veja recurso AI com tecnologia de parceiros.
    • O carregamento de PDFs não é suportado no espaço de trabalho do perfil de segurança compliance .

  • Pelo menos permissões CAN RUN no Genie Agent. Consulte ACLs do Genie Agent.

Requisitos do arquivo​

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

Arquivos CSV e Excel​

O carregamento de arquivos CSV e Excel não está disponível no modo Agente.

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

Arquivos PDF​

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

O envio de PDFs requer o modo Agente.

  • Cada arquivo PDF deve ter menos de 20 MB.
  • Cada arquivo PDF não deve conter mais de 20 páginas.
  • Cada PDF é limitado a 4.000 caracteres.
  • O envio de PDFs aplica-se apenas à conversa atual. As novas conversas de bate-papo não incluem o contexto dos PDFs enviados anteriormente.
  • O envio de PDFs está disponível apenas através da interface do usuário. O envio de arquivos via API não é suportado.

carregar um arquivo​

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

Envie os arquivos de uma das seguintes maneiras:

  • Arraste e solte o arquivo na janela de bate-papo.
  • Clique Ícone de clipe de papel. para selecionar um arquivo do seu navegador de arquivos.

Um Genie Agent exibe o ícone de clipe.

Após o arquivo ser carregado e processado, o Genie exibe os dados na resposta. É possível fazer perguntas sobre o arquivo carregado e quaisquer outros dados no Genie Agent.

nota

Arquivos carregados são armazenados em um volume gerenciado do Unity Catalog específico do usuário e do agente. O volume não pode ser listado 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 em seus arquivos carregados.

Para obter mais informações sobre como gerenciar volumes, consulte O que são volumes Unity Catalog?

visualizar arquivos disponíveis​

Para ver os arquivos que foram carregados no agente, clique em Ícone de clipe de papel. para abrir o menu de arquivos. Se um arquivo Excel carregado tiver várias planilhas, elas aparecerão como arquivos separados no menu.

Ajustar as configurações de formato de arquivo​

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

  1. Clique Ícone de clipe de papel. para abrir o menu do arquivo.
  2. Clique Ícone de chave inglesa. no í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​

Para remover um arquivo e seu registro de conversa associado, exclua a conversa.

Para remover somente o arquivo, clique no ícone Ícone de lixo. da lixeira ao lado do arquivo no menu de arquivos anexados.

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

nota

Se o Genie Agent for excluído, o arquivo será automaticamente removido do armazenamento gerenciado.

Desativar upload de arquivos​

Um administrador do workspace pode impedir o upload de arquivos para um Genie Agent. Para fazer isso, desative Upload de dados com a UI . Consulte Desativar a IU de upload de dados.

PERGUNTAS FREQUENTES​

Quem pode acessar os arquivos de upload?​

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

Quais dados são enviados para o LLM?​

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

Por que não consigo fazer upload de 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 workspace também pode ter desativado a configuração do workspace **Upload de dados usando a IU** ou desativado a pré-visualização **Genie - Upload de arquivos** para o seu workspace. Consulte Desativar a IU de upload de dados.

Se você estiver recebendo a mensagem de erro Não foi possível preparar o volume para o upload do arquivo , o administrador do workspace pode precisar resolver um conflito de local de armazenamento. Consulte Resolver conflitos de caminhos de armazenamento.

Nesta página