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 GitHub Server Pull Requests Microsoft 365 Copilot Connector integriert Pull Request-Metadaten von GitHub Enterprise Server in Microsoft 365. Nach der Bereitstellung indiziert der Connector PR-Titel, Beschreibungen, Bezeichnungen, Zeitstempel, Autoren, Prüfer, Meilensteine und Repositorykontext, damit Benutzer PR-Erkenntnisse mithilfe von Microsoft 365 Copilot, Copilot Search und Microsoft Search suchen, zusammenfassen und abrufen können.
In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des GitHub Server Pull Requests-Connectors beschrieben.
Erweiterte Informationen zur GitHub-Dienstkonfiguration finden Sie unter
Richten Sie den GitHub-Dienst für die Erfassung des GitHub Server Pull Requests-Connectors ein.
Voraussetzungen
Stellen Sie vor der Bereitstellung des GitHub Server Pull Requests-Connectors sicher, dass die GitHub Enterprise Server-Umgebung für die Erfassung konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der GitHub-Dienstumgebung und zum Bereitstellen des Connectors zusammengefasst.
| Aufgabe | Rolle |
|---|---|
| Konfigurieren der Umgebung | GitHub-Administrator |
| Bereitstellen des Connectors im Microsoft 365 Admin Center | Microsoft 365 Admin |
| Anpassen der Connectoreinstellungen (optional) | Microsoft 365 Admin |
Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Sie müssen ein Microsoft 365-Administrator sein.
- Auf Ihre GitHub Enterprise Server-instance muss über die API zugegriffen werden können.
- Die GitHub-App muss vollständig konfiguriert und im Ziel-organization installiert sein.
- Der Microsoft Graph Connector-Agent muss auf einem Gerät mit Zugriff auf Ihre GitHub-instance (Version 3.1.11.0 oder höher) installiert sein.
- Das für die Authentifizierung verwendete Benutzerkonto muss Zugriff auf die Repositorys und Pull Requests haben, die indiziert werden sollen.
- Benutzer, die auf indizierte PR-Daten zugreifen, müssen über Microsoft Entra ID Identitäten verfügen, um die Berechtigungszuordnung zu aktivieren.
Bereitstellen des Connectors
So fügen Sie den GitHub Server Pull Requests-Connector für Ihre organization hinzu:
- Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
- Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
- Wählen Sie in der Liste der verfügbaren Connectors GitHub Server Pull Requests aus.
Festlegen des Anzeigenamens
Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer Inhaltsquellen erkennen können. Sie können den Standardnamen GitHub Server Pull Requests beibehalten oder durch einen benutzerdefinierten Anzeigenamen ersetzen, der für Ihre organization relevant ist.
Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.
Festlegen instance URL
Geben Sie die instance URL Ihres GitHub Enterprise Servers ein. Zum Beispiel:
https://github.<yourdomain>.com
Der Connector verwendet diese URL, um PR-Metadaten während der Erfassung anzufordern.
Auswählen des Authentifizierungstyps
Der GitHub Server Pull Requests-Connector unterstützt die folgenden Authentifizierungstypen:
GitHub-App (im Namen des Benutzers):
- Geben Sie die Client-ID und den geheimen Clientschlüssel Ihrer GitHub-App ein.
- Autorisieren des Zugriffs.
- Empfohlen, wenn Sie separate Benutzerkonten für die Ratenbegrenzungsisolation verwenden.
GitHub-App (Installation):
- Generieren Sie einen privaten Schlüssel über die GitHub-App-Konfigurationsseite.
- Geben Sie die Client-ID und organization Namen ein, und laden Sie den privaten Schlüssel hoch.
Hinweis
Dieser Authentifizierungstyp befindet sich derzeit in der Vorschauphase. Wenden Sie sich an den Microsoft-Support, um diesen Authentifizierungstyp zu verwenden.
Rollout
Um den Connector für eine eingeschränkte Zielgruppe bereitzustellen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, die frühzeitigen Zugriff haben sollen. Weitere Informationen finden Sie unter
Gestaffelter Rollout für Copilot-Connectors.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der Connector beginnt sofort mit der Indizierung von Inhalten.
In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden.
| Kategorie | Standardwert |
|---|---|
| Benutzer | Die Identitätszuordnung ist über Email-, Anmelde- und Namensoptionen verfügbar. |
| Inhalt | Vollständige PR-Metadaten; Standardzeitbereichsfilter: 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 GitHub Server Pull Requests-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.
Anpassen von Benutzereinstellungen
Zugriffsberechtigungen
Der Zugriff auf PR-Daten berücksichtigt die GitHub-App-Berechtigungen und GitHub-Repository-Zugriffssteuerungen.
Zuordnen von Identitäten
Ordnen Sie GitHub-Benutzeridentitäten Microsoft Entra ID zu, um sicherzustellen, dass Berechtigungen ordnungsgemäß angewendet werden. Wählen Sie eine der folgenden Optionen für die Zuordnung aus:
- Email: Ordnet GitHub-E-Mails Microsoft Entra ID Benutzereigenschaften zu.
- Einloggen: Ordnet GitHub-Anmeldungen mit Microsoft Entra ID Benutzereigenschaften zu.
- Namen: Ordnet gitHub-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
Geben Oder verfeinern Sie die Abfrageparameter, die zum Filtern oder Identifizieren von Pull Request-Inhalten verwendet werden.
Eigenschaften verwalten
In der folgenden Tabelle werden die Eigenschaften beschrieben, die der Connector standardmäßig indiziert.
| Eigenschaft | Semantische Bezeichnung | Beschreibung | Schemaattribute |
|---|---|---|---|
| Position | Titel | Pull Request-Titel | Text |
| Beschreibung | Body | PR-Beschreibung | Text |
| Labels | Tags | Pull Request-Bezeichnungen | Auflistung |
| State | Status | Geöffneter/geschlossener Zustand | Enum |
| Ursprung | Ursprung | PR-Ersteller | Benutzer |
| Prüfer | Prüfer | Zugewiesene Prüfer | Auflistung |
| Zugewiesene Personen | Besitzer | Zugewiesene Mitwirkende | Auflistung |
| Meilensteine | Milestone | Zielmeilenstein | Text |
| Zeitstempel | Zeitstempel | Erstellungs-/Aktualisierungszeiten | DateTime |
Anpassen von Synchronisierungsintervallen
Zwei Durchforstungstypen sind verfügbar:
- Inkrementelle Durchforstung: Wird standardmäßig alle 15 Minuten ausgeführt.
- Vollständige Durchforstung: Wird täglich ausgeführt, um den PR-Index zu aktualisieren.
Sie können diese Werte an die Anforderungen Ihrer organization anpassen. Weitere Informationen finden Sie unter
Richtlinien für Synchronisierungseinstellungen.