O repositório de dados do Microsoft SharePoint para o Gemini Enterprise oferece acesso aos seus dados do Microsoft SharePoint Online, permitindo que você interaja com seus documentos, listas e sites.
Versões compatíveis do Microsoft SharePoint
O repositório de dados do Microsoft SharePoint é compatível com a versão mais recente do Microsoft SharePoint Online na nuvem.
Ações permitidas
Quando o repositório de dados do Microsoft SharePoint está ativado, os usuários finais podem usar comandos em linguagem natural no Gemini Enterprise para realizar as seguintes ações:
| Ação | Descrição |
|---|---|
| Criar pasta | Cria uma pasta em um caminho especificado. |
| Adicionar lista | Crie uma lista de dados estruturados (por exemplo, tarefas, contatos) no site do Microsoft SharePoint. |
| Fazer upload do documento | Fazer upload de um novo documento para um site especificado do Microsoft SharePoint. |
| Fazer download do documento | Baixe um documento de um site especificado do Microsoft SharePoint. |
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 SharePoint, 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 | N/A | Não são necessárias permissões da API Graph. |
| 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. Os conjuntos de sites específicos e as permissões concedidas podem ser configurados no SharePoint Online. | |
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 | Sites.ReadWrite.All |
(Pesquisa federada e ingestão de dados) Permite que o repositório de dados edite ou exclua documentos e itens de lista em todas as coleções de sites em nome do usuário conectado. |
Files.ReadWrite |
Permite que o repositório de dados leia, crie, atualize e exclua os arquivos do usuário conectado. | |
Files.ReadWrite.All |
Permite que o repositório de dados leia, crie, atualize e exclua todos os arquivos a que o usuário conectado tem acesso. | |
Sites.Manage.All |
Permite que o repositório de dados crie ou exclua bibliotecas de documentos e listas em todas as coleções de sites em nome do usuário. |
Permissões da API do Microsoft SharePoint
A tabela abaixo descreve as permissões necessárias para cada modo de conexão.
| Modo de conexão | Scope | Purpose |
|---|---|---|
| Pesquisa federada | Sites.Search.All (delegada) |
Permite que o repositório de dados execute consultas de pesquisa e leia informações básicas do site em nome do usuário conectado no momento. Os resultados da pesquisa são baseados nas permissões do usuário, e não nas do app. |
AllSites.Read (opção 1, delegada) |
Permite que o repositório de dados leia documentos e liste itens em todas as coleções de sites em nome do usuário conectado. | |
Sites.Selected (opção 2, delegada) |
Permite que o repositório de dados acesse um subconjunto de coleções de sites com um usuário conectado. Os conjuntos de sites específicos e as permissões concedidas podem ser configurados no SharePoint Online. | |
| Ingestão de dados (credenciais federadas) | Sites.FullControl.All (opção 1, aplicativo) |
Permite que o repositório de dados tenha controle total de todas as coleções de sites. |
Sites.Selected (opção 2, aplicativo) |
Permite que o repositório de dados acesse um subconjunto de coleções de sites com um usuário conectado. Os conjuntos de sites específicos e as permissões concedidas podem ser configurados no SharePoint Online. | |
| Ingestão de dados (token de atualização do OAuth 2.0) | AllSites.FullControl (opção 1, delegada) |
Permite que o repositório de dados tenha controle total de todas as coleções de sites em nome do usuário conectado. |
Sites.Selected (opção 2, delegada) |
Permite que o repositório de dados acesse um subconjunto de coleções de sites com um usuário conectado. Os conjuntos de sites específicos e as permissões concedidas podem ser configurados no SharePoint Online. | |
| Ações | AllSites.Write (delegada) |
Permite que o repositório de dados crie, leia, atualize e exclua documentos e itens de lista em todas as coleções de sites em nome do usuário conectado. |
Para saber como adicionar as permissões do Microsoft SharePoint, consulte Configurar o Microsoft SharePoint 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 SharePoint.
- 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 SharePoint com ações ativadas ao mesmo aplicativo.
- Não é possível aplicar um perímetro do VPC Service Controls aos armazenamentos de dados do Microsoft SharePoint. 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 SharePoint não aceita arquivos
.xlsxpara a ação de upload.
- O repositório de dados do Microsoft SharePoint só é compatível com as regiões
Global,USeEU.
Confira as limitações do repositório de dados federado do Microsoft SharePoint:
- 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 sites ou bibliotecas compartilhados pode exigir permissões específicas que não são cobertas pela autorização padrão do usuário.
A seguir
- Para criar e configurar um repositório de dados com o Microsoft SharePoint, consulte Configurar um repositório de dados do Microsoft SharePoint.