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 e imagens. Um autor de agente anexa um ou mais volumes, e os usuários de negócios fazem perguntas sobre seu conteúdo junto com os dados estruturados do agente em uma única conversa.
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.
Genie Agents eram anteriormente conhecidos como Genie Spaces.
Visão geral
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?
Para misturar um arquivo CSV ou Excel local em uma única conversa, em vez de analisar arquivos armazenados em volumes, consulte Fazer upload de um arquivo para um Genie Agent.
Como funciona
Quando um usuário faz uma pergunta que requer contexto de um volume, o Genie Agent recupera os arquivos mais relevantes para a pergunta, os analisa e adiciona seu conteúdo ao contexto do agente. O agente então raciocina sobre esse conteúdo junto com quaisquer dados estruturados para gerar uma resposta com citações.
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
Antes de anexar volumes, confirme se você atende aos requisitos nesta seção.
Requisitos gerais
Os seguintes requisitos aplicam-se ao agente e aos seus usuários:
- Unity Catalog habilitado em seu workspace.
- Gateway de AI (Beta) habilitado.
- Modo agente disponível em sua região. Consulte Disponibilidade regional.
- Um Genie Agent bem preparado com instruções claras e metadados de tabela. Consulte Crie um Genie Agent eficaz.
- Um ou mais volumes do Unity Catalog que contêm arquivos relevantes.
- Ambos os direitos de acesso ao Workspace e acesso ao Databricks SQL para cada usuário do agente. Os usuários podem usar o restante do Genie sem acesso ao Workspace , mas este recurso exige ambos. Consulte Gerenciar direitos.
- Pelo menos a permissão
READ VOLUMEnos volumes anexados para cada usuário do agente.
Requisitos do volume
Os seguintes limites se aplicam aos volumes e arquivos que você anexa:
- Você pode anexar no máximo 10 volumes a um Genie Agent.
- Cada volume pode conter até 500 arquivos no total. Arquivos TXT e MD não contam para esse limite. Consultas direcionadas a volumes com mais de 500 arquivos retornarão um erro.
- Os arquivos devem ser de um dos seguintes tipos: PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT ou PPTX. O Genie Agent ignora tipos de arquivo incompatíveis.
- O Genie Agent ignora arquivos maiores que 10 MB e continua a responder a perguntas usando os outros arquivos compatíveis no volume.
Anexar volumes a um Genie Agent
Antes de começar, revise os Requisitos.
Para anexar volumes a um Genie Agent:
- Abra o Genie Agent ao qual você deseja adicionar arquivos.
- Abra a tab Fontes e clique em Adicionar .
- 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.
- Adicione uma descrição clara no campo Descrição . Consulte Otimize seu agente para perguntas sobre arquivos.
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:
- Abra um Genie Agent que tenha volumes anexados.
- O Modo agente deve ser ativado na caixa de bate-papo. É necessário usar o Modo agente para responder a perguntas sobre arquivos.
- 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.
Restrinja suas perguntas a um pequeno número de arquivos. Durante a versão Beta, um Genie Agent pode recuperar contexto de até 5 arquivos por pergunta. Para obter uma resposta precisa, faça perguntas que um pequeno e relevante conjunto de arquivos possa responder.
Funciona bem | Não funciona bem |
|---|---|
"Quais foram as principais descobertas dos relatórios financeiros do 1º e 2º trimestres?" | "Resumir as percepções do cliente em todos os 500 arquivos neste volume." |
"Compare os detalhes de preços nestes dois contratos." | "Encontre cada menção de rotatividade de clientes em todos os relatórios de ganhos/perdas." |
Limitações
Aplicam-se as seguintes limitações durante a versão Beta:
- Este recurso não está disponível no AWS GovCloud.
- Usuários apenas consumidores, apenas Databricks SQL e apenas de conta não podem usar este recurso. Todo usuário do agente deve ter os direitos de acesso ao Workspace e acesso ao Databricks SQL .
- Um Genie Agent pode recuperar contexto de até 5 arquivos por pergunta.
- O Genie Agent não pode analisar arquivos externos, como arquivos no Google Drive ou SharePoint.
- As ferramentas de busca na web não estão disponíveis.
Perguntas Frequentes
As perguntas a seguir abordam tópicos comuns para analisar arquivos em volumes.
Como este recurso é cobrado?
Quando um usuário faz uma pergunta, o Genie Agent primeiro recupera e processa os arquivos relevantes. Isso gera custos de Foundation Model Serving (pagamento por token), cobrados sob o SKU de Inferência Serverless em tempo real. Consulte os preços da Model Serving. O agente então raciocina sobre o conteúdo recuperado, o que é cobrado como parte do uso padrão do Genie. Consulte preços do Genie.
Quando devo usar este recurso em vez de um Supervisor Multiagente?
Anexe volumes a um Genie Agent quando você quiser que um agente responda a perguntas em dados estruturados e não estruturados dentro de um domínio específico. Crie um agente supervisor personalizado apenas quando precisar de controle refinado sobre o comportamento do agente, como seleção de modelo, estratégia de agrupamento ou orquestração de múltiplos subagentes.
Quando devo usar este recurso em vez do Genie One?
Anexe volumes a um Genie Agent quando você deseja criar um agente especializado que responde a perguntas em um domínio específico. 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.
É possível analisar arquivos em volumes por meio da API?
Sim. É possível analisar arquivos em volumes através das APIs do modo de Agente. Consulte as APIs do modo de Agente no Genie Agents.
Recursos adicionais
Consulte os seguintes recursos para obter informações relacionadas: