Freigeben über

Behandeln von Problemen mit dem GitLab Knowledge Cloud Microsoft 365 Copilot Connector

Der GitLab Knowledge Cloud Microsoft 365 Copilot Connector indiziert Dokumentation und Wissensartefakte, die in GitLab-Projekten auf GitLab.com gespeichert sind. Dieser Artikel enthält Informationen zur Problembehandlung für häufige Fehler, die bei der Bereitstellung und Verwendung des GitLab Knowledge Cloud-Connectors auftreten können. Diese Probleme beziehen sich in der Regel auf Authentifizierung, Berechtigungen, fehlende Inhalte oder GitLab-API-Zugriff.

GitLab-Wissensinhalte in Copilot oder Microsoft Search nicht gefunden

Wenn Benutzer keine GitLab-Dokumentation, Wikis oder Wissensartefakte in Copilot oder in Suchergebnissen finden können, lesen Sie Folgendes:

  • Vergewissern Sie sich, dass die GitLab-instance-URL korrekt ist.
  • Stellen Sie sicher, dass die GitLab OAuth-App über die erforderlichen Bereiche verfügt:
    • read_api
    • read_repository
    • read_user
  • Überprüfen Sie, ob das authentifizierte GitLab-Konto Zugriff auf alle indizierten Projekte, Wikis und Dateien hat.
  • Stellen Sie sicher, dass Benutzer über Microsoft Entra ID Identitäten verfügen, die GitLab-Benutzern ordnungsgemäß zugeordnet sind.
  • Vergewissern Sie sich, dass der Inhalt innerhalb des Standardindizierungsbereichs liegt (die letzten 365 Tage, sofern nicht angepasst).

Fehlender Zugriff auf bestimmte GitLab-Projekte, Wikis oder Runbooks

Wenn inhalte in Suchergebnissen oder Copilot-Antworten fehlen:

  • Überprüfen Sie die Berechtigungen des GitLab-Kontos, das beim Einrichten des Connectors verwendet wird.
  • Überprüfen Sie, ob für die fehlenden Projekte, Wiki-Seiten oder Runbooks Berechtigungen auf Projektebene erforderlich sind.
  • Vergewissern Sie sich, dass Die Identitätszuordnungsregeln GitLab-Benutzer ordnungsgemäß mit Microsoft Entra ID Konten übereinstimmen.
  • Wenn RegEx-Transformationen verwendet werden, stellen Sie sicher, dass muster mit den erwarteten Benutzerbezeichnern übereinstimmen.

GitLab OAuth-Autorisierungsprobleme

Wenn Beim Abschließen des OAuth-Flusses Probleme auftreten:

  • Vergewissern Sie sich, dass die Client-ID und der geheime Clientschlüssel gültig sind und zu der für Ihren Mandanten konfigurierten GitLab-OAuth-App gehören.
  • Vergewissern Sie sich, dass die richtige Umleitungs-URL konfiguriert ist:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
  • Überprüfen Sie, ob einmaliges Anmelden (Single Sign-On, SSO) in Ihrem GitLab-instance aktiviert ist. Für einige SSO-Flows muss das Konto vor der Autorisierung separat angemeldet werden.

Ratenbegrenzung oder unvollständige Erfassung der GitLab-API

Wenn die Indizierung anhält oder der Inhalt unvollständig erscheint:

  • Überprüfen Sie, ob Ihr GitLab-Mandant die Ratenbegrenzungen erreicht.
  • Überprüfen Sie die Richtlinien für das Erfassungsvolumen:
    • Bis zu 100.000 Elemente: Wird in der Regel innerhalb mehrerer Stunden abgeschlossen.
    • 100.000 bis 1.000.000 Elemente: Die Erfassung kann mehrere Tage dauern.
    • Über 1.000.000 Artikel: Die Erfassung kann je nach Last mehrere Tage bis Wochen dauern.
  • Verringern Sie den Indizierungsbereich vorübergehend (z. B. durch Einschränken des Datumsbereichs), um zu bestimmen, ob sich die Leistung verbessert.
  • Überprüfen Sie die Anpassungen des Synchronisierungsintervalls, um sicherzustellen, dass sie die Anforderungen der Organisation erfüllen:
    • Inkrementelle Durchforstung: 15 Minuten (Standard)
    • Vollständige Durchforstung: täglich (Standard)

Falsche oder unerwartete Suchergebnisse in Copilot

Wenn Copilot-Antworten unerwartete Inhalte anzeigen oder die erwartete GitLab-Dokumentation auslassen:

  • Überprüfen Sie die Eigenschaftenzuordnungen auf der Registerkarte Daten .
  • Vergewissern Sie sich, dass wichtige Felder wie Titel, Inhalt, Beschreibung, Bezeichnungen und Zeitstempel ordnungsgemäß zugeordnet und festgelegt sind.
  • Vergewissern Sie sich, dass die als durchsuchbar, abrufbar oder verfeinerbaren Eigenschaften Ihren Inhaltsanforderungen entsprechen.
  • Überprüfen Sie die Konfiguration der Abfragezeichenfolge, um zu bestätigen, dass die Filterung erforderliche Inhalte nicht ausschließt.

Probleme bei der Identitätszuordnung

Wenn Benutzer den erwarteten Inhalt nicht sehen können:

  • Vergewissern Sie sich, dass die Identitätszuordnungen ihrem GitLab-Mandanten entsprechen:
    • E-Mail
    • Anmeldung
    • Name
    • RegEx-Transformation
  • Stellen Sie sicher, dass GitLab und Microsoft Entra ID Benutzer über alle erforderlichen Attribute hinweg ausgerichtet sind.
  • Wenn Zuordnungsregeln komplex sind, testen Sie mit einer kleinen Gruppe von Konten, um das richtige Zuordnungsverhalten zu überprüfen.

Berechtigungsprobleme

Wenn Benutzer keine Zugriffsfehler erhalten:

  • Überprüfen Sie, ob gitLab-REST-API-Berechtigungen es dem Dienstkonto des Connectors ermöglichen, den gesamten Umfang von Dokumenten, Wikis und Wissensressourcen zu lesen.
  • Überprüfen Sie die Microsoft 365-Zugriffseinstellungen:
    • Nur Personen mit Zugriff auf diese Datenquelle
    • Jeder
  • Vergewissern Sie sich, dass GitLab-Gruppen- oder Projektebenenberechtigungen den Connector nicht am Abrufen von Inhalten hindern.

GitLab instance URL-Fehler

Wenn der Connector instance URL-Probleme meldet:

  • Stellen Sie sicher, dass die instance-URL mit der GitLab-Bereitstellung übereinstimmt, die zum Hosten von Wissensinhalten verwendet wird.
    • Verwenden Sie https://gitlab.comfür GitLab.com .
    • Vergewissern Sie sich bei selbstverwalteten GitLab-Instanzen, dass auf die URL über die Microsoft 365-Umgebung zugegriffen und erreichbar ist.

Verwandte Inhalte

  • Last updated on