Visão geral

Com o repositório de dados do Microsoft SharePoint para o Gemini Enterprise, você pode 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 compatíveis

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 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 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 página no site do Microsoft SharePoint.
Fazer check-out do documento Faça check-out de um documento de uma biblioteca do Microsoft SharePoint.
Verificar no documento Fazer check-in de um documento em uma biblioteca do Microsoft SharePoint.
Renomear anexo ou documento Renomear um anexo ou documento em uma biblioteca do Microsoft SharePoint.
Mover anexo ou documento Mover um documento de uma biblioteca do Microsoft SharePoint para outra biblioteca, pasta ou site do SharePoint.
Descartar documento de check-out Descarta um check-out em um documento, revertendo-o sem salvar as mudanças.
Compartilhar recurso Compartilha um documento, uma pasta ou um recurso com destinatários especificados 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 existente no site do Microsoft SharePoint.
Atualizar lista Atualiza as configurações de uma lista de dados estruturados em um site do Microsoft SharePoint.
Criar item da lista Cria um 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 de lista, incluindo todos os valores das colunas.
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 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 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 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. Ele 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 permissões concedidas e as coleções de sites específicas 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 os 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 itens de lista 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 "list lists", "get list item" e "get list fields".
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. 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 permissões concedidas e as coleções de sites específicas 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 permissões concedidas e as coleções de sites específicas 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 permissões concedidas e as coleções de sites específicas 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 seu uso do repositório de dados do Microsoft SharePoint.

  • Ao criar um 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 a 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 serviço, consulte Proteger seu app com o VPC Service Controls.
  • O repositório de dados do Microsoft SharePoint só é compatível com as regiões global, us e eu.

  • Pré-requisito de qualidade da pesquisa:para alcançar 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 as limitações do repositório 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 arquivo. O conteúdo em pastas arquivadas ou criptografadas pode não estar acessível para pesquisa. A pesquisa federada não permite pesquisar em anexos.
  • Acesso delegado:o acesso a sites ou bibliotecas compartilhados pode exigir permissões específicas que não são cobertas pela autorização padrão do usuário.
  • 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:por isso, estruturas complexas de PDF podem não ser totalmente analisadas ou pesquisáveis. Isso inclui:
    • Layouts de texto em 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.

Como resolver problemas com os 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 persistentes de autenticação, 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 a conexão novamente.
  • Divergência de identidade:se você estiver usando o Google Identity, verifique se o e-mail do Google do usuário corresponde exatamente ao e-mail do Microsoft SharePoint. Incompatibilidades impedem que os resultados sejam retornados.
  • Pesquisas de pastas segmentadas (URLs .aspx): pesquisar com URLs completos do navegador que terminam em /Forms/AllItems.aspx executa uma pesquisa em todo o site, não apenas na pasta específica. Sempre use caminhos absolutos de pastas 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 ao suporte e inclua seus tokens de diagnóstico.
  • Compatibilidade entre conector e modelo:use as versões mais recentes do modelo do Gemini. Alguns modelos mais antigos (por exemplo, 3.x) têm problemas conhecidos com ferramentas de resolução para ações do SharePoint, como download_document no Agent Builder.

A seguir