Configure um repositório de dados do Microsoft SharePoint

Esta página descreve como criar um repositório de dados e associar o Microsoft SharePoint ao Gemini Enterprise.

Antes de começar

Certifique-se do seguinte antes de configurar a ligação federada do Microsoft SharePoint:

  1. Conceda a função Editor do Discovery Engine (roles/discoveryengine.editor). Esta função é necessária para o utilizador criar o arquivo de dados. Para conceder esta função, faça o seguinte:

    1. Na Google Cloud consola, aceda à página IAM.

      Aceda ao IAM

    2. Localize a conta de utilizador e clique no ícone editar Editar.
    3. Conceda a função de Discovery Engine Editor ao utilizador. Para mais informações, consulte o artigo Funções e autorizações de IAM.

  2. Registe o Gemini Enterprise como uma aplicação OAuth 2.0 no Microsoft Entra ID e obtenha as seguintes credenciais:

    • ID do cliente

    • Segredo do cliente

    • ID do inquilino

    • URI da instância

  3. Configure as autorizações da API Microsoft com o consentimento de um administrador do Microsoft SharePoint.

Crie um arquivo de dados do Microsoft SharePoint

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

  1. Na Google Cloud consola, aceda à página do Gemini Enterprise.

    Gemini Enterprise

  2. Selecione ou crie um Google Cloud projeto.

  3. No menu de navegação, clique em Armazenamentos de dados.

  4. Clique em Criar arquivo de dados.

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

  6. Na secção Dados:

    1. Na secção Modo do conetor, selecione Pesquisa federada ou Carregamento de dados como modo de ligação.

    2. Clique em Continuar.

    3. Na secção Definições de autenticação, configure a autenticação com base no modo de ligação escolhido.

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

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

        Para mais informações, consulte o artigo Obtenha credenciais de cliente.

      2. Se selecionou Pesquisa federada, clique em Iniciar sessão e conclua o início de sessão de terceiros.

    4. Clique em Continuar.

    5. Se selecionou Pesquisa federada, é apresentada a secção Destinos. Introduza o URL base do site.

    6. Clique em Continuar.

    7. Na secção Entidades a pesquisar (se selecionou Pesquisa federada) ou Entidades a sincronizar (se selecionou Carregamento de dados):

      1. Selecione todas as entidades necessárias.
      2. Se selecionou Pesquisa federada, avance para o passo seguinte.
      3. Se selecionou Carregamento de dados, continue com os seguintes passos:
        1. Opcional: para sincronizar projetos específicos, faça o seguinte:
          1. Clique em Filtrar.
          2. Para filtrar entidades do índice, selecione a caixa de verificação Excluir do índice ou, para garantir que são incluídas no índice, selecione a caixa de verificação Incluir no índice.
          3. Introduza as chaves. Prima Enter após cada tecla.
          4. Clique em Guardar.
        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 de sincronização.
            • Para agendar sincronizações completas separadas de dados de entidades e identidades, expanda o menu na secção Sincronização completa e, de seguida, selecione Opções personalizadas.
          2. Na lista Frequência de sincronização incremental, selecione a frequência de sincronização incremental. Para mais informações, consulte o artigo Sincronize agendas.

  7. Clique em Continuar.

  8. Na secção Ações:

    1. Se selecionou Pesquisa federada:
      1. Em Selecionar ações do Microsoft SharePoint a ativar, selecione as ações da categoria para as ativar para o conetor.

    2. Se selecionou Carregamento de dados:

      1. Na secção Definições de autenticação, configure a autenticação com base no modo de ligação escolhido.

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

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

          Para mais informações, consulte o artigo Obtenha credenciais de cliente.

      2. Clique em Continuar.

      3. Na secção Destinos, introduza o URL de base do site.

      4. Clique em Continuar.

      5. Em Selecionar ações do Microsoft SharePoint a ativar, selecione as ações da categoria para as ativar para o conetor.

  9. Clique em Continuar.

  10. Na secção Configuração:

    1. Na lista Várias regiões, selecione a localização do conetor de dados.
    2. No campo Nome do conetor de dados, introduza um nome para o conetor.
    3. Se selecionou US ou EU como a localização, configure as Definições de encriptação:
      • Opcional: se não tiver configurado chaves de região única, clique em Aceder à página de definições para o fazer. Para mais informações, consulte o artigo Registe uma chave de região única para conetores de terceiros.
      • Selecione chave de encriptação gerida pelaGoogle ou chave do Cloud KMS.
      • Se selecionou Chave do Cloud KMS:
        • Na lista Tipo de gestão de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte o artigo Chaves de encriptação geridas pelo cliente.

  11. Clique em Continuar.

  12. Na secção Faturação, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte os artigos Valide o estado de faturação dos seus projetos e Licenças.

  13. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

Na página Armazenamentos de dados, clique no nome do armazenamento de dados para ver o estado. Depois de o estado do repositório de dados mudar de A criar para Ativo, o conetor do Microsoft SharePoint está pronto a ser usado.

Para um conector de carregamento criado com o Microsoft SharePoint, o estado do repositório de dados passa de A criar para Em execução após o início da sincronização. Em seguida, muda para Ativa assim que o carregamento estiver concluído, o que significa que o armazenamento de dados está totalmente configurado. Consoante o volume de dados, o carregamento pode demorar várias horas.

Depois de criar o repositório de dados, crie uma app, associe-a ao repositório de dados do Microsoft SharePoint e autorize o Gemini Enterprise a aceder ao Microsoft SharePoint antes de executar quaisquer consultas.

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

A sincronização em tempo real só sincroniza entidades de documentos e não sincroniza dados relacionados com entidades de identidade. A tabela seguinte mostra os eventos de documentos que são suportados com a sincronização em tempo real.

Entidades do Microsoft SharePoint Criar Atualizar Eliminar Alterações de permissões
Anexos
Comentários
Eventos
Ficheiros
Páginas

Para ativar a sincronização em tempo real para o seu repositório de dados, siga estes passos.

  1. Na Google Cloud consola, aceda à página Gemini Enterprise.

    Gemini Enterprise

  2. No menu de navegação, clique em Armazenamentos de dados.

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

  4. Na página Dados do armazenamento de dados, aguarde até que o Estado do conetor 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 Segredo do cliente, introduza um valor. Este valor é usado para validar os eventos do webhook do Microsoft SharePoint. Recomendamos a utilização de uma string de 20 carateres.

  8. Clique em Guardar.

    Aguarde até que o campo Sincronização em tempo real mude para Em execução.

Tratamento de dados e execução de consultas

Esta secção descreve como o Gemini Enterprise gere a sua consulta e as implicações de privacidade da utilização do repositório de dados federado.

Execução de consultas

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

  • O Gemini Enterprise envia a sua consulta de pesquisa diretamente para a API da Microsoft.
  • O Gemini Enterprise mistura os resultados com os de outras origens de dados ligadas e apresenta um resultado de pesquisa abrangente.

Tratamento de dados

Quando utiliza a pesquisa federada de terceiros, aplicam-se as seguintes regras de processamento de dados:

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

O que se segue?