Com o conector do Microsoft OneDrive para Gemini Enterprise, você pode acessar o Microsoft OneDrive e interagir com seus arquivos e pastas.
Versões compatíveis do Microsoft OneDrive
O conector do Microsoft OneDrive é compatível com todas as versões hospedadas do Microsoft OneDrive pela API Microsoft Graph v1.0.
Ações compatíveis
Quando o conector 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 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 conector leia todos os arquivos que o usuário pode acessar. |
Sites.Read.All |
(Delegada) Permite que o conector 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 conector 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 conector leia o perfil de usuários conectados. Ele também permite que o conector 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 conector 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 conector tenha controle total de todas as coleções de sites. A opção 2 permite que o conector acesse um subconjunto de conjuntos 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 conector leia perfis de usuário. A opção 2 permite que o conector 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 conector leia, crie, atualize e exclua arquivos na pasta do Microsoft OneDrive. |
Files.ReadWrite |
(Delegada) Permite que o conector 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
Esta seção descreve problemas e limitações conhecidos que podem afetar seu uso do conector do Microsoft OneDrive.
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 serviço, consulte Proteger seu app com o VPC Service Controls.
O repositório de dados do Microsoft OneDrive está disponível apenas em locais globais, nos EUA e na UE.
Ao criar um novo aplicativo ou adicionar um repositório de dados a um aplicativo existente, recomendamos que você adicione um repositório de dados com ações pertencentes a um único tipo de conector. Por exemplo, não associe dois repositórios de dados do Microsoft OneDrive com ações ativadas ao mesmo aplicativo.
Confira as limitações do conector 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 conector 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
- Para criar e configurar um conector com o Microsoft OneDrive, consulte Configurar um repositório de dados do Microsoft OneDrive.