Compartilhar via

Implementar o conector de Microsoft 365 Copilot do Servidor de Problemas do GitLab

O conector do GitLab Issues Server Microsoft 365 Copilot integra dados de problemas do GitLab no Microsoft 365. Quando implementa este conector, o Microsoft 365 Copilot e o Microsoft Search podem surgir problemas relevantes do GitLab diretamente em aplicações como o Teams, o Outlook e o SharePoint. Este artigo descreve os passos para implementar e configurar o conector do Servidor de Problemas do GitLab.

Pré-requisitos

Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:

  • Confirme que a instância do GitLab está acessível através da API.
  • Gere um ID de cliente e segredo do cliente a partir do GitLab para autenticação.
  • Confirme que a conta de autenticação tem acesso a repositórios, problemas, pedidos de intercalação, ficheiros de conhecimento e páginas wiki.
  • Confirme que os âmbitos do OAuth do GitLab incluem os seguintes âmbitos: read_api, read_repository, read_user.
  • Certifique-se de que os utilizadores que acedem a dados indexados do GitLab têm identidades Microsoft Entra ID para mapeamento de permissões.
  • Defina os URLs de redirecionamento corretos durante a configuração da autenticação do GitLab:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  • Para instâncias do GitLab geridas automaticamente, certifique-se de que:
    • Tem a versão 17.7 ou posterior do GitLab.
    • Tem a versão 3.1.8.0 ou posterior do agente do conector do Microsoft Graph instalada num servidor com acesso ao GitLab.
    • A conta de autenticação tem privilégios administrativos para pesquisa na lista de controlo de acesso (ACL).
  • Para um melhor desempenho, ajuste os limites de taxa do GitLab conforme recomendado:
    • Limites de taxa de utilizador e IP: desmarque Ativar limite de taxa de pedidos de API autenticado e Ativar limite de taxa de pedidos Web autenticado.
    • Limites de taxa da API de Ficheiros: desmarque Ativar limite de taxa de pedidos de API autenticado.
    • Limites de taxa de API preteridos: desmarque Ativar limite de taxa de pedidos de API autenticado.
    • Limites de taxa da API dos utilizadores: defina o máximo de pedidos por 10 minutos por utilizador para um valor elevado (por exemplo, 100000).
    • Limites de taxa da API de Grupos e Projetos: defina todos os valores como 0 para desativar os limites.
    • Limites de taxa da API de Membros: definido como 0.

Recomendações de limite de taxa

Utilize as diretrizes na tabela seguinte para escolher as definições de limite de taxa com base no número aproximado de problemas do GitLab.

Número aproximado de itens Definição de limite de taxa recomendada Hora de ingestão aproximada
Até 100 000 20 000 pedidos/hora Horas para um dia
100.000 a 1.000.000 25 000 pedidos/hora Dois dias a uma semana
1000 000 ou mais 25 000 pedidos/hora 1 a 2 semanas (varia de acordo com a carga do ambiente)

Implementar o conector

Para adicionar o conector do Servidor problemas do GitLab para a sua organização:

  1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
  2. Selecione o separador Galeria .
  3. Na lista de conectores disponíveis, selecione GitLab Issues Server.

Definir nome a apresentar

O nome a apresentar identifica referências em respostas copilot e ajuda os utilizadores a reconhecer a origem de conteúdo associada.
Pode aceitar o nome a apresentar predefinido do Servidor de Problemas do GitLab ou personalizá-lo.

Definir URL da instância

Indique o URL base da sua instância do GitLab Server. O URL base é o URL que o conector utiliza para aceder aos dados do problema através das APIs REST do GitLab.

Escolher o Agente do Conector do Graph

Selecione o agente do conector do Microsoft Graph que gere a ingestão de dados do GitLab no Microsoft 365. Para obter mais informações, veja Agente do conector do Microsoft Graph.

Escolher tipo de autenticação

O conector do GitLab Issues Server suporta o OAuth 2.0. Introduza o ID de cliente e o segredo do cliente do GitLab e, em seguida, selecione Autorizar.

Implementar

Para implementar o conector para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique utilizadores ou grupos.

Selecione Criar para implementar a ligação. O conector do Servidor problemas do GitLab começa imediatamente a indexar conteúdo.

Para personalizar a ligação, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições

Depois de criar a ligação, pode rever o respetivo status emConectoresCopilot> no Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar os valores predefinidos para as definições do conector do Servidor problemas do GitLab. Para personalizar as definições, selecione Configuração personalizada na página do conector.

Personalizar as definições do utilizador

Permissões de acesso

Escolha se os dados indexados estão visíveis para:

  • Apenas pessoas com acesso a esta origem de dados (predefinição)
  • Todos

Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados são apresentados apenas para utilizadores autorizados. Se escolher Todos, os dados indexados são apresentados para todos os utilizadores.

Identidades do mapa

Mapeie as identidades de utilizador do GitLab para Microsoft Entra ID. As opções são:

  • Email: mapeia o e-mail do GitLab para Microsoft Entra ID propriedades do utilizador.
  • Início de sessão: mapeia inícios de sessão do GitLab com Microsoft Entra ID propriedades de utilizador.
  • Nome: mapeia o nome do GitLab com Microsoft Entra ID propriedades de utilizador.

Se o mapeamento direto falhar, utilize expressões regulares (regex) para transformar os dados. Por exemplo: [a-zA-Z0-9]+. Para obter mais informações, veja Mapear identidades Microsoft Entra.

Personalizar definições de conteúdo

No separador Dados , pode verificar os mapeamentos de propriedades nos dados de exemplo de metadados, tais como conteúdo, etiquetas, descrição e carimbos de data/hora.

Filtro de conteúdo

Pode configurar um filtro de intervalo de tempo para o conector. A predefinição é 365 dias.

Gerir propriedades

Pode adicionar ou remover propriedades disponíveis da origem de dados, atribuir um esquema à propriedade (pesquisável, queificável, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade.

Personalizar intervalos de sincronização

Configure os intervalos de sincronização de pesquisa completa e incremental . Seguem-se os valores predefinidos:

  • Pesquisa incremental: a cada 15 minutos
  • Pesquisa completa: Diariamente

Ajuste os intervalos com base nas necessidades da sua organização.

Conteúdo relacionado

  • Last updated on