Visão geral

O conector do Microsoft SharePoint para o Gemini Enterprise permite acessar seus dados do Microsoft SharePoint Online, para que você possa interagir com documentos, listas e sites.

Versões compatíveis do Microsoft SharePoint

O conector do Microsoft SharePoint é compatível com a versão mais recente do Microsoft SharePoint Online na nuvem.

Ações compatíveis

Quando o conector 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 pasta em um caminho especificado.
Adicionar lista Cria uma nova lista de dados estruturados (por exemplo, tarefas, contatos) no site do 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 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. 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 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 Sites.ReadWrite.All (Pesquisa federada e ingestão de dados) Permite que o conector 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 conector leia, crie, atualize e exclua os arquivos do usuário conectado.
Files.ReadWrite.All Permite que o conector leia, crie, atualize e exclua todos os arquivos a que o usuário conectado tem acesso.
Sites.Manage.All Permite que o conector 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 conector 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 do app.
AllSites.Read (opção 1, delegada) Permite que o conector 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 conector 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 conector tenha controle total de todas as coleções de sites.
Sites.Selected (opção 2, aplicativo) Permite que o conector 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 conector 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 conector 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 conector 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 seu uso do conector do Microsoft SharePoint.

  • 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 serviço, consulte Proteger seu app com o VPC Service Controls.

  • O repositório de dados do Microsoft SharePoint é compatível apenas com 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 SharePoint com ações ativadas ao mesmo aplicativo.

Confira as limitações do conector 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 não cobertas pela autorização padrão do usuário.

A seguir