Freigeben über

Bereitstellen des GitLab Knowledge Cloud Microsoft 365 Copilot-Connectors

Der GitLab Knowledge Cloud Microsoft 365 Copilot-Connector ermöglicht es Ihren organization, in GitLab gespeicherte Dokumentationen, Wikis und Wissensartefakte 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 Cloud-Connectors beschrieben.

Voraussetzungen

Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Sie müssen ein Microsoft 365-Administrator sein.
  • Vergewissern Sie sich, dass auf Ihr GitLab-instance über die API zugegriffen werden kann.
  • Generieren Sie eine Client-ID und einen geheimen Clientschlüssel aus GitLab.
  • Stellen Sie sicher, dass das Authentifizierungskonto Zugriff auf Repositorys, Wikis, Runbooks, Dokumentation und Wissensdateien hat.
  • Die Client-ID und der geheime Clientschlüssel müssen die folgenden Bereiche enthalten:
    • read_api
    • read_repository
    • read_user
  • Benutzer, die auf indizierte GitLab-Daten zugreifen, müssen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung verfügen.
  • Legen Sie die entsprechenden Umleitungs-URLs während der Einrichtung der GitLab-Authentifizierung fest:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback

Bereitstellen des Connectors

So fügen Sie den GitLab Knowledge Cloud-Connector für Ihre organization hinzu:

  1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
  2. Wählen Sie die Registerkarte Katalog aus.
  3. Wählen Sie in der Liste der verfügbaren Connectors GitLab Knowledge Cloud aus.

Festlegen des Anzeigenamens

Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, die Inhaltsquelle zu erkennen. Sie können den Standardmäßigen GitLab Knowledge Cloud-Anzeigenamen übernehmen oder anpassen.

Auswählen des Authentifizierungstyps

Der GitLab Knowledge Cloud-Connector unterstützt die OAuth 2.0-Authentifizierung . Wählen Sie OAuth 2.0 aus, geben Sie Ihre Client-ID und ihren geheimen Clientschlüssel ein, und wählen Sie Autorisieren aus.

Rollout

Um das Rollout für eine begrenzte Zielgruppe durchzuführen, 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 der Connector rollout ausgeführt werden soll. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der GitLab Knowledge Cloud-Connector beginnt sofort mit der Indizierung von Inhalten.

In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden.

Kategorie Standardwert
Benutzer Nur Personen mit Zugriff auf diese Datenquelle
Inhalt Inhalt der letzten 365 Tage indiziert
Synchronisieren Inkrementell: 15 Minuten; Vollständig: 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 die GitLab Knowledge Cloud-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.

Anpassen von Benutzereinstellungen

Zugriffsberechtigungen

Gehen Sie gemäß einer der folgenden Optionen vor:

  • Nur Personen mit Zugriff auf diese Datenquelle (Standard)
  • Jeder

Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die Zugriff darauf haben. Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt.

Zuordnen von Identitäten

Um sicherzustellen, dass Berechtigungen ordnungsgemäß angewendet werden, ordnen Sie GitLab-Benutzeridentitäten Microsoft Entra ID zu. Wählen Sie eine der folgenden Optionen für die Zuordnung aus:

  • Email: Ordnet GitLab-E-Mails Microsoft Entra ID Benutzereigenschaften zu.
  • Einloggen: Ordnet GitLab-Anmeldungen Microsoft Entra ID Benutzereigenschaften zu.
  • Namen: Ordnet gitLab-Namen Microsoft Entra ID Benutzereigenschaften zu.

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.

Inhaltsfilter

Sie können einen Zeitbereichsfilter für den Connector konfigurieren. Die Standardeinstellung ist 365 Tage.

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

Konfigurieren sie Synchronisierungsintervalle für vollständige und inkrementelle Durchforstungen:

  • 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.

In der folgenden Tabelle sind die Ratenlimits für die Inhaltserfassung des GitLab Knowledge Cloud-Connectors aufgeführt.

Ungefähre Anzahl von Elementen Ungefähre Zeit bis zum Abschluss der Erfassung
Bis zu 100.000 Innerhalb von 6 Stunden
100.000 bis 1.000.000 6 Stunden bis 3 Tage
1.000.000 oder mehr 3 Tage bis 2 Wochen (variiert je nach Umgebungslast)

Verwandte Inhalte

  • Last updated on