Associe o Microsoft SharePoint Online com a federação de dados

Esta página descreve como associar o Microsoft SharePoint Online ao Gemini Enterprise através da federação de dados.

Use o procedimento seguinte para pesquisar na sua conta do SharePoint através da pesquisa federada.

Acerca da federação de dados

Com a federação de dados, o Gemini Enterprise obtém diretamente informações das origens de dados de terceiros através de APIs, em vez de copiar os dados para o Gemini Enterprise. Com esta abordagem, pode aceder imediatamente a origens de dados externas, sem esperar pela ingestão.

Antes de começar

Antes de poder criar o conector no Gemini Enterprise, tem de configurar um registo de aplicação do Entra para ativar o acesso seguro ao SharePoint.

  1. Registe o Gemini Enterprise como uma aplicação OAuth 2.0 no Entra.

    1. Navegue para o centro de administração do Microsoft Entra.
    2. No menu, expanda a secção Aplicações e selecione Registos de apps.
    3. Na página Registos de apps, selecione Novo registo.
      Registe uma nova app no Entra
      Registe uma nova app no centro de administração do Microsoft Entra
    4. Crie um registo de app na página Registar uma aplicação:
      Registar contas apenas no diretório organizacional
      Selecione o tipo de conta e introduza o URI de redirecionamento
    5. Na secção Tipos de contas suportados, selecione Contas apenas no diretório organizacional.

    6. Na secção URI de redirecionamento, selecione Web e introduza os seguintes URLs como URLs de callback da Web (ou URLs de redirecionamento):

      • https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
      • https://vertexaisearch.cloud.google.com/oauth-redirect

    7. Adicione um segredo do cliente:

      1. Aceda a Certificados e segredos e clique em Novo segredo do cliente.
      2. Copie e anote a string secreta.

  2. Recolha as seguintes credenciais:

    • ID do cliente
    • Segredo do cliente
    • URL da instância
    • ID do inquilino

  3. Configure estas autorizações da API (aplicação) do SharePoint com o consentimento do administrador:

    Autorização Tipo
    AllSites.Read Delegada
    MyFiles.Read Delegada
    Sites.Search.All Delegada

Crie um conector de pesquisa federada com o SharePoint

Consola

Siga os passos seguintes para usar a Google Cloud consola para realizar uma pesquisa federada através do SharePoint a partir do Gemini Enterprise.

  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 em Criar arquivo de dados.

  4. Na página Selecione uma origem de dados, desloque a página ou pesquise SharePoint Federated para associar a sua origem de terceiros.

    create-data-store
    Pesquise SharePoint federado

  5. Em Definições de autenticação:

    1. Introduza o ID de cliente, o segredo do cliente, o URL da instância e o ID do inquilino.
    2. Clique em Autenticar.

    3. Clique em Continuar.

      enter-auth-info
      Introduza as informações de autenticação

  6. Selecione os tipos de entidades que quer pesquisar.

    select-region-enter-name
    Selecione os tipos de entidades

  7. Selecione uma região para a sua origem de dados.

  8. Introduza um nome para a origem de dados.

    select-region-enter-name
    Configure o conetor de dados

  9. 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.

Depois de criar o arquivo de dados, aceda à página Arquivos de dados e clique no nome do arquivo de dados para ver o estado. Se o Estado do conetor mudar de A criar para Ativo, o conetor de pesquisa federada está pronto a ser usado.

Autorização do utilizador

Depois de criar um repositório de dados de pesquisa federada, pode vê-lo listado como uma das origens de dados no painel de gestão de origens. Se não autorizou anteriormente o Gemini Enterprise, não pode selecionar a origem de dados. Em alternativa, é apresentado um botão Autorizar junto ao mesmo.

Para iniciar o fluxo de autorização:

  1. Clique em Autorizar. É feito o redirecionamento para o servidor de autorização do SharePoint.
    clicar para autorizar
    Clique em Autorizar

  2. Inicie sessão na sua conta.

  3. Clique em Conceder acesso. Depois de conceder acesso, é feito o redirecionamento de volta para o Gemini Enterprise para concluir o fluxo de autorização. O Gemini Enterprise obtém o access_token e usa-o para aceder à pesquisa de terceiros.

Execução de consultas

Quando introduz uma consulta de pesquisa:

  • Se o SharePoint estiver autorizado, o Gemini Enterprise envia a consulta para a API SharePoint.
  • O Gemini Enterprise mistura os resultados com os de outras fontes e apresenta-os.

Tratamento de dados

Quando usa a pesquisa federada de terceiros, a sua string de consulta é enviada para o backend de pesquisa de terceiros. 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 (e não pelos termos da Google Cloud).