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.
Mit dem GitHub Cloud Knowledge Connector können Organisationen Markdown- und Textdateien aus GitHub-Repositorys 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 Knowledge Connectors sicher, dass die GitHub Cloud-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der Umgebung und Bereitstellen des Connectors zusammengefasst.
| Aufgabe | Rolle |
|---|---|
| Konfigurieren der Umgebung | GitHub-Administrator |
| Bereitstellen des Connectors | Microsoft 365 Admin |
| Anpassen der Connectoreinstellungen (optional) | Microsoft 365 Admin |
Stellen Sie vor der Bereitstellung des GitHub Cloud Knowledge-Connectors Folgendes sicher:
- Sie sind Microsoft 365-Administrator für Ihre organization.
- Auf Ihr GitHub-instance kann über die API zugegriffen werden.
- Eine GitHub-App wird erstellt und für die Authentifizierung konfiguriert.
- Benutzer, die auf indizierte GitHub-Daten zugreifen, verfügen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.
- Für unternehmensverwaltete Benutzer, die sich über einmaliges Anmelden (Single Sign-On, SSO) authentifizieren, wird das Konto vor dem Setup angemeldet. Der GitHub-Authentifizierungsflow unterstützt SSO nicht.
Bereitstellen des Connectors
So fügen Sie den GitHub Cloud Knowledge 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 Cloud Knowledge aus.
Festlegen des Anzeigenamens
Der Anzeigename identifiziert Verweise in Copilot-Antworten und gibt vertrauenswürdigen Inhalt an. Sie können den Standardmäßigen Anzeigenamen von GitHub Cloud Knowledge übernehmen oder einen Namen auswählen, den Benutzer in Ihrem organization erkennen.
Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.
Festlegen instance URL
Geben Sie die GitHub-organization-URL ein, die der Connector indiziert. Zum Beispiel:
https://github.com/<organization-name>
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. Weitere Informationen finden Sie unter Gestaffelter Rollout für Microsoft 365 Copilot Connectors.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der GitHub Cloud Knowledge 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 | Markdown- und Textdateien aus ausgewählten Repositorys |
| 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 Cloud Knowledge Connector-Einstellungen 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 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.
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.
Wählen Sie die Repositorys und Dateitypen (Markdowndateien, Textdokumente) aus, die Sie durchsuchbar machen möchten.
Eigenschaften verwalten
Sie können Eigenschaften hinzufügen oder entfernen, Schemaattribute zuweisen und semantische Bezeichnungen definieren. Die folgenden Eigenschaften werden standardmäßig indiziert:
| Eigenschaft | Semantische Bezeichnung | Beschreibung | Schemaattribute |
|---|---|---|---|
| Dateiname | Position | Name der Datei | Durchsuchbar, abrufbar |
| Repository | Quelle | GitHub-Repositoryname | Durchsuchbar, abfragbar |
| Inhalt | Body | Markdown- oder Textdateiinhalt | Durchsuchbar, abrufbar |
Anpassen von Synchronisierungsintervallen
Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten synchronisiert werden. Standardwerte:
- Inkrementelle Durchforstung: Alle 15 Minuten
- Vollständige Durchforstung: Täglich
Sie können diese Werte nach Bedarf ändern. Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.
Hinweis
Webhookunterstützung ist jetzt in der Vorschau verfügbar. Achten Sie darauf, die Webhooks-Berechtigungen (Lesen und Schreiben) sowohl auf Repository- als auch auf Organisationsebene festzulegen. Webhooks ermöglichen es Ihnen, die Vorteile der erweiterten Automatisierung und Echtzeitupdates zu nutzen, um eine nahtlose und reaktionsschnellere Integration zu gewährleisten.