Freigeben über

Bereitstellen des GitLab Issues Cloud Microsoft 365 Copilot-Connectors

Der GitLab Issues Cloud-Connector ermöglicht es Ihrem organization, in GitLab gespeicherte Probleme zu indizieren und in Microsoft 365 Copilot und Microsoft Search verfügbar zu machen. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des GitLab Issues Cloud-Connectors beschrieben.

Voraussetzungen

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

  • Vergewissern Sie sich, dass auf Ihr GitLab-instance über die GitLab-API zugegriffen werden kann.
  • Generieren Sie eine Client-ID und einen geheimen Clientschlüssel aus GitLab für die Authentifizierung.
  • Stellen Sie sicher, dass das Authentifizierungskonto Zugriff auf die Probleme (und die zugehörigen Projekte oder Repositorys) hat, die Sie indizieren möchten.
  • Stellen Sie sicher, dass die Client-ID und der geheime Clientschlüssel 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 Issues 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 Issues Cloud aus.

Festlegen des Anzeigenamens

Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, die zugeordnete Inhaltsquelle zu erkennen. Sie können den Standardmäßigen GitLab Issues Cloud-Anzeigenamen akzeptieren oder ihn an die Anforderungen Ihrer organization anpassen.

Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.

Festlegen instance URL

Geben Sie die GitLab-instance-URL an. Für GitLab Cloud lautet diese URL in der Regel:

https://gitlab.com

Auswählen des Authentifizierungstyps

Der Connector unterstützt OAuth 2.0 für GitLab.

So authentifizieren Sie sich:

  • Geben Sie die GitLab-Client-ID und den geheimen Clientschlüssel ein.
  • Wählen Sie Autorisieren aus.

Informationen zum Erstellen von OAuth-Apps in GitLab finden Sie unter Konfigurieren von GitLab als OAuth 2.0-Authentifizierungsidentitätsanbieter.

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. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der GitLab Issues 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 Zeitbereichsfilter: 365 Tage
Synchronisieren Inkrementelle Durchforstung: alle 15 Minuten
Vollständige Durchforstung: täglich

Um diese Werte anzupassen, wählen Sie Benutzerdefiniertes Setup aus. Weitere Informationen finden Sie unter Anpassen von Einstellungen.

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 Einstellungen des GitLab Issues Cloud-Connectors anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.

Anpassen von Benutzereinstellungen

Zugriffsberechtigungen

Wählen Sie aus, ob indizierte Daten für Folgendes sichtbar sind:

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

Zuordnen von Identitäten

Um sicherzustellen, dass Berechtigungen ordnungsgemäß angewendet werden, ordnen Sie GitLab-Benutzeridentitäten Microsoft Entra ID zu:

  • 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

Abfragezeichenfolge

Überprüfen oder bearbeiten Sie die Standardabfragezeichenfolge, um zu verfeinern, welche Elemente indiziert werden.

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. In der folgenden Tabelle sind Eigenschaften aufgeführt, die der Connector standardmäßig indiziert.

Eigenschaft Semantische Bezeichnung Beschreibung Schemaattribute
title Position Problemtitel Durchsuchbar, abrufbar
description Body Problembeschreibung Durchsuchbar, abrufbar
Etiketten Tags Problembezeichnungen Abfragbar, einschränkbar
Autor Ursprung Problemautor Durchsuchbar, abrufbar
created_at Erstellungsdatum Zeitstempel für die Erstellung Abfragbar, abrufbar
updated_at Änderungsdatum Zeitstempel für das letzte Update Abfragbar, abrufbar

Anpassen von Synchronisierungsintervallen

Sie können die vollständigen und inkrementellen Durchforstungsintervalle anpassen. Im Folgenden sind die Standardwerte aufgeführt:

  • Inkrementelle Durchforstung: Alle 15 Minuten.
  • Vollständige Durchforstung: Täglich.

Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Ratenbegrenzungen

In der folgenden Tabelle sind die Ratenlimits aufgeführt, die für den GitLab Issues Cloud-Connector gelten.

Ungefähre Anzahl von Elementen Ungefähre Zeit bis zum Abschluss der Erfassung
Bis zu 100.000 Stunden bis 0,5 Tag
100.000 bis 1.000.000 0,5 Tage bis 4 Tage
1.000.000 oder mehr 4 Tage bis 2 Wochen (variiert je nach Umgebungslast)

Verwandte Inhalte

  • Last updated on