Partager via

Résoudre les problèmes liés au connecteur de Microsoft 365 Copilot GitLab Knowledge Cloud

Le connecteur GitLab Knowledge Cloud Microsoft 365 Copilot indexe la documentation et les artefacts de connaissances stockés dans des projets GitLab sur GitLab.com. Cet article fournit des informations de dépannage pour les erreurs courantes que vous pouvez rencontrer lorsque vous déployez et utilisez le connecteur GitLab Knowledge Cloud. Ces problèmes sont généralement liés à l’authentification, aux autorisations, au contenu manquant ou à l’accès à l’API GitLab.

Impossible de trouver le contenu des connaissances GitLab dans Copilot ou Recherche Microsoft

Si les utilisateurs ne peuvent pas trouver de documentation, de wikis ou d’artefacts de connaissances GitLab dans Copilot ou dans les résultats de recherche, passez en revue les points suivants :

  • Vérifiez que l’URL de instance GitLab est correcte.
  • Vérifiez que l’application GitLab OAuth a les étendues requises :
    • read_api
    • read_repository
    • read_user
  • Vérifiez que le compte GitLab authentifié a accès à tous les projets, wikis et fichiers indexés.
  • Vérifiez que les utilisateurs ont Microsoft Entra ID identités qui sont correctement mappées aux utilisateurs GitLab.
  • Vérifiez que le contenu se trouve dans la plage d’indexation par défaut (les 365 derniers jours, sauf s’il est personnalisé).

Accès manquant à certains projets, wikis ou runbooks GitLab

Si du contenu est manquant dans les résultats de recherche ou les réponses Copilot :

  • Vérifiez les autorisations du compte GitLab utilisé lors de la configuration du connecteur.
  • Vérifiez si les projets, pages wiki ou runbooks manquants nécessitent des autorisations au niveau du projet.
  • Vérifiez que les règles de mappage d’identité correspondent correctement aux utilisateurs GitLab aux comptes Microsoft Entra ID.
  • Si des transformations d’expression régulière sont en cours d’utilisation, assurez-vous que les modèles correspondent aux identificateurs d’utilisateur attendus.

Problèmes d’autorisation GitLab OAuth

Si vous rencontrez des problèmes lors de la fin du flux OAuth :

  • Vérifiez que l’ID client et la clé secrète client sont valides et appartiennent à l’application GitLab OAuth configurée pour votre locataire.
  • Vérifiez que l’URL de redirection correcte est configurée :
    • Microsoft 365 Entreprise :https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government :https://gcsgcc.office.com/v1.0/admin/oauth/callback
  • Vérifiez si l’authentification unique (SSO) est activée dans votre instance GitLab. Certains flux d’authentification unique nécessitent que le compte soit connecté séparément avant l’autorisation.

Limitation du débit de l’API GitLab ou ingestion incomplète

Si l’indexation s’interrompt ou si le contenu semble incomplet :

  • Vérifiez si votre locataire GitLab atteint les limites de débit.
  • Passez en revue les instructions relatives au volume d’ingestion :
    • Jusqu’à 100 000 éléments : se termine généralement en quelques heures.
    • 100 000 à 1 000 000 éléments : l’ingestion peut prendre plusieurs jours.
    • Plus de 1 000 000 éléments : l’ingestion peut prendre de plusieurs jours à plusieurs semaines en fonction de la charge.
  • Réduisez temporairement l’étendue d’indexation (par exemple, en réduisant la plage de dates) pour déterminer si les performances s’améliorent.
  • Passez en revue les personnalisations de l’intervalle de synchronisation pour vous assurer qu’elles répondent aux besoins de l’organisation :
    • Analyse incrémentielle : 15 minutes (par défaut)
    • Analyse complète : quotidienne (par défaut)

Résultats de recherche incorrects ou inattendus dans Copilot

Si les réponses Copilot affichent un contenu inattendu ou omettent la documentation GitLab attendue :

  • Vérifiez les mappages de propriétés sous l’onglet Données .
  • Vérifiez que les champs importants, tels que le titre, le contenu, la description, les étiquettes et les horodatages, sont mappés et définis correctement.
  • Vérifiez que les propriétés marquées comme pouvant faire l’objet d’une recherche, d’une récupération ou d’un refinissable correspondent à vos besoins en contenu.
  • Passez en revue la configuration de la chaîne de requête pour vérifier que le filtrage n’exclut pas le contenu requis.

Problèmes de mappage d’identité

Si les utilisateurs ne peuvent pas voir le contenu attendu :

  • Vérifiez que les mappages d’identité s’alignent sur votre locataire GitLab :
    • E-mail
    • Connexion
    • Nom
    • Transformation regex
  • Assurez-vous que GitLab et Microsoft Entra ID utilisateurs s’alignent sur tous les attributs requis.
  • Si les règles de mappage sont complexes, testez avec un petit ensemble de comptes pour vérifier le bon comportement de mappage.

Problèmes liés aux autorisations

Si les utilisateurs ne reçoivent aucune erreur d’accès :

  • Vérifiez que les autorisations de l’API REST GitLab permettent au compte de service du connecteur de lire l’étendue complète des documents, wikis et ressources de connaissances.
  • Vérifiez les paramètres d’accès à Microsoft 365 :
    • Seules les personnes ayant accès à cette source de données
    • Tout le monde
  • Vérifiez que les autorisations au niveau du groupe ou du projet GitLab n’empêchent pas le connecteur de récupérer du contenu.

Erreurs d’URL instance GitLab

Si le connecteur signale instance problèmes d’URL :

  • Assurez-vous que l’URL instance correspond au déploiement GitLab utilisé pour héberger le contenu des connaissances.
    • Pour GitLab.com, utilisez https://gitlab.com.
    • Pour les instances gitLab autogérées, vérifiez que l’URL est accessible et accessible à partir de l’environnement Microsoft 365.

Contenu connexe

  • Last updated on