Suche GitHub-Code mit Genie Code

Genie Code kann GitHub Repositorys durchsuchen, wenn Sie sie über den native Databricks GitHub Connector oder einen Custom GitHub MCP-Server verbinden. Verwenden Sie den nativen Connector für die meisten Fälle. Für den Zugriff auf private Repositorys ist ein GitHub Organisationsadministrator erforderlich, um die Databricks GitHub Connector-App zu installieren.

Verwenden des nativen Connectors (empfohlen)

Important

Dieses Feature befindet sich in der Betaversion. Um Datenquellen-Konnektoren von Drittanbietern zu verwenden, muss ein Arbeitsbereichsadmin die Vorschauversion Konnektoren von Drittanbietern für Agenten aktivieren. Siehe Manage Azure Databricks Previews.

Um Genie One oder Genie Code mit GitHub zu verbinden, verwenden Sie den Databricks-Drittanbieterconnector. Siehe Verwendung nativer Connectors für Datenquellen von Drittanbietern und Verbinden Sie Genie One mit externen Tools und Quellen. Für private Repositorys müssen Administratoren den Zugriff aktivieren.

Registrieren Sie einen benutzerdefinierten GitHub MCP-Server (nicht empfohlen)

Überspringen Sie diesen Abschnitt, wenn Ihr Azure Databricks Workspace bereits einen GitHub Unity Catalog MCP Service für Sie zur Nutzung verfügbar hat. Wenn du nur Zugriff auf öffentliche Repositories und die Informationen deines eigenen Kontos brauchst, nutze Managed OAuth und überspringe zu Eine Unity Catalog-Verbindung als MCP-Service registrieren.

Befolgen Sie die untenstehenden Schritte, um einen individuellen GitHub-MCP-Server als MCP-Dienst für Ihre spezifischen Daten- und Sicherheitsbedürfnisse zu registrieren. Wählen Sie zunächst, wie Ihr MCP-Dienst authentifiziert:

  • Managed OAuth: Databricks verwaltet die GitHub OAuth-App und die Zugangsdaten. Überspringen Sie die GitHub-App und die Client-Secret-Schritte unten und wählen Sie dann den verwalteten Anbieter aus, wenn Sie die Verbindung herstellen.
  • Benutzerdefiniertes OAuth: Erstellen Sie Ihre eigene GitHub-App und geben Sie deren Zugangsdaten an, wenn Sie die Verbindung erstellen.

Erstelle eine GitHub-App (nur benutzerdefiniertes OAuth)

  1. Erstelle eine GitHub-App. Für Unternehmenscodebasen muss ein GitHub Organisationsadministrator diesen Schritt ausführen.

    • Wechseln Sie zu Profil > Einstellungen > Entwicklereinstellungen > GitHub-Apps und klicken Sie auf Neue GitHub-App.
    • Füllen Sie die angeforderten Felder aus. Die Rückruf-URL sollte sein https://<your-databricks-workspace-url>/login/oauth/http.html. So authentifiziert GitHub sich bei Ihrem Databricks-Arbeitsbereich.
      • Die Homepage-URL wirkt sich nicht auf den MCP-Server aus und kann auf einen beliebigen Wert festgelegt werden.
      • Deaktivieren Sie das Kontrollkästchen "Aktiv ", um die Webhook-URL als optionales Feld festzulegen.
    • Gewähren Sie Ihrer GitHub App die erforderlichen Berechtigungen für den Zugriff auf Ihr Repository und Ihre Organisation.
    • Klicken Sie auf "GitHub-App erstellen".
  2. Klicken Sie in der neu erstellten App unter geheimen Clientschlüsseln auf "Neuen geheimen Clientschlüssel generieren". Kopieren Sie diesen Wert.

Registrieren Sie eine Unity-Catalog-Verbindung als MCP-Service

  1. Erstelle oder verwende eine HTTP-Verbindung im Unity Catalog für GitHub. Du musst CREATE CONNECTION Privilegien auf dem Schema haben, um eines zu erstellen. Wenn Sie eine bestehende Verbindung wiederverwenden, muss für diese die Berechtigung USE CONNECTION bestehen. Fahren Sie im nächsten Schritt damit fort, diese Verbindung als MCP-Dienst zu registrieren. Für eine neue Verbindung verwenden Sie eine der folgenden Authentifizierungsoptionen:

    • Managed OAuth: Wählen Sie den Authentifizierungstyp OAuth User to Machine Per User und den GitHub-OAuth-Anbieter aus. Databricks stellt den GitHub-Host, den Basispfad und die OAuth-Zugangsdaten bereit.
    • Benutzerdefiniertes OAuth: Wählen Sie den Authentifizierungstyp OAuth User to Machine Per User und den OAuth-Provider Manual configuration. Geben Sie die folgenden Werte ein:
      • Gastgeber: https://api.githubcopilot.com
      • OAuth-Bereich: Die Bereiche Ihrer App. Beispiel: mcp:access read:user user:email repo read:org
      • Client-Geheimnis und Client-ID: in den obigen Schritten der GitHub-App erstellt
      • Autorisierungsendpunkt: https://github.com/login/oauth/authorize
      • Tokenendpunkt: https://github.com/login/oauth/access_token
      • Basispfad: /mcp
    • Klicken Sie auf Verbindung herstellen.
  2. Registrieren Sie einen MCP-Service, der die HTTP-Verbindung verwendet. Für die erforderlichen Berechtigungen siehe Externe MCP-Server.

    • In Ihrem Azure Databricks-Arbeitsbereich gehen Sie zu Katalog, wählen Sie ein Schema aus und klicken Sie auf Erstellen>MCP Service.
    • Geben Sie den Katalog, das Schema und den Namen des MCP-Dienstes ein.
    • Wählen Sie die HTTP-Verbindung aus, die Sie erstellt oder wiederverwendet haben, wählen Sie die freizugebenden Tools aus und klicken Sie auf Erstellen.
  3. Wenn du pro Benutzer OAuth gewählt hast, öffne den MCP-Dienst im Catalog Explorer und klicke auf Login, um dein GitHub-Konto zu autorisieren.

  4. Gewähren Sie Benutzern oder Gruppen EXECUTE auf dem MCP-Dienst sowie USE CATALOG und USE SCHEMA auf dessen übergeordnetem Katalog und Schema. Gewähren Sie Endbenutzern keine USE CONNECTION Berechtigungen. Siehe Ein MCP teilen.

Ihr GitHub MCP-Dienst ist einsatzbereit. Füge es zu Genie Code hinzu.