Wyszukiwanie kodu GitHub za pomocą kodu Genie

Genie Code może przeszukiwać repozytoria GitHub po połączeniu go za pośrednictwem natywnego łącznika GitHub usługi Databricks lub niestandardowego serwera MCP dla GitHub. W większości przypadków należy używać łącznika natywnego. Dostęp do prywatnego repozytorium wymaga, aby administrator organizacji GitHub zainstalował aplikację Databricks GitHub Connector.

Uwaga / Notatka

Serwery MCP są obsługiwane tylko w trybie agenta kodu Genie.

Używanie łącznika natywnego (zalecane)

Important

Ta funkcja jest dostępna w wersji beta. Aby korzystać z łączników źródeł danych innych firm, administrator obszaru roboczego musi włączyć Łączniki innych firm dla agentów w trybie podglądu. Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Aby połączyć Genie lub Genie Code z GitHub, użyj natywnego łącznika Databricks do usług innych firm. Zobacz Używanie łączników natywnych dla źródeł danych innych firm i Dodawanie źródła danych do konwersacji. W przypadku repozytoriów prywatnych administratorzy muszą włączyć dostęp.

Włączanie dostępu do repozytorium prywatnego

Domyślne połączenie systemowe usługi Databricks dla GitHub może uzyskiwać dostęp tylko do repozytoriów publicznych. Aby przyznać połączeniu uprawnienia do odczytu prywatnych repozytoriów firmowych, administrator organizacji GitHub musi wykonać następujące czynności:

  1. Zainstaluj aplikację Databricks GitHub connector app w swojej organizacji GitHub, aby aplikacja miała dostęp do odczytu do prywatnych repozytoriów.

  2. Dodaj wychodzące adresy IP bezserwerowego środowiska Databricks do listy dozwolonych dla chmury i regionu obszaru roboczego. Aby uzyskać listę adresów IP, zobacz IP adresy i domeny Azure Databricks usług i zasobów. Aby uzyskać instrukcje dotyczące konfigurowania dozwolonych adresów IP dla organizacji GitHub, zobacz Zarządzanie dozwolonymi adresami IP organizacji.

Po zakończeniu konfiguracji administratora użytkownicy w organizacji mogą uzyskiwać dostęp do prywatnych repozytoriów przy użyciu domyślnego połączenia systemu usługi Databricks.

Pomiń tę sekcję, jeśli w obszarze roboczym Databricks jest już dostępne połączenie usługi GitHub w katalogu Unity Catalog. Jeśli potrzebujesz tylko dostępu do repozytoriów publicznych i informacji o własnym koncie, przejdź do kroku 3.

Wykonaj poniższe kroki, aby utworzyć niestandardowy serwer GitHub MCP. Dzięki temu można skonfigurować serwer do określonych potrzeb związanych z danymi i zabezpieczeniami.

  1. Na koncie GitHub utwórz aplikację GitHub. W przypadku baz kodu przedsiębiorstwa administrator organizacji GitHub musi wykonać ten krok.

    • Przejdź do Profile > Settings > Ustawienia dewelopera > GitHub Apps i kliknij Nowy GitHub App.
    • Wypełnij żądane pola. Adres URL wywołania zwrotnego powinien mieć wartość https://<your-databricks-workspace-url>/login/oauth/http.html. W ten sposób GitHub uwierzytelnia się w Twoim obszarze roboczym Databricks.
      • Adres URL strony głównej nie ma wpływu na serwer MCP i może być ustawiony na dowolną preferowaną wartość
      • Usuń zaznaczenie pola "aktywne", aby ustawić adres URL elementu webhook jako pole opcjonalne
    • Przyznaj aplikacji GitHub niezbędne uprawnienia dostępu do repozytorium i organizacji.
    • Kliknij pozycję Utwórz aplikację GitHub.

  2. W nowo utworzonej aplikacji w obszarze Wpisy tajne klienta kliknij pozycję Generuj nowy klucz tajny klienta. Skopiuj tę wartość.

  3. Utwórz nowe połączenie Unity Catalog dla serwisu GitHub. Musisz mieć CREATE CONNECTION uprawnienia.

    • Jeśli w obszarze roboczym jest już zainstalowany zasób, możesz użyć istniejącego zasobu, o ile masz na nim uprawnienia dostępu USE CONNECTION.
    • Wypełnij następujące pola:
      • Typ połączenia: HTTP
      • Typ uwierzytelniania: OAuth User to Machine
      • Dostawca OAuth: Manual configuration
        • Jeśli potrzebujesz tylko dostępu do repozytoriów publicznych i informacji o własnym koncie, wybierz Github MCP tutaj i pomiń pozostałe kroki.
      • Gospodarz: https://api.githubcopilot.com
      • Zakres OAuth: zakresy aplikacji. Na przykład mcp:access read:user user:email repo read:org
      • Klucz tajny klienta i identyfikator klienta: wygenerowany z kroku 2
      • Punkt końcowy autoryzacji: https://github.com/login/oauth/authorize
      • Punkt końcowy tokenu: https://github.com/login/oauth/access_token
      • Ścieżka podstawowa: /mcp
      • Czy mcp jest połączony: checked
    • Kliknij pozycję Utwórz połączenie.

  4. W prawym górnym rogu kliknij pozycję Zaloguj się, aby zalogować się do połączenia. Spowoduje to otwarcie nowego okna z monitem o autoryzowanie aplikacji GitHub do konta usługi Databricks. Kliknij pozycję połączenie na koncie GitHub, z którym chcesz nawiązać połączenie.

Twoja GitHub MCP jest teraz gotowa do użycia. Dodaj go do kodu Genie jako zewnętrznego serwera MCP.

  • Last updated on