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

Analisar arquivos em volumes com um Genie Agent

Um Genie Agent pode analisar os arquivos não estruturados armazenados em volumes do Unity Catalog, como PDFs, documentos do Word, apresentações de slides e imagens. Um autor de agente anexa volumes ao agente, e os usuários de negócios fazem perguntas sobre o conteúdo deles juntamente com os dados estruturados do agente em uma única conversa.

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador de workspace deve ativar Analisar arquivos em volumes com Genie Agents na página Pré-visualizações . Consulte Gerenciar pré-visualizações do Databricks.

nota

Genie Agents eram anteriormente conhecidos como Genie Spaces.

O que você pode perguntar a um Genie Agent sobre seus arquivos​

Ao anexar volumes a um agente, os usuários de negócios podem combinar dados de documentos, como tickets de suporte, logs de chamadas de vendas e arquivos de política, com dados das tabelas estruturadas do agente. Os usuários podem, então, responder a perguntas como:

  • Quais problemas de suporte estão demorando mais para serem resolvidos e o que os clientes estão dizendo nas solicitações de escalonamento?
  • Por que as oportunidades de vendas em estágio avançado estão paralisadas e quais objeções aparecem com mais frequência nos logs de chamadas de vendas?
  • Quais regiões estão com desempenho inferior e quais políticas internas de escalonamento se aplicam?

Quando usar a análise de arquivos em um Genie Agent​

Anexe volumes a um Genie Agent quando quiser um agente especializado para um domínio específico. Escolha uma abordagem diferente quando suas necessidades forem mais amplas:

  • Use Genie One como um ponto de entrada unificado para todas as perguntas sobre seus dados estruturados. O Genie One pode chamar um Genie Agent para responder a perguntas sobre arquivos.
  • Crie um Multi-Agent Supervisor personalizado apenas quando precisar de controle refinado sobre o comportamento do agente, como seleção de modelo, estratégia de agrupamento (chunking) ou orquestração de múltiplos subagentes.
  • Use file upload para mesclar um arquivo CSV ou Excel local em uma única conversa, em vez de analisar arquivos armazenados em volumes.

Como um Genie Agent analisa arquivos​

Quando um usuário faz uma pergunta que exige contexto de um volume, o Genie Agent recupera o conteúdo do arquivo que é mais relevante para a pergunta e o adiciona ao contexto do agente. Em seguida, o agente raciocina sobre esse conteúdo junto com quaisquer dados estruturados para gerar uma resposta com citações. Essas citações podem apontar para a página específica do arquivo de origem (Beta).

A análise de arquivos é executada apenas no modo Agente, que usa raciocínio em múltiplas etapas para recuperar e analisar os arquivos relevantes. Consulte Modo Agente.

O Genie Agent sempre usa as permissões do usuário que faz a pergunta. Um usuário que não tenha pelo menos a permissão READ VOLUME em um volume anexado recebe um erro. Os usuários podem fazer perguntas em um volume específico, em vários volumes e em dados estruturados na mesma conversa.

Requisitos​

Os seguintes requisitos aplicam-se ao agente e aos seus usuários:

Anexar volumes a um Genie Agent​

Antes de começar, revise os Requisitos.

Para anexar volumes a um Genie Agent:

  1. Abra o Genie Agent ao qual você deseja adicionar arquivos.
  2. Abra a tab Fontes e clique em Adicionar .
  3. Selecione um ou mais volumes. O Genie Agent processa o volume inteiro. Não é possível anexar um subconjunto de pastas ou arquivos em um volume.
  4. Adicione uma descrição clara no campo Descrição . Consulte Otimize seu agente para perguntas sobre arquivos.

Você pode anexar um volume como fonte mesmo quando o catálogo dele não estiver acessível a partir deste workspace por default, como um catálogo vinculado a workspaces específicos.

Quando você anexa um volume, o Databricks ativa automaticamente a busca de conteúdo.

Como funciona a pesquisa de conteúdo​

A pesquisa de conteúdo analisa e indexa seus arquivos para que o Genie Agent possa raciocinar sobre um conjunto maior de arquivos, utilizar passagens específicas em vários arquivos e responder a perguntas com menor latência. Para obter limites de arquivos e volumes, consulte Limitations.

A pesquisa de conteúdo permanece sincronizada com o seu volume automaticamente. Quando você adiciona, altera ou remove arquivos, o Databricks atualiza o índice para refletir suas alterações, de modo que o Genie Agent raciocina sobre o conteúdo atual sem nenhum o passo manual.

Otimize seu agente para perguntas sobre arquivos​

Depois de anexar seus volumes, siga estas recomendações para ajudar o Genie Agent a usar o conteúdo deles:

  • Adicione uma descrição clara : Descreva qual conteúdo o volume contém, como ele está organizado e como o agente deve usá-lo. O agente usa esta descrição para recuperar arquivos relevantes.
  • Evite conteúdo duplicado : Anexar vários volumes que contêm informações sobrepostas torna mais difícil para o agente recuperar documentos relevantes. O mesmo se aplica a arquivos individuais em um volume.
  • Evite arquivos irrelevantes : Inclua apenas arquivos que são relevantes para o domínio do agente. Arquivos irrelevantes podem confundir o agente.
  • **Use nomes de arquivo claros**: Use nomes de arquivo descritivos para que o agente possa distinguir entre arquivos.

Faça perguntas sobre arquivos​

Para fazer perguntas sobre arquivos em um Genie Agent:

  1. Abra um Genie Agent que tenha volumes anexados.
  2. O Modo agente deve ser ativado na caixa de bate-papo. É necessário usar o Modo agente para responder a perguntas sobre arquivos.
  3. Insira uma pergunta e envie seu prompt. O modo de agente recupera o contexto do volume relevante e, em seguida, gera uma resposta após a conclusão da análise.

Regiões compatíveis com a pesquisa de conteúdo​

A pesquisa de conteúdo está disponível nas regiões listadas nesta seção.

Em algumas regiões, a pesquisa de conteúdo entra em execução apenas se um administrador de account habilitar o processamento cross-Geo, o que permite que o Databricks processe seus arquivos fora do Geo do Workspace. Consulte Ativar o processamento cross-Geo.

Regiões que não exigem processamento cross-Geo​

A execução da pesquisa de conteúdo ocorre na região do seu workspace para as seguintes regiões:

  • us-central1 (Iowa)
  • us-east4 (Virgínia)

Regiões que exigem processamento cross-geo​

Para as seguintes regiões, um account admin deve habilitar o processamento cross-Geo antes que as execuções de pesquisa de conteúdo ocorram:

  • europe-west3 (Frankfurt)

Limitações​

Aplicam-se as seguintes limitações:

  • Você pode anexar no máximo 10 volumes a um Genie Agent.

  • Para usar conteúdo de fontes externas, como o Google Drive ou o SharePoint, anexe conectores MCP em vez disso. Consulte Conectar um Genie Agent a ferramentas e fontes externas.

  • Todo usuário do agente deve ter os direitos de Workspace access e Databricks SQL access . Consulte Access entitlements.

  • Durante a versão beta, os usuários apenas com account não podem usar esse recurso. Consulte Acesso de usuário apenas com account ao Genie One.

  • Somente os volumes gerenciados pelo Unity Catalog oferecem suporte à pesquisa de conteúdo. Volumes externos e volumes do My Files não são compatíveis. Consulte Armazenar arquivos em Meus Arquivos.

  • Cada workspace pode ter até 250 volumes anexados a Genie Agents.

  • Cada volume indexado pode conter até 10.000 arquivos.

  • A pesquisa de conteúdo ignora arquivos com mais de 100 MB e arquivos com mais de 500 páginas.

  • A pesquisa de conteúdo é compatível com arquivos PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT, PPTX, MD ou TXT. Todos os outros tipos de arquivo são ignorados.

Perguntas Frequentes​

As perguntas a seguir abordam tópicos comuns para analisar arquivos em volumes.

Como este recurso é cobrado?​

A Databricks cobra pelo seguinte:

  • Como preparar arquivos : Quando a Databricks ativa a pesquisa de conteúdo ou sincroniza um volume, ela faz o parsing dos seus arquivos com a função de AI ai_parse_document, que é cobrada em AI Functions preços.
  • Como responder a perguntas : O raciocínio do agente sobre os seus arquivos é cobrado como parte do uso padrão do Genie. Consulte Genie preços.

É possível analisar arquivos em volumes por meio da API?​

Sim. Você pode analisar arquivos em volumes por meio das APIs do modo Agente. Consulte a referência da API do modo Agente.

Recursos adicionais​

Consulte os seguintes recursos para obter informações relacionadas:

Nesta página