O repositório de dados do Microsoft SharePoint para o Gemini Enterprise oferece acesso aos seus dados do Microsoft SharePoint Online, o que lhe permite interagir com os seus documentos, listas e sites.
Versões do Microsoft SharePoint suportadas
O repositório de dados do Microsoft SharePoint suporta a versão mais recente na nuvem do Microsoft SharePoint Online.
Ações suportadas
Quando o arquivo de dados do Microsoft SharePoint está ativado, os utilizadores 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 num caminho especificado. |
| Adicionar lista | Cria uma nova lista de dados estruturados (por exemplo, tarefas, contactos) no site do SharePoint. |
Autorizações necessárias
Para permitir que o Gemini Enterprise realize pesquisas e carregamento de dados através do repositório de dados do Microsoft SharePoint, precisa das seguintes autorizações:
Autorizações da API Microsoft Graph
A tabela abaixo descreve as autorizações necessárias para cada modo de ligação.
Nota: a tabela seguinte descreve as autorizações necessárias para cada modo de ligação. Se ativar as Ações para o modo de ligação Pesquisa federada ou Carregamento de dados, selecione também as autorizações indicadas na linha Ações.
| Modo de ligação | Âmbito | Purpose |
|---|---|---|
| Pesquisa federada | N/A | Não são necessárias autorizações da API Graph. |
| Carregamento de dados | GroupMember.Read.All |
(Credenciais federadas e token de atualização do OAuth 2.0) Permite que o repositório de dados leia as associações e as propriedades básicas dos grupos para todos os grupos sem um utilizador com sessão iniciada. |
User.Read |
(Credenciais federadas e token de atualização do OAuth 2.0) Permite que o repositório de dados leia o perfil dos utilizadores com sessão iniciada. Também permite que o armazenamento de dados leia informações básicas da empresa de utilizadores com sessão iniciada. | |
User.Read.All |
(Apenas token de atualização do OAuth 2.0) Permite que o repositório de dados leia os perfis dos utilizadores. | |
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 controlo total de todas as coleções de sites. A opção 2 permite que o repositório de dados aceda a um subconjunto de coleções de sites. As coleções de sites específicas e as autorizações concedidas podem ser configuradas no SharePoint Online. | |
User.Read.All (Opção 1)User.ReadBasic.All (Opção 2) |
(Apenas credenciais federadas) A opção 1 permite que o repositório de dados leia os perfis dos utilizadores. A opção 2 permite que o armazenamento de dados leia um conjunto básico de propriedades do perfil de outros utilizadores na organização. | |
| Ações | Sites.ReadWrite.All |
(Pesquisa federada e carregamento de dados) Permite que o repositório de dados edite ou elimine documentos e liste itens em todas as coleções de sites em nome do utilizador com sessão iniciada. |
Files.ReadWrite |
Permite que o armazenamento de dados leia, crie, atualize e elimine os ficheiros do utilizador com sessão iniciada. | |
Files.ReadWrite.All |
Permite que o armazenamento de dados leia, crie, atualize e elimine todos os ficheiros aos quais o utilizador com sessão iniciada pode aceder. | |
Sites.Manage.All |
Permite que o repositório de dados crie ou elimine listas e bibliotecas de documentos em todas as coleções de sites em nome do utilizador. |
Autorizações da API Microsoft SharePoint
A tabela abaixo descreve as autorizações necessárias para cada modo de ligação.
| Modo de ligação | Âmbito | Purpose |
|---|---|---|
| Pesquisa federada | Sites.Search.All (Delegado) |
Permite que o armazenamento de dados execute consultas de pesquisa e leia informações básicas do site em nome do utilizador com sessão iniciada atual. Os resultados da pesquisa baseiam-se nas autorizações do utilizador e não nas autorizações da app. |
AllSites.Read (Opção 1, delegada) |
Permite que o arquivo de dados leia documentos e liste itens em todas as coleções de sites em nome do utilizador com sessão iniciada. | |
Sites.Selected (opção 2, delegado) |
Permite que o repositório de dados aceda a um subconjunto de coleções de sites com um utilizador com sessão iniciada. As coleções de sites específicas e as autorizações concedidas podem ser configuradas no SharePoint Online. | |
| Carregamento de dados (credenciais federadas) | Sites.FullControl.All (Opção 1, aplicação) |
Permite que o armazenamento de dados tenha controlo total de todas as coleções de sites. |
Sites.Selected (Opção 2, Aplicação) |
Permite que o repositório de dados aceda a um subconjunto de coleções de sites com um utilizador com sessão iniciada. As coleções de sites específicas e as autorizações concedidas podem ser configuradas no SharePoint Online. | |
| Carregamento de dados (token de atualização do OAuth 2.0) | AllSites.FullControl (Opção 1, delegada) |
Permite que o armazenamento de dados tenha controlo total de todas as coleções de sites em nome do utilizador com sessão iniciada. |
Sites.Selected (opção 2, delegado) |
Permite que o repositório de dados aceda a um subconjunto de coleções de sites com um utilizador com sessão iniciada. As coleções de sites específicas e as autorizações concedidas podem ser configuradas no SharePoint Online. | |
| Ações | AllSites.Write (Delegado) |
Permite que o repositório de dados crie, leia, atualize e elimine documentos e itens de listas em todas as coleções de sites em nome do utilizador com sessão iniciada. |
Para obter informações sobre como adicionar as autorizações para o Microsoft SharePoint, consulte o artigo Configure o Microsoft SharePoint e defina as autorizações necessárias.
Limitações
Esta secção descreve os problemas conhecidos e as limitações que podem afetar a sua utilização do arquivo de dados do Microsoft SharePoint.
- Ao criar uma nova aplicação ou adicionar um arquivo de dados a um existente, recomendamos que adicione apenas um arquivo de dados com ações pertencentes a um único tipo de conetor, independentemente do modo de associação. Por exemplo, não associe dois repositórios de dados do Microsoft SharePoint com ações ativadas à mesma aplicação.
- A aplicação de um perímetro dos VPC Service Controls a repositórios de dados do Microsoft SharePoint existentes não é suportada. Para aplicar os VPC Service Controls, tem de eliminar e recriar os arquivos de dados. Para mais informações sobre os VPC Service Controls e como usar ações após a ativação dos VPC Service Controls, consulte o artigo Proteja a sua app com os VPC Service Controls.
- O armazenamento de dados do Microsoft SharePoint só é suportado nas localizações
Global,USeEU.
Seguem-se as limitações do arquivo 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 ficheiros. O conteúdo em pastas arquivadas ou encriptadas pode não estar acessível para pesquisa. A pesquisa federada não suporta a pesquisa em anexos.
- Acesso delegado: o acesso a sites ou bibliotecas partilhados pode exigir autorizações específicas não abrangidas pela autorização de utilizador padrão.
O que se segue?
- Para criar e configurar um repositório de dados com o Microsoft SharePoint, consulte o artigo Configure um repositório de dados do Microsoft SharePoint.