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

Faça upload de um arquivo para um Genie Agent

info

Visualização

O upload de arquivos CSV e Excel está em Visualização Pública. O upload de arquivos PDF está em 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 junto com as 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

Os Genie Agents eram anteriormente conhecidos como Genie space.

Visão geral​

Fazer upload de arquivos para um Genie Agent permite explorar dados em uma conversa com o Genie Agent. É possível adicionar arquivos a agentes que também incluem tabelas do Unity Catalog, o que torna possível analisar dados de uploads juntamente com 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 trabalhar com datasets externos sem configuração adicional.

Requisitos​

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

  • A configuração de administrador do Workspace Upload de dados com a UI deve ser habilitada. Consulte Desabilitar a UI de upload de dados.

  • Um administrador do Workspace deve habilitar a prévia na página de Prévias. Use a alternância **Genie - Upload de Arquivo** para gerenciar o acesso.

  • Para fazer upload de arquivos PDF (Beta), um administrador de workspace deve habilitar a alternância **Upload de PDFs Locais para Genie Agents** na página de Pré-visualizações. Aplicam-se os seguintes requisitos adicionais:

    • Os recursos de AI com tecnologia de parceiros devem ser habilitados. Consulte Recursos de AI com tecnologia de parceiros.
    • Uploads de PDF não são suportados em workspaces com perfil de segurança de compliance.

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

Requisitos do arquivo​

É possível fazer o upload de até 25 arquivos por conversa, independentemente do tipo de arquivo.

Arquivos CSV e Excel​

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

  • Cada arquivo deve ser menor que 200 MB.
  • Cada arquivo deve conter menos de 100 colunas.
  • Arquivos Excel podem conter várias planilhas. O Genie exibe dados de exemplo da primeira planilha por default, mas todas as planilhas que podem ser analisadas estão disponíveis. Para fazer query em uma planilha específica, referencie-a pelo nome ao perguntar ao Genie.

Arquivos PDF​

info

Beta

Esse recurso está em Beta. Administradores do Workspace podem controlar o acesso a este recurso na página **Pré-visualizações**. Consulte Gerenciar prévias do Databricks.

Uploads de PDF exigem o modo Agente.

  • Cada PDF deve ter menos de 20 MB.
  • Cada PDF não deve conter mais de 20 páginas.
  • Cada PDF é limitado a 4.000 caracteres.
  • Os PDFs enviados se aplicam apenas à conversa atual. Os tópicos de novo bate-papo não incluem contexto de PDFs de upload anteriormente.
  • Os uploads de PDF estão disponíveis apenas através da UI. Uploads de ficheiros baseados em API não são suportados.

upload um arquivo​

Apenas o usuário que fez upload do arquivo pode acessá-lo.

Faça upload de arquivos de uma das seguintes maneiras:

  • Arraste e solte o arquivo na janela de chat.
  • Clique em Ícone de clipe de papel. para selecionar um arquivo no seu navegador de arquivos.

Um Genie Agent mostra o ícone de clipe de papel.

Após o upload e processamento do arquivo, o Genie exibe os dados na resposta. Você pode fazer perguntas sobre o arquivo de upload e quaisquer outros dados no Genie Agent.

nota

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

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

Visualizar arquivos disponíveis​

Para visualizar arquivos que foram **upload** para o agente, clique em Ícone de clipe de papel. para abrir o menu de arquivos. Se um arquivo Excel upload 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 em Ícone de clipe de papel. para abrir o menu de arquivos.
  2. Clique no ícone de chave inglesa Ícone de chave inglesa. à direita do arquivo.
  3. Ajuste as configurações no 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 apenas o arquivo, clique em Ícone da lixeira. no ícone da lixeira ao lado do arquivo no menu de arquivos anexados.

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

nota

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

Desativar uploads de arquivos​

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

Perguntas frequentes​

Quem pode acessar os upload files?​

Apenas o usuário que fez upload do arquivo pode acessá-lo.

Que dados são enviados ao LLM?​

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

Por que não consigo fazer upload de um arquivo?​

Se você não tiver pelo menos permissões de CAN RUN no Genie Agent, a opção de upload não estará disponível. Seu administrador do Workspace também pode ter desativado a configuração do Workspace de Upload de dados usando a IU ou desativado a visualização Genie - Upload de Arquivo para 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 de arquivos**, o administrador do seu workspace pode precisar resolver um conflito de local de armazenamento. Consulte Resolver conflitos de caminho de armazenamento.

Nesta página