Visão geral

O repositório de dados do Microsoft SharePoint para o Gemini Enterprise permite pesquisar e realizar ações nos seus 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 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 ações a seguir.

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 o 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.
Confira o documento Confira um documento de uma biblioteca do Microsoft SharePoint.
Check-in no documento Fazer check-in de um documento em uma biblioteca do Microsoft SharePoint.
Renomear anexo ou documento Renomeie um anexo ou documento em uma biblioteca do Microsoft SharePoint.
Mover anexo ou documento Mova um documento de uma biblioteca do Microsoft SharePoint para uma biblioteca de destino, pasta ou outro site do SharePoint.
Descartar documento de check-out Descarta uma retirada em um documento, revertendo-o sem salvar as alterações.
Compartilhar recurso Compartilha um documento, uma pasta ou um recurso com destinatários específicos ou gera um link de compartilhamento.
Atualizar propriedades do arquivo Atualiza as propriedades de metadados de um documento em uma biblioteca do Microsoft SharePoint.
Atualizar página Atualiza uma página no site do Microsoft SharePoint.
Atualizar lista Atualiza as configurações de uma lista de dados estruturados no site do Microsoft SharePoint.
Criar item da lista Cria um novo item em uma lista especificada no site do Microsoft SharePoint.
Atualizar item da lista Atualiza os campos de um item em uma lista especificada.
Listar listas Recupera todas as listas e bibliotecas de documentos em um site especificado do Microsoft SharePoint.
Receber item da lista Retorna um único item da lista, incluindo todos os valores de coluna.
Receber campos da lista Retorna o esquema de uma lista especificada, incluindo todos os campos e propriedades dela.

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 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 Não é necessário ter 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 as associações e as 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 dos usuários conectados. Ele também permite que o repositório de dados leia informações básicas da empresa dos usuários que fizeram login.
User.Read.All (Somente token de atualização do OAuth 2.0) Permite que o repositório de dados leia perfis de usuário.
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á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 liste itens em todas as coleções de sites em nome do usuário conectado.
Sites.Read.All (Pesquisa federada e ingestão de dados) Permite que o repositório de dados leia listas, itens de lista e esquemas de lista em todas as coleções de sites em nome do usuário conectado. Obrigatório para as ações de listar listas, receber item da lista e receber campos da lista.
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 baixe 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. 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. 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, Aplicação) 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 liste itens 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

Nesta seção, descrevemos problemas conhecidos e limitações que podem afetar o uso do repositório de dados do Microsoft SharePoint.

  • Ao criar um app ou adicionar um repositório de dados a um app, recomendamos associar apenas um repositório de dados a ações que pertencem a um único tipo de conector.
  • Não é possível aplicar um perímetro do VPC Service Controls em repositórios de dados do Microsoft SharePoint. Para aplicar o VPC Service Controls, exclua e recrie 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 é compatível apenas com os locais global, us e eu.

  • Pré-requisito de qualidade da pesquisa: para conseguir os melhores resultados de pesquisa e aproveitar ao máximo os recursos do Mapa de Informações, recomendamos configurar e sincronizar o repositório de dados de pesquisa de pessoas, além do repositório de dados do Microsoft SharePoint.

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 é 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 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 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 ou o tempo necessários para a análise profunda 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 com 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 grade vertical ou conteúdo dependente de OCR), recomendamos o uso do 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.

Resolver problemas nos resultados da pesquisa do conector do SharePoint

Se você estiver com problemas de documentos ausentes, resultados incorretos ou baixa relevância da pesquisa, verifique as seguintes áreas de diagnóstico:

  • Verifique o repositório de dados de pessoas: confira se o repositório de dados de pesquisa de pessoas está configurado e sincronizando se você tiver problemas de relevância ou correspondência de entidades.
  • Erros de autenticação: erros de autenticação persistentes, como "Erro ao recuperar o token de acesso da API Graph", impedem o funcionamento das pesquisas. Para resolver isso, verifique os registros do Microsoft Entra ID para mais detalhes e autentique novamente a conexão.
  • Incompatibilidade de identidade: se você estiver usando o Google Identity, verifique se o e-mail do Google do usuário é exatamente igual ao e-mail do Microsoft SharePoint. Incompatibilidades impedem que os resultados sejam retornados.
  • Pesquisas de pastas segmentadas (URLs .aspx): ao pesquisar com URLs de navegador completos que terminam em /Forms/AllItems.aspx, a pesquisa é feita em todo o site, não apenas na pasta específica. Sempre use caminhos de pasta absolutos para pesquisas segmentadas.
  • Limites de resultados: as pesquisas federadas podem ter limites no número de documentos retornados por consulta (normalmente, cerca de 20 resultados).
  • Problemas de citação: podem ocorrer citações incorretas intermitentes. Se o problema persistir, informe o suporte e inclua seus tokens de diagnóstico.
  • Compatibilidade do modelo de conector: use as versões mais recentes do modelo do Gemini. Alguns modelos mais antigos (por exemplo, 3.x) têm problemas conhecidos ao resolver ferramentas para ações do SharePoint, como download_document no Agent Builder.

A seguir