Configurar um repositório de dados do Microsoft SharePoint

Nesta página, descrevemos como criar um repositório de dados e conectar o Microsoft SharePoint ao Gemini Enterprise.

Antes de começar

Antes de configurar sua conexão federada do Microsoft SharePoint, verifique se:

  1. Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:

    1. No console Google Cloud , acesse a página IAM.

      Acessar IAM

    2. Localize a conta de usuário e clique em editar Editar.
    3. Conceda a função Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.

  2. Registre o Gemini Enterprise como um aplicativo OAuth 2.0 no Microsoft Entra ID e receba as seguintes credenciais:

    • ID do cliente

    • Chave secreta do cliente

    • Código do locatário

    • URI da instância

  3. Configure as permissões da API da Microsoft com o consentimento de um admin do Microsoft SharePoint.

Criar um repositório de dados do Microsoft SharePoint

Para criar um repositório de dados do Microsoft SharePoint, faça o seguinte:

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Selecionar ou criar um projeto Google Cloud

  3. No menu de navegação, selecione Repositório de dados.

  4. Clique em Criar repositório de dados.

  5. Na seção Origem, pesquise Microsoft SharePoint e clique em Selecionar.

  6. Na seção Dados:

    1. Na seção Modo do conector, selecione Pesquisa federada ou Ingestão de dados como o modo de conexão.

    2. Clique em Continuar.

    3. Na seção Configurações de autenticação, configure a autenticação com base no modo de conexão escolhido.

      1. Forneça os seguintes detalhes de autenticação, conforme necessário:
        • ID do cliente: o identificador exclusivo do aplicativo registrado no Microsoft Entra ID da sua organização.
        • Chave secreta do cliente: a chave secreta gerada durante o processo de registro do aplicativo OAuth 2.0 no Microsoft Entra ID.
        • ID do locatário: o identificador exclusivo da sua organização no centro de administração do Microsoft Entra.
        • URI da instância: o URL de base da sua instância do Microsoft SharePoint (por exemplo, https://{your-domain}.sharepoint.com)
        • Tipo de ambiente do Microsoft SharePoint:selecione o ambiente que hospeda seu locatário do Microsoft 365:
          • Selecione Padrão (o padrão) se você se conectar ao Microsoft 365 comercial padrão ou ao Government Community Cloud (GCC).
          • Selecione Governo dos EUA se você se conectar a uma nuvem soberana do governo dos EUA do Microsoft 365 (GCC High ou DoD).

        Para mais informações, consulte Receber credenciais do cliente.

      • Se você selecionou Ingestão de dados com o método de autenticação Credenciais federadas, copie o Identificador do assunto e use-o para adicionar credenciais federadas para ingestão de dados.

        • Identificador de assunto: o ID exclusivo da conta de serviço que você planeja usar.

      • Se você selecionou Pesquisa federada, clique em Fazer login e conclua o processo de login de terceiros.

    4. Clique em Continuar.

    5. Se você selecionou Pesquisa federada, a seção Destinos vai aparecer. Digite o URL de base do site.

    6. Clique em Continuar.

    7. Na seção Opções avançadas, selecione seu ambiente de nuvem do Microsoft 365:

      • Se você se conectar a uma instância do Microsoft 365 US Government, selecione a opção correspondente: GCC, GCC High ou DoD.
      • Caso contrário, mantenha o padrão, Global.

    8. Se você selecionou Pesquisa federada, na seção Opções avançadas, é possível refinar o escopo das pesquisas e ações especificando quais sites do Microsoft SharePoint ou caminhos específicos incluir ou excluir. Só é possível fazer mutações ou recuperar dados nos caminhos incluídos. As solicitações de dados fora do escopo falham ou não retornam resultados.

      É possível adicionar filtros ao repositório de dados usando o console ou a API Google Cloud :

      Console

      Observação: ao inserir vários sites, separe cada URL com uma vírgula. Você também pode copiar e colar uma lista de URLs diretamente de um arquivo CSV.

      1. Na seção "Filtro de site":
        • Escolha o tipo de filtro: Incluir na pesquisa ou Excluir da pesquisa.
        • No campo Filtro de URL do site, insira os URLs exatos do site do Microsoft SharePoint para filtrar no formato https://{your-tenant}.sharepoint.com/sites/{your-site-name}.

          Observação: insira os URLs exatos do site. Subcaminhos, pastas ou bibliotecas de documentos não são aceitos neste campo específico.

      2. Na seção "Filtro de caminho":
        • Escolha o tipo de filtro: Incluir na pesquisa ou Excluir da pesquisa.
        • No campo Filtro de caminho, insira os caminhos completos do SharePoint.

          Observação: esse campo é compatível com subcaminhos, pastas e bibliotecas de documentos no formato https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Todo o conteúdo no caminho especificado será filtrado.

      REST

      Para adicionar filtros ao criar um repositório de dados, chame o método setUpDataConnector.

      curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
        -d '{
        "collectionId": "COLLECTION_ID",
        "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
        "dataConnector": {
            "dataSource": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "connectorModes": [
            "FEDERATED"
            ]
        }
        }'

      Substitua:

      • PROJECT_ID: ID do projeto.
      • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
        • us para a multirregião dos EUA
        • eu para a multirregião da UE
        • global para o local global
        Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
      • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
      • COLLECTION_ID: o ID exclusivo do repositório de dados.
      • COLLECTION_DISPLAY_NAME: o nome de exibição do repositório de dados.
      • CLIENT_ID: o ID do cliente para autenticação do SharePoint.
      • CLIENT_SECRET: a chave secreta do cliente para autenticação do SharePoint.
      • INSTANCE_URI: o URI da instância do SharePoint.
      • TENANT_ID: o ID do locatário do SharePoint.
      • FILTER_TYPE: o tipo de filtro adicionado aos seus repositórios de dados do Microsoft SharePoint. Para mais informações, consulte Tipos de filtro.
      • FILTER_KEY: a chave do filtro, correspondente a um campo nos seus dados. Para mais informações, consulte Chaves de filtro.
      • FILTER_VALUES: o valor ou os valores a serem filtrados para o FILTER_KEY especificado.

    Para mais detalhes sobre tipos de filtros e como adicionar filtros, consulte Adicionar filtros ao repositório de dados do Microsoft SharePoint.

  7. Clique em Continuar.

    1. Na seção Entidades para pesquisar (se você selecionou Pesquisa federada) ou Entidades para sincronizar (se você selecionou Ingestão de dados):
      1. Selecione todas as entidades necessárias.
      2. Se você selecionou Pesquisa federada, prossiga para a próxima etapa.
      3. Se você selecionou Ingestão de dados, siga estas etapas:
        1. Opcional: para sincronizar projetos específicos, faça o seguinte:
          1. Clique em Filtrar.
          2. Para filtrar entidades do índice, marque a caixa de seleção Excluir do índice ou, para garantir que elas sejam incluídas, marque a caixa de seleção Incluir no índice.
          3. Insira as chaves. Pressione "Enter" depois de cada chave.
          4. Clique em Salvar.
        2. Para configurar a programação de sincronização, faça o seguinte:
          1. Na lista Frequência de sincronização, selecione a frequência.
            • Para programar sincronizações completas separadas de dados de entidade e identidade, abra o menu na seção Sincronização completa e selecione Opções personalizadas.
          2. Na lista Frequência de sincronização incremental, selecione a opção desejada. Para mais informações, consulte Programações de sincronização.

  8. Clique em Continuar.

  9. Na seção Ações:

    1. Se você selecionou Pesquisa federada:
      1. Em Selecionar ações do Microsoft SharePoint para ativar, escolha as ações da categoria para ativar no conector.

    2. Se você selecionou Ingestão de dados:

      1. Na seção Configurações de autenticação, configure a autenticação com base no modo de conexão escolhido.

        1. Forneça os seguintes detalhes de autenticação, conforme necessário:

          • ID do cliente: o identificador exclusivo do aplicativo registrado no Microsoft Entra ID da sua organização.
          • Chave secreta do cliente: a chave secreta gerada durante o processo de registro do aplicativo OAuth 2.0 no Microsoft Entra ID.
          • ID do locatário: o identificador exclusivo da sua organização no centro de administração do Microsoft Entra.
          • URI da instância: o URL de base da sua instância do Microsoft SharePoint (por exemplo, https://{your-domain}.sharepoint.com)

          Para mais informações, consulte Receber credenciais do cliente.

      2. Clique em Continuar.

      3. Na seção Destinos, insira o URL de base do site.

      4. Clique em Continuar.

      5. Em Selecionar ações do Microsoft SharePoint para ativar, escolha as ações da categoria para ativar no conector.

  10. Clique em Continuar.

    Para gerenciar a lista de ações, consulte Gerenciar ações.

  11. Se o fluxo de criação do repositório de dados mostrar uma seção Opções avançadas, marque a caixa de seleção Ativar endereços IP estáticos. Isso garante que o repositório de dados use um conjunto fixo de endereços IP para o tráfego de saída, adequado para a lista de permissões no sistema de origem. Para mais informações, consulte Configurar saída de IP estático.

  12. Na seção Configuração:

    1. Na lista Multirregional, selecione o local do conector de dados.
    2. No campo Nome do conector de dados, insira um nome para o conector.
    3. Se você selecionou us ou eu como o local, configure as Configurações de criptografia:
      • Opcional: se você não tiver configurado chaves de região única, clique em Acessar a página de configurações para fazer isso. Para mais informações, consulte Registrar uma chave de região única para conectores de terceiros.
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

  13. Clique em Continuar.

  14. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

  15. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da loja para conferir o status. Depois que o estado do repositório de dados mudar de Criação para Ativo, o conector do Microsoft SharePoint estará pronto para uso.

Para um conector de ingestão criado com o Microsoft SharePoint, o estado do repositório de dados muda de Criação para Execução após o início da sincronização. Em seguida, ele muda para Ativo quando a ingestão é concluída, indicando que o repositório de dados está totalmente configurado. Dependendo do volume de dados, a ingestão pode levar várias horas.

Depois de criar o repositório de dados, crie um app, conecte-o ao repositório de dados do Microsoft SharePoint e autorize o Gemini Enterprise a acessar o Microsoft SharePoint antes de executar qualquer consulta.

Ativar a sincronização em tempo real para ingestão de dados

A sincronização em tempo real só sincroniza entidades de documento e não sincroniza dados relacionados a entidades de identidade. A tabela a seguir mostra quais eventos de documento são compatíveis com a sincronização em tempo real.

Entidades do Microsoft SharePoint Criar Atualizar Excluir Alterações de permissão
Anexos
Comentários
Eventos
Arquivos
Páginas

Para ativar a sincronização em tempo real do repositório de dados, siga estas etapas.

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. No menu de navegação, selecione Repositório de dados.

  3. Clique no nome do repositório de dados do Microsoft SharePoint para o qual você quer ativar a sincronização em tempo real.

  4. Na página Dados do repositório de dados, aguarde até que o estado do conector mude para Ativo.

  5. No campo Sincronização em tempo real, clique em Ver/editar.

  6. Para ativar a sincronização em tempo real, clique no botão Ativar sincronização em tempo real.

  7. No campo Chave secreta do cliente, insira um valor. Esse valor é usado para verificar eventos de webhook do Microsoft Outlook. Recomendamos usar uma string de 20 caracteres.

  8. Clique em Salvar.

    Aguarde o campo Sincronização em tempo real mudar para Em execução.

Tratamento de dados e execução de consultas

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Execução da consulta

Depois de autorizar o Microsoft SharePoint e enviar uma consulta de pesquisa para o Gemini Enterprise:

  • O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API da Microsoft.
  • O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Processamento de dados

Ao usar a pesquisa federada de terceiros, as seguintes regras de tratamento de dados são aplicadas:

  • Sua string de consulta é enviada para o back-end de pesquisa de terceiros (API da Microsoft).
  • Esses terceiros podem associar consultas à sua identidade.
  • Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.
  • Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema.

A seguir