Visão geral

O repositório de dados do Microsoft OneDrive para o Gemini Enterprise permite pesquisar e realizar ações nos seus arquivos e pastas.

Versões compatíveis do Microsoft OneDrive

O repositório de dados do Microsoft OneDrive é compatível com todas as versões hospedadas do Microsoft OneDrive pela API Microsoft Graph v1.0.

Ações permitidas

Quando o repositório de dados do Microsoft OneDrive está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar as seguintes ações.

Ação Descrição
Criar pasta Cria uma nova pasta em um caminho especificado no Microsoft OneDrive.
Copiar arquivo Copia um arquivo de uma origem para um destino no Microsoft OneDrive.
Fazer upload do arquivo Faz upload de um arquivo para um local especificado no Microsoft OneDrive.
Baixar o arquivo Baixa um arquivo do Microsoft OneDrive para um local especificado.

Permissões necessárias

Para permitir que o Gemini Enterprise realize pesquisas e ingestão de dados usando o repositório de dados do Microsoft OneDrive, você precisa das seguintes permissões:

Permissões da API Microsoft Graph

A tabela abaixo descreve as permissões necessárias para cada modo de conexão.

Observação:a tabela abaixo descreve as permissões necessárias para cada modo de conexão. Se você ativar Ações para o modo de conexão Pesquisa federada ou Ingestão de dados, selecione também as permissões listadas na linha Ações.

Modo de conexão Scope Purpose
Pesquisa federada Files.Read.All (Delegado) Permite que o repositório de dados leia todos os arquivos que o usuário pode acessar.
Sites.Read.All (Delegado) Permite que o repositório de dados leia documentos e liste itens em todas as coleções de sites que o usuário pode acessar.
User.Read.All (Delegado) Permite que o repositório de dados resolva locais de unidades de usuários para descoberta de conteúdo.
Ingestão de dados GroupMember.Read.All (Credenciais federadas e token de atualização do OAuth 2.0) Permite que o repositório de dados leia associações e propriedades básicas de grupos para todos os grupos sem um usuário conectado.
User.Read (Credenciais federadas e token de atualização do OAuth 2.0) Permite que o repositório de dados leia o perfil de usuários conectados. Também permite que o repositório de dados leia informações básicas da empresa de usuários conectados.
User.Read.All (Somente token de atualização do OAuth 2.0) Permite que o repositório de dados leia perfis de usuários.
Sites.FullControl.All (Opção 1)
Sites.Selected (Opção 2)		 (Credenciais federadas e token de atualização do OAuth 2.0) A opção 1 permite que o repositório de dados tenha controle total de todas as coleções de sites. A opção 2 permite que o repositório de dados acesse um subconjunto de coleções de sites. As coleções de sites específicas e as permissões concedidas podem ser configuradas no Microsoft OneDrive.
User.Read.All (Opção 1)
User.ReadBasic.All (Opção 2)		 (Somente credenciais federadas) A opção 1 permite que o repositório de dados leia perfis de usuários. A opção 2 permite que o repositório de dados leia um conjunto básico de propriedades de perfil de outros usuários na organização.
Ações Files.ReadWrite.AppFolder (Delegado) Permite que o repositório de dados leia, crie, atualize e exclua arquivos na pasta do Microsoft OneDrive.
Files.ReadWrite Delegado: permite que o repositório de dados leia, baixe, crie, faça upload, atualize e exclua os arquivos que o usuário pode acessar.

Para saber como adicionar as permissões do Microsoft OneDrive, consulte Configurar o Microsoft OneDrive e definir as permissões necessárias.

Limitações

Esta seção descreve problemas e limitações conhecidos que podem afetar o uso do repositório de dados do Microsoft OneDrive.

  • Ao criar um novo app ou adicionar um repositório de dados a um já existente, recomendamos associar apenas um repositório de dados a ações pertencentes a um único tipo de conector.
  • Não há suporte para a aplicação de um perímetro do VPC Service Controls em repositórios de dados do Microsoft OneDrive. Para aplicar o VPC Service Controls, exclua e recrie os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.
  • O repositório de dados do Microsoft OneDrive é compatível apenas com os locais global, us, e eu.

Confira a seguir as limitações do repositório de dados federado do Microsoft OneDrive:

  • Limitações de pesquisa: os resultados da pesquisa podem variar e nem sempre são abrangentes para todos os tipos de arquivo. O conteúdo em pastas arquivadas ou criptografadas pode não estar acessível para pesquisa. A pesquisa federada não oferece suporte à pesquisa em anexos.
  • Acesso delegado:o acesso a arquivos ou pastas compartilhados do Microsoft OneDrive pode exigir permissões específicas não cobertas pela autorização de usuário padrão.
  • Analisador de layout no modo de pesquisa federada:embora o analisador de layout seja padrão, a eficácia dele em PDFs complexos (com tabelas, layouts de várias colunas ou que precisam de OCR) é limitada no modo de pesquisa federada. As chamadas de API em tempo real desse modo podem não fornecer os dados completos ou o tempo necessário para a análise detalhada que o analisador de layout realiza durante a ingestão de dados.

  • Recursos de PDF não compatíveis:consequentemente, estruturas de PDF complexas podem não ser totalmente analisadas ou pesquisáveis. Isso inclui:

    • Layouts de texto de várias colunas
    • Dados em tabelas e gráficos incorporados
    • Texto em documentos digitalizados que exigem reconhecimento óptico de caracteres (OCR)
    • Documentos com ordens de leitura não lineares ou formatação complexa.

Confira a seguir as limitações do repositório de dados de ingestão do Microsoft OneDrive:

  • A sincronização incremental não detecta ações no nível da pasta, como Copiar, Mover ou Renomear.

Recomendação

Para dados do Microsoft OneDrive que contêm PDFs com recursos complexos (como tabelas, layouts de várias colunas ou conteúdo dependente de OCR), recomendamos usar o modo de ingestão de dados para uma pesquisa eficaz. Esse modo permite que o analisador de layout processe e indexe profundamente todo o conteúdo do documento.

A seguir