Bereitstellen des GitHub Cloud Pull Requests Microsoft 365 Copilot Connector

Mit dem GitHub Cloud Pull Requests Microsoft 365 Copilot-Connector können Ihre organization Pull Requests, die in GitHub-Repositorys gespeichert sind, in Microsoft 365 Copilot- und Microsoft Search-Umgebungen indizieren. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des Connectors beschrieben. Allgemeine Informationen zur Bereitstellung des Copilot-Connectors finden Sie unter Einrichten von Copilot-Connectors im Microsoft 365 Admin Center.

Informationen zur erweiterten GitHub-Konfiguration finden Sie unter Einrichten des GitHub-Diensts für die Connectorerfassung.

Voraussetzungen

Stellen Sie vor der Bereitstellung des GitHub Cloud Pull Requests-Connectors sicher, dass die GitHub-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der GitHub-Umgebung und Bereitstellen des Connectors zusammengefasst.

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

• Sie sind ein Microsoft 365-Administrator.
• Auf Ihr GitHub-instance kann über die API zugegriffen werden.
• Eine GitHub-App wird erstellt und für die Authentifizierung konfiguriert.
• Das für die Authentifizierung verwendete Konto hat Zugriff auf die Repositorys und Pull Requests, die indiziert werden sollen.
• Benutzer, die auf indizierte GitHub-Daten zugreifen, verfügen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.

Bereitstellen des Connectors

So fügen Sie den GitHub Cloud Pull Requests-Connector für Ihre organization hinzu:

1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
2. Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
3. Wählen Sie in der Liste der verfügbaren Connectors GitHub Cloud Pull Requests aus.

Festlegen des Anzeigenamens

Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugeordnete Element erkennen können. Der Anzeigename steht auch für vertrauenswürdigen Inhalt und wird als Inhaltsquellenfilter verwendet.

Sie können den Standardmäßigen GitHub Cloud Pull Requests-Anzeigenamen übernehmen oder den Wert anpassen, um einen Anzeigenamen zu verwenden, den Benutzer in Ihrem organization erkennen.

Weitere Informationen zu Anzeigenamen und Beschreibungen von Connectors finden Sie unter Verbessern der Copilot-Ermittlung mit Microsoft 365 Copilot Connectorinhalten.

Auswählen des Authentifizierungstyps

Der Connector unterstützt die folgenden Authentifizierungstypen:

• OAuth (empfohlen):So verwenden Sie die OAuth-Authentifizierung:

  • Installieren Sie die GitHub-App GitHub Issues im GitHub-organization.
  • Wählen Sie einen Anzeigenamen aus, mit dem Benutzer die Verbindung erkennen können.
  • Geben Sie Ihren organization Namen ein.
  • Wählen Sie Autorisieren aus, um sich anzumelden und Zugriff zu gewähren.

  Hinweis

  Diese Authentifizierungsmethode befindet sich derzeit in der Vorschauphase.

• Angepasste GitHub-App (im Namen des Benutzers): Geben Sie Ihre Client-ID und ihren geheimen Clientschlüssel aus der GitHub-App ein, und autorisieren Sie den Zugriff.

• Angepasste GitHub-App (Installation):Verwenden Sie einen privaten Schlüssel, der aus Ihrer GitHub-App generiert wird. Geben Sie die Client-ID und organization Namen ein, und laden Sie den privaten Schlüssel hoch.

Informationen zum Erstellen einer GitHub-App finden Sie unter Verwenden einer benutzerdefinierten GitHub-App für die Authentifizierung.

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 GitHub Cloud Pull Requests Copilot-Connector beginnt sofort mit der Indizierung von Inhalten.

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

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 Cloud 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

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

• 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

Ordnen Sie GitHub-Benutzeridentitäten Microsoft Entra ID zu, um eine korrekte Berechtigungserzwingung sicherzustellen. Es folgen Beispiele:

• 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]+

Wenn der organization Administrator Standardberechtigungen für Mitglieder festlegt, um den Repositoryzugriff einzuschränken, berücksichtigt der Connector diese Einstellung. Benutzer können organization Repositorys nur anzeigen, wenn sie explizit als Mitarbeiter hinzugefügt werden.

Für Unternehmen, die anstelle von ENTERPRISE Managed Users (EMU) das BYOK-Modell (Bring Your Own Key) verwenden, muss jeder Benutzer die Berechtigung zum Freigeben des erforderlichen Identitätsfelds in seinen GitHub-Kontoeinstellungen aktivieren. Dieser Schritt stellt eine ordnungsgemäße Identitätszuordnung zwischen GitHub und dem Verzeichnis Ihrer organization sicher.

Anpassen von Inhaltseinstellungen

Auf der Registerkarte Inhalt können Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibungen und Zeitstempel überprüfen.

Zeitbereichsfilter

Sie können einen Zeitbereichsfilter konfigurieren. Die Standardeinstellung ist 365 Tage.

Eigenschaften verwalten

Sie können Eigenschaften hinzufügen oder entfernen, Schemaattribute zuweisen und semantische Bezeichnungen definieren. Die folgenden Eigenschaften sind standardmäßig indiziert.

Anpassen von Synchronisierungsintervallen

Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten synchronisiert werden. Sie können die folgenden Standardwerte anpassen:

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

Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Verwandte Inhalte

• Übersicht über den GitHub Cloud Pull Requests-Connector
• Behandeln von Problemen mit dem GitHub Cloud Pull Requests-Connector
• Einrichten von Copilot-Connectors im Microsoft 365 Admin Center