Partilhar via

Resolver problemas com o conector de Microsoft 365 Copilot da Cloud de Conhecimento do GitLab

O conector do GitLab Knowledge Cloud Microsoft 365 Copilot indexa documentação e artefactos de conhecimento armazenados em projetos do GitLab no GitLab.com. Este artigo fornece informações de resolução de problemas para erros comuns que poderá encontrar ao implementar e utilizar o conector do GitLab Knowledge Cloud. Estes problemas estão normalmente relacionados com autenticação, permissões, conteúdo em falta ou acesso à API do GitLab.

Não é possível encontrar conteúdos de conhecimento do GitLab no Copilot ou no Microsoft Search

Se os utilizadores não conseguirem encontrar documentação do GitLab, wikis ou artefactos de conhecimento no Copilot ou nos resultados da pesquisa, reveja o seguinte:

  • Confirme que o URL da instância do GitLab está correto.
  • Verifique se a aplicação OAuth do GitLab tem os âmbitos necessários:
    • read_api
    • read_repository
    • read_user
  • Verifique se a conta do GitLab autenticada tem acesso a todos os projetos, wikis e ficheiros indexados.
  • Certifique-se de que os utilizadores têm identidades Microsoft Entra ID que mapeiam corretamente para os utilizadores do GitLab.
  • Confirme que o conteúdo está dentro do intervalo de indexação predefinido (nos últimos 365 dias, a menos que seja personalizado).

Acesso em falta a determinados projetos, wikis ou runbooks do GitLab

Se alguns conteúdos estiverem em falta nos resultados da pesquisa ou nas respostas copilot:

  • Verifique as permissões da conta do GitLab utilizada durante a configuração do conector.
  • Verifique se os projetos, páginas wiki ou runbooks em falta necessitam de permissões ao nível do projeto.
  • Confirme que as regras de mapeamento de identidades correspondem corretamente aos utilizadores do GitLab para Microsoft Entra ID contas.
  • Se estiverem a ser utilizadas transformações regex, certifique-se de que os padrões correspondem aos identificadores de utilizador esperados.

Problemas de autorização do OAuth do GitLab

Se encontrar problemas ao concluir o fluxo OAuth:

  • Confirme que o ID de cliente e o segredo do cliente são válidos e pertencem à aplicação OAuth do GitLab configurada para o seu inquilino.
  • Verifique se o URL de redirecionamento correto está configurado:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
  • Verifique se o início de sessão único (SSO) está ativado na sua instância do GitLab. Alguns fluxos de SSO requerem que a conta tenha sessão iniciada separadamente antes da autorização.

Limitação da taxa de API do GitLab ou ingestão incompleta

Se a indexação colocar em pausa ou o conteúdo aparecer incompleto:

  • Verifique se o inquilino do GitLab está a atingir os limites de taxa.
  • Reveja as diretrizes de volume de ingestão:
    • Até 100 000 itens: normalmente é concluído dentro de várias horas.
    • 100 000 a 1000 000 itens: a ingestão pode demorar vários dias.
    • Mais de 1000 000 itens: a ingestão pode demorar de vários dias a semanas, dependendo da carga.
  • Reduza temporariamente o âmbito de indexação (por exemplo, ao restringir o intervalo de datas) para determinar se o desempenho melhora.
  • Reveja as personalizações do intervalo de sincronização para garantir que satisfazem as necessidades organizacionais:
    • Pesquisa incremental: 15 minutos (predefinição)
    • Pesquisa completa: diariamente (predefinição)

Resultados de pesquisa incorretos ou inesperados no Copilot

Se as respostas do Copilot mostrarem conteúdo inesperado ou omitir a documentação esperada do GitLab:

  • Verifique os mapeamentos de propriedades no separador Dados .
  • Confirme que os campos importantes, como título, conteúdo, descrição, etiquetas e carimbos de data/hora, estão mapeados e definidos corretamente.
  • Verifique se as propriedades marcadas como pesquisáveis, recuperáveis ou refináveis correspondem às suas necessidades de conteúdo.
  • Reveja a configuração da cadeia de consulta para confirmar que a filtragem não está a excluir o conteúdo necessário.

Problemas de mapeamento de identidades

Se os utilizadores não conseguirem ver o conteúdo esperado:

  • Confirme que os mapeamentos de identidade estão alinhados com o inquilino do GitLab:
    • Email
    • Logon
    • Nome
    • Transformação regex
  • Certifique-se de que o GitLab e Microsoft Entra ID utilizadores se alinham em todos os atributos necessários.
  • Se as regras de mapeamento forem complexas, teste com um pequeno conjunto de contas para verificar o comportamento correto do mapeamento.

Problemas de permissões

Se os utilizadores não receberem erros de acesso:

  • Confirme que as permissões da API REST do GitLab permitem que a conta de serviço do conector leia o âmbito completo dos documentos, wikis e recursos de conhecimento.
  • Verifique as definições de acesso do Microsoft 365:
    • Apenas pessoas com acesso a esta origem de dados
    • Todos
  • Confirme que as permissões ao nível do grupo ou do projeto do GitLab não estão a impedir que o conector recupere conteúdo.

Erros de URL da instância do GitLab

Se o conector comunica problemas com o URL da instância:

  • Confirme que o URL da instância corresponde à implementação do GitLab utilizada para alojar conteúdos de conhecimento.
    • Para GitLab.com, utilize https://gitlab.com.
    • Para instâncias autogeridas do GitLab, verifique se o URL está acessível e acessível a partir do ambiente do Microsoft 365.

Conteúdo relacionado

  • Last updated on