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 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 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 uma biblioteca, pasta ou outro site do SharePoint de destino. |
| 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 no 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 de coluna. |
| Receber campos de 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 | 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 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 dos 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 (Option 1)Sites.Selected (Option 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. Os conjuntos de sites específicos e as permissões concedidas podem ser configurados no SharePoint Online. | |
User.Read.All (Option 1)User.ReadBasic.All (Option 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 "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 download de todos os arquivos a que o usuário conectado tem acesso. | |
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 no momento. 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. 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 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. 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 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. 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 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
Esta seção descreve problemas conhecidos e limitações 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 a ações de um único tipo de conector.
- 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 VPC Service Controls, 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,useeu.
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 é compatível com a pesquisa 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 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 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
- Para criar e configurar um repositório de dados com o Microsoft SharePoint, consulte Configurar um repositório de dados do Microsoft SharePoint.