Configure um arquivo de dados do Microsoft OneDrive

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

Antes de começar

Certifique-se do seguinte antes de configurar a ligação ao Microsoft OneDrive.

  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

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

Crie um arquivo de dados do Microsoft OneDrive

Para criar um arquivo de dados do Microsoft OneDrive, siga estes passos:

  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 OneDrive e clique em Selecionar.

  6. Na secção Dados:

    1. Na secção Modo de conector, selecione Carregamento de dados ou Pesquisa federada 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:

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

        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 da Microsoft.

    4. Clique em Continuar.

    5. Se selecionou Pesquisa federada, faça o seguinte:

      1. Na secção Destinos, introduza o URL base do seu site do Microsoft OneDrive.

      2. Na secção Opções avançadas, introduza o inquilino do Azure, o ID do inquilino que obteve quando criou a aplicação Entra.

    6. Se selecionou Carregamento de dados, na secção Opções avançadas, faça o seguinte:

      1. Opcional: para permitir um conjunto de endereços IP estáticos no seu sistema, selecione a caixa de verificação Ativar endereços IP estáticos.
      2. Opcional: no campo CPS máx., introduza o número máximo de consultas por segundo para aplicar um limite de taxa às consultas que o conector envia para a instância do Microsoft OneDrive.
      3. Opcional: para tentar desencriptar todos os ficheiros encriptados com a proteção de informações do Microsoft Purview, selecione a caixa de verificação Desencriptar ficheiros encriptados com a proteção de informações do Microsoft Purview.

    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 OneDrive a ativar, selecione as ações da categoria para as ativar para o conector.

    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. Indique os seguintes detalhes de autenticação:

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

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

      2. Clique em Iniciar sessão e inicie sessão no Microsoft OneDrive para validar a sua conta.

      3. Clique em Continuar.

      4. Na secção Definições avançadas, introduza o inquilino do Azure, o ID do inquilino que obteve quando criou a aplicação Entra.

      5. Na secção Destinos, introduza o URL base do seu site do Microsoft OneDrive.

      6. Em Selecionar ações do Microsoft OneDrive a ativar, selecione as ações da categoria para as ativar para o conector.

  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 OneDrive está pronto a ser usado.

Para um conector de carregamento criado com o Microsoft OneDrive, 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 OneDrive e autorize o Gemini Enterprise a aceder ao Microsoft OneDrive antes de executar quaisquer consultas.

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

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 arquivo de dados do Microsoft OneDrive 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 OneDrive. 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 OneDrive 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?