Visão geral

Com o repositório de dados do Microsoft OneDrive para o Gemini Enterprise, você pode acessar o Microsoft OneDrive e interagir com 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 pasta em um caminho especificado no Microsoft OneDrive.
Copiar arquivo Copia um arquivo de uma origem para um destino no Microsoft OneDrive.

Permissões necessárias

Para permitir que o Gemini Enterprise faça 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 a seguir descreve as permissões necessárias para cada modo de conexão. Se você ativar as 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 (Delegada) Permite que o repositório de dados leia todos os arquivos que o usuário pode acessar.
Sites.Read.All (Delegada) Permite que o repositório de dados leia documentos e liste itens em todas as coleções de sites a que o usuário tem acesso.
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 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. Ele 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 os perfis de usuário. 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 (Delegada) Permite que o repositório de dados leia, crie, atualize e exclua arquivos na pasta do Microsoft OneDrive.
Files.ReadWrite (Delegada) Permite que o repositório de dados leia, crie, atualize e exclua os arquivos a que o usuário tem acesso.

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

Limitações

Nesta seção, descrevemos problemas e limitações conhecidos que podem afetar seu uso do repositório de dados do Microsoft OneDrive.

  • Ao criar um aplicativo ou adicionar um repositório de dados a um já existente, recomendamos adicionar apenas um repositório com ações pertencentes a um único tipo de conector, independente do modo de conexão. Por exemplo, não associe dois repositórios de dados do Microsoft OneDrive com ações ativadas ao mesmo aplicativo.
  • Não é possível aplicar um perímetro do VPC Service Controls aos repositórios de dados do Microsoft OneDrive. Para aplicar o VPC Service Controls, é necessário excluir e recriar 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 só é compatível com as regiões Global, US e EU.

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

  • Limitações da 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 é compatível com a 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 padrão do usuário.

Confira 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.

A seguir