Partilhar via

Implementar o conector de Microsoft 365 Copilot da Cloud de Conhecimento do GitLab

O conector de Microsoft 365 Copilot da Cloud de Conhecimento do GitLab permite à sua organização indexar documentação, wikis e artefactos de conhecimento armazenados no GitLab e disponibilizá-los nas experiências Microsoft 365 Copilot e Microsoft Search. Este artigo descreve os passos para implementar e personalizar o conector do GitLab Knowledge Cloud.

Pré-requisitos

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

  • Tem de ser um administrador do Microsoft 365.
  • 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.
  • Confirme que a conta de autenticação tem acesso a repositórios, wikis, runbooks, documentação e ficheiros de conhecimento.
  • O ID de cliente e o segredo do cliente têm de incluir os seguintes âmbitos:
    • read_api
    • read_repository
    • read_user
  • Os utilizadores que acedem a dados indexados do GitLab têm de ter identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
  • Defina os URLs de redirecionamento adequados 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

Implementar o conector

Para adicionar o conector do GitLab Knowledge Cloud à 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, escolha GitLab Knowledge Cloud.

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. Pode aceitar o nome a apresentar predefinido da Cloud de Conhecimento do GitLab ou personalizá-lo.

Escolher tipo de autenticação

O conector do GitLab Knowledge Cloud suporta a autenticação OAuth 2.0 . Selecione OAuth 2.0, introduza o ID de cliente e o segredo do cliente e selecione Autorizar.

Implementar

Para implementar para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos para os quais pretende implementar o conector. Para obter mais informações, veja Implementação faseada para conectores Copilot.

Selecione Criar para implementar a ligação. O conector da Cloud de Conhecimento do GitLab começa imediatamente a indexar conteúdos.

A tabela seguinte lista os valores predefinidos que estão definidos.

Categoria Valor padrão
Usuários Apenas pessoas com acesso a esta origem de dados
Conteúdo Últimos 365 dias de conteúdo indexado
Sincronização Incremental: 15 minutos; Completo: diariamente

Para personalizar estes valores, selecione Configuração personalizada.

Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar os valores predefinidos para as definições do conector do GitLab Knowledge Cloud. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.

Personalizar as definições do utilizador

Permissões de acesso

Escolha uma das seguintes opções:

  • 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 nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores.

Identidades do mapa

Para garantir que as permissões são aplicadas corretamente, mapeie as identidades de utilizador do GitLab para Microsoft Entra ID. Escolha uma das seguintes opções de mapeamento:

  • 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

Configurar intervalos de sincronização para pesquisas completas e incrementais:

  • Pesquisa incremental: A predefinição é de 15 em 15 minutos.
  • Pesquisa completa: A predefinição é diária.

Pode ajustar estes intervalos para satisfazer as necessidades da sua organização. Para obter mais informações, veja Diretrizes para definições de sincronização.

A tabela seguinte lista os limites de taxa para a ingestão de conteúdos do conector do Conector do GitLab Knowledge Cloud.

Número aproximado de itens Hora aproximada para concluir a ingestão
Até 100 000 Dentro de 6 horas
100.000 a 1.000.000 6 horas a 3 dias
1000 000 ou mais 3 dias a 2 semanas (varia de acordo com a carga do ambiente)

Conteúdo relacionado

  • Last updated on