Configurar um repositório de dados do GitLab

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

Antes de começar

Antes de configurar a conexão do GitLab, verifique se você tem o seguinte:

  • 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 no ícone de 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.

  • Faça login na sua conta do GitLab e receba credenciais de autenticação.

  • Crie um app do GitLab para usar esse conector. Para mais informações, consulte Como criar apps do GitLab (em inglês).

Criar um repositório de dados do GitLab

Para criar um repositório de dados do GitLab, siga estas etapas:

  1. No Google Cloud console, 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 GitLab e clique em Selecionar.

    select-GitLab
    Selecione o GitLab.

  6. Na seção Dados:

    1. Na seção Configurações de autenticação, insira os seguintes detalhes:

      • ID do cliente: o ID do cliente OAuth do seu aplicativo.
      • Chave secreta do cliente: a chave secreta do cliente OAuth do seu aplicativo.
      enter-client-credentials
      Insira as credenciais do cliente.

      Para mais informações sobre credenciais, consulte Configuração do GitLab.

    2. Clique em Continuar e conclua o login e a autorização do GitLab.

    3. Na seção Destinos, insira o URL da instância do GitLab.

      enter-gitlab-url
      Insira o URL da instância do GitLab.

    4. Clique em Continuar.

    5. Na seção Opções avançadas, insira o nome da organização no campo Login do proprietário.

    6. Clique em Continuar.

    7. Na seção Entidades para pesquisar, selecione Projeto.

      enter-project
      Escolha a entidade a ser pesquisada.

  7. Clique em Continuar.

  8. Na seção Ações, em Selecionar ações do GitLab para ativar, escolha as ações da categoria para ativar no repositório de dados.

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

  9. Clique em Continuar.

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

  11. Clique em Continuar.

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

  13. 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 repositório de dados para conferir o status. Depois que o estado do repositório de dados mudar de Em criação para Ativo, o conector do GitLab estará pronto para uso.

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 GitLab e enviar uma consulta de pesquisa ao Gemini Enterprise:

  • O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API GitLab.
  • 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 GitLab).
  • 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