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 até 10 volumes, e os usuários corporativos fazem perguntas sobre seu conteúdo juntamente 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.
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?
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 um Genie Agent analisa arquivos
Quando um usuário faz uma pergunta que requer 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. 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
Os seguintes requisitos aplicam-se ao agente e aos seus usuários:
- Unity Catalog habilitado em seu workspace.
- 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.
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.
- Opcionalmente, habilite a pesquisa de conteúdo para os volumes que você anexou. Consulte Habilitar pesquisa de conteúdo para volumes anexados.
Habilitar pesquisa de conteúdo para volumes anexados
O Databricks recomenda habilitar a pesquisa de conteúdo para os volumes que você anexar. A pesquisa de conteúdo prepara e indexa seus arquivos para que o Genie Agent possa usá-los com mais eficácia, o que melhora sua capacidade de raciocinar sobre um conjunto maior de arquivos e responder a perguntas com menor latência. Um volume indexado pode conter até 10.000 arquivos de até 50 MB cada. Consulte Pesquisa de conteúdo para volumes do Unity Catalog.
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.
Limitações
Aplicam-se as seguintes limitações:
- Você pode anexar no máximo 10 volumes a um Genie Agent.
- 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 .
- Em volumes que não têm a pesquisa de conteúdo ativada, um Genie Agent pode recuperar contexto de até 5 arquivos por pergunta. Consulte Limitações para volumes sem pesquisa de conteúdo.
- 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.
Limitações para volumes sem pesquisa de conteúdo
O Databricks recomenda habilitar a pesquisa de conteúdo nos volumes que você anexar. Se você não habilitar a pesquisa de conteúdo para um volume anexado, um Genie Agent poderá recuperar contexto de até 5 arquivos por pergunta. Além disso, aplicam-se os seguintes limites aos arquivos que ele pode ler:
Propriedade | Limite |
|---|---|
Total de arquivos por volume | Até 500 arquivos. Arquivos TXT e MD não contam para este limite. Perguntas direcionadas a volumes com mais de 500 arquivos retornam um erro. |
Tipos de arquivo aceitos | PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT ou PPTX |
Tamanho máximo de arquivo | Até 10 MB |
O Genie Agent ignora tipos de arquivo não suportados e arquivos que excedem o tamanho máximo de arquivo. Ele continua a responder perguntas usando os outros arquivos suportados no volume.
Perguntas Frequentes
As perguntas a seguir abordam tópicos comuns para analisar arquivos em volumes.
Como este recurso é cobrado?
A cobrança depende se o volume anexado tem a pesquisa de conteúdo ativada. Em ambos os casos, o agente raciocina sobre o conteúdo recuperado, que é cobrado como parte do uso padrão do Genie. Consulte os preços do Genie.
- Volumes sem pesquisa de conteúdo : durante a versão Beta, os usuários são cobrados apenas pelo raciocínio do agente sobre o conteúdo recuperado.
- Volumes com pesquisa de conteúdo : o agente consulta o índice existente em vez de analisar arquivos no momento da consulta, portanto, não se aplicam custos de Foundation Model Serving à recuperação. Em vez disso, aplicam-se custos de ingestão e de consulta (query-serving). Consulte Como a pesquisa de conteúdo é cobrada.
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: