Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der GitLab Knowledge Server Microsoft 365 Copilot-Connector ermöglicht es Ihrem organization, Wissensinhalte, die in selbstverwalteten (lokalen) GitLab-Instanzen gespeichert sind, zu indizieren und in Microsoft 365 Copilot- und Microsoft Search-Umgebungen verfügbar zu machen. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des GitLab Knowledge Server-Connectors beschrieben.
Voraussetzungen
Stellen Sie vor der Bereitstellung des GitLab Knowledge Server-Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Auf den GitLab-Server (selbstverwaltet) instance kann über die GitLab-REST-API zugegriffen werden.
- Sie haben eine Client-ID und einen geheimen Clientschlüssel in GitLab für die OAuth 2.0-Authentifizierung generiert.
- Das Authentifizierungskonto hat Zugriff auf Repositorys, Wiki-Seiten und Dokumentationsdateien.
- Die OAuth-Anwendung umfasst die folgenden Bereiche:
read_api,read_repository,read_user. - Benutzer, die auf indiziertes GitLab-Wissen zugreifen, verfügen über übereinstimmende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.
- Die Umleitungs-URL ist beim Erstellen der GitLab OAuth-Anwendung ordnungsgemäß konfiguriert:
-
Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback -
Microsoft 365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
-
Microsoft 365 Enterprise:
- Ihre GitLab-Version ist 17.7 oder höher.
- Der Microsoft Graph-Connector-Agent, Version 3.1.8.0 oder höher, wird auf einem Server mit Netzwerkzugriff auf die GitLab-instance installiert.
- API-Ratenlimits werden gemäß den GitLab-Empfehlungen für die Connectorleistung konfiguriert:
- Grenzwerte für Benutzer- und IP-Rate: Deaktivieren Sie die Option Authentifizierte API-Anforderungsratenbegrenzung aktivieren und Grenzwert für authentifizierte Webanforderungsraten aktivieren.
- Api-Ratenlimits für Dateien: Deaktivieren Sie das Kontrollkästchen Authentifizierte API-Anforderungsratenbegrenzung aktivieren.
- Veraltete API-Ratenlimits: Deaktivieren Sie das Kontrollkästchen Authentifizierte API-Anforderungsratenbegrenzung aktivieren.
- Api-Ratenlimits für Benutzer: Legen Sie max. Anforderungen pro 10 Minuten pro Benutzer auf einen hohen Wert fest (z. B. 100000).
- Gruppen-API-Ratenlimits: Legen Sie alle Werte auf 0 fest, um Grenzwerte zu deaktivieren.
- Api-Ratenlimits für Projekte: Legen Sie alle Werte auf 0 fest, um Grenzwerte zu deaktivieren.
- Api-Ratenlimits für Mitglieder: Auf 0 festgelegt.
Empfehlungen zum Ratenlimit
Verwenden Sie die Richtlinien in der folgenden Tabelle, um Einstellungen für die Ratenbegrenzung basierend auf der ungefähren Anzahl von GitLab-Wissenselementen auszuwählen.
| Ungefähre Anzahl von Elementen | Empfohlene Ratenbegrenzungseinstellung | Ungefähre Zeit bis zum Abschluss der Erfassung |
|---|---|---|
| Bis zu 100.000 | Erhöhen des Ratenlimits auf 9.000 Anforderungen/Stunde | Stunden bis einen Tag |
| 100.000 bis 1.000.000 | Erhöhen des Ratenlimits auf 15.000 Anforderungen/Stunde | Zwei Tage bis eine Woche |
| 1.000.000 oder mehr | Erhöhen des Ratenlimits auf 15.000 Anforderungen/Stunde | 1–2 Wochen (variiert je nach Umgebungslast) |
Bereitstellen des Connectors
So fügen Sie den GitLab Knowledge Server-Connector für Ihre organization hinzu:
- Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors >aus.
- Wählen Sie die Registerkarte Katalog aus.
- Wählen Sie in der Liste der verfügbaren Connectors GitLab Knowledge Server aus.
Festlegen des Anzeigenamens
Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, die zugeordnete Inhaltsquelle zu erkennen. Sie können den GitLab Knowledge Server-Standardnamen akzeptieren oder für Ihre organization anpassen.
Festlegen instance URL
Geben Sie die Basis-URL Ihrer GitLab Server-instance an. Diese URL ist der GitLab-Endpunkt, den der Connector verwendet, um über die GitLab-REST-APIs auf Dokumentations- und Repositoryinhalte zuzugreifen. Geben Sie die Stamm-URL Ihrer selbstverwalteten GitLab-Installation an (z. B https://gitlab.contoso.com. ).
Auswählen des Microsoft Graph-Connector-Agents
Wählen Sie den Microsoft Graph-Connector-Agent aus, der verwaltet, wie GitLab Knowledge-Daten in Microsoft 365 erfasst werden.
Auswählen des Authentifizierungstyps
Der GitLab Knowledge Server-Connector unterstützt die OAuth 2.0-Authentifizierung . Geben Sie die Client-ID und den geheimen Clientschlüssel aus Ihrer GitLab-Anwendung an, und wählen Sie dann Autorisieren aus.
Stellen Sie für die Einrichtung der GitLab-Anwendung sicher, dass das Authentifizierungskonto über ausreichend Repository- und Wiki-Zugriff verfügt, damit der Connector Inhalte durchforsten kann.
Rollout
Um den Connector für eine begrenzte Zielgruppe bereitzustellen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, für die die Verbindung bereitgestellt werden soll.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der GitLab Knowledge Server-Connector beginnt sofort mit der Indizierung von Inhalten.
In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden.
| Kategorie | Standardwert |
|---|---|
| Benutzer | Alle berechtigten Microsoft 365-Benutzer |
| Inhalt | Alle unterstützten GitLab-Wissensobjekte (Markdown, Wikis, Dokumentation) |
| Synchronisieren | Inkrementelle Durchforstung alle 15 Minuten; vollständige Durchforstung täglich |
Um diese Werte anzupassen, wählen Sie Benutzerdefiniertes Setup aus.
Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.
Anpassen von Einstellungen (optional)
Sie können die Standardwerte für GitLab Knowledge Server-Connectoreinstellungen anpassen. Um diese Werte anzupassen, öffnen Sie die Connectorseite im Admin Center, und wählen Sie Benutzerdefiniertes Setup aus.
Anpassen von Benutzereinstellungen
Zugriffsberechtigungen
Wählen Sie aus, ob indiziertes GitLab-Wissen für Folgendes sichtbar ist:
- Nur Personen mit Zugriff auf diese Datenquelle (Standard)
- Jeder
Wenn Sie die Standardoption auswählen, werden indizierte Inhalte nur für Benutzer mit GitLab-Zugriffsberechtigungen angezeigt. Wenn Sie Alle auswählen, werden die Inhalte für alle Benutzer über die Microsoft Search- und Copilot-Benutzeroberfläche Ihres organization sichtbar.
Zuordnen von Identitäten
Um sicherzustellen, dass GitLab-Berechtigungen berücksichtigt werden, ordnen Sie GitLab-Benutzeridentitäten Microsoft Entra ID zu, indem Sie eine der folgenden Aktionen verwenden:
- Benutzername
- Name
Wenn bei der direkten Zuordnung ein Fehler auftritt, verwenden Sie reguläre Ausdrücke (regex), um die Daten zu transformieren. Beispiel: [a-zA-Z0-9]+. Weitere Informationen finden Sie unter Zuordnen Microsoft Entra Identitäten.
Anpassen von Inhaltseinstellungen
Auf der Registerkarte Daten können Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibung und Zeitstempel überprüfen.
Eigenschaften verwalten
Sie können der Datenquelle verfügbare Eigenschaften hinzufügen oder daraus entfernen, der Eigenschaft ein Schema zuweisen (durchsuchbar, abfragbar, abrufbar oder verfeinernd), die semantische Bezeichnung ändern und der Eigenschaft einen Alias hinzufügen.
Anpassen von Synchronisierungsintervallen
Die folgenden Synchronisierungsintervalle sind verfügbar:
- Inkrementelle Durchforstung: Der Standardwert ist alle 15 Minuten.
- Vollständige Durchforstung: Der Standardwert ist täglich.
Sie können diese Intervalle an die Anforderungen Ihrer organization anpassen. Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.