O repositório de dados do Microsoft SharePoint para o Gemini Enterprise permite pesquisar e realizar ações nos dados do Microsoft SharePoint Online, incluindo documentos, listas e sites.
Versões do Microsoft SharePoint com suporte
O repositório de dados do Microsoft SharePoint oferece suporte à versão mais recente na nuvem do Microsoft SharePoint Online.
Ações com suporte
Quando o repositório de dados do Microsoft SharePoint 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. |
| Adicionar lista | Cria uma nova lista de dados estruturados (por exemplo, tarefas, contatos) no site do SharePoint. |
| Fazer upload do documento | Faz upload de um documento para um site ou biblioteca do SharePoint. |
| Fazer download do documento | Faz download de um documento de um site ou biblioteca do SharePoint. |
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 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 abaixo 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 | N/A | Nenhuma permissão da API Graph é necessária. |
| 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 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 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 | 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, exclua, faça upload e download de todos os arquivos que o usuário conectado pode acessar. | |
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 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. Os resultados da pesquisa são baseados nas permissões do usuário, e não nas permissões do app. |
AllSites.Read (Opção 1, Delegada) |
Permite que o repositório de dados leia documentos e itens de lista 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. As coleções de sites específicas e as permissões concedidas podem ser configuradas 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. As coleções de sites específicas e as permissões concedidas podem ser configuradas 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. As coleções de sites específicas e as permissões concedidas podem ser configuradas no SharePoint Online. | |
| Ações | AllSites.Write (Delegada) |
Permite que o repositório de dados crie, leia, atualize, exclua, faça upload e download de 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 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 é possível aplicar um perímetro do VPC Service Controls aos repositórios 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 só tem suporte nos locais
global,us, eeu.
Confira a seguir as limitações do repositório de dados federado do Microsoft SharePoint:
- 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 sites ou bibliotecas compartilhados pode exigir permissões específicas não cobertas pela autorização de usuário padrão.
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.