Visão geral

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 compatíveis do Microsoft SharePoint

O repositório de dados do Microsoft SharePoint é compatível com a versão mais recente na nuvem do Microsoft SharePoint Online.

Ações permitidas

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 Microsoft SharePoint.
Fazer upload do documento Faz upload de um documento para um site ou biblioteca do Microsoft SharePoint.
Fazer download do documento Faz download de um documento de um site ou biblioteca do Microsoft SharePoint.
Adicionar página Cria uma nova página no site do Microsoft SharePoint.
Fazer check-out do documento Faz check-out de um documento de uma biblioteca do Microsoft SharePoint.
Fazer check-in do documento Faz check-in de um documento em uma biblioteca do Microsoft SharePoint.
Renomear anexo ou documento Renomeia um anexo ou documento em uma biblioteca do Microsoft SharePoint.
Mover anexo ou documento Move um documento de uma biblioteca do Microsoft SharePoint para uma biblioteca, pasta ou outro site do SharePoint de destino.

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 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 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 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 atual. 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 há suporte para a aplicação de um perímetro do VPC Service Controls em 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, e eu.

Confira abaixo 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.
  • Analisador de layout no modo de pesquisa federada:embora o analisador de layout seja padrão, a eficácia dele em PDFs complexos (com tabelas, layouts de várias colunas ou que precisam de OCR) é limitada no modo de pesquisa federada. As chamadas de API em tempo real desse modo podem não fornecer os dados completos ou o tempo necessário para a análise detalhada que o analisador de layout realiza durante a ingestão de dados.
  • Recursos de PDF não compatíveis:consequentemente, estruturas de PDF complexas podem não ser totalmente analisadas ou pesquisáveis. Isso inclui:
    • Layouts de texto de várias colunas
    • Dados em tabelas e gráficos incorporados
    • Texto em documentos digitalizados que exigem reconhecimento óptico de caracteres (OCR)
    • Documentos com ordens de leitura não lineares ou formatação complexa.

Recomendação

Para dados do Microsoft SharePoint que contêm PDFs com recursos complexos (como tabelas, layouts de várias colunas ou conteúdo dependente de OCR), recomendamos usar o modo de ingestão padrão para uma pesquisa eficaz. Esse modo permite que o analisador de layout processe e indexe profundamente todo o conteúdo do documento.

A seguir