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 repozytorium prywatnego wymaga, aby administrator organizacji GitHub zainstalował aplikację Databricks GitHub Connector.

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 One lub Genie Code z GitHubem, użyj łącznika zewnętrznego Databricks. Zobacz Używaj natywnych konektorów dla źródeł danych firm trzecich oraz Podłącz Genie One do zewnętrznych narzędzi i źródeł. W przypadku repozytoriów prywatnych administratorzy muszą włączyć dostęp.

Zarejestruj niestandardowy serwer GitHub MCP (niezalecane)

Pomiń tę sekcję, jeśli twoja przestrzeń robocza Azure Databricks ma już dostępną usługę MCP GitHub Unity Catalog do użycia. Jeśli potrzebujesz dostępu tylko do publicznych repozytoriów i informacji o własnym koncie, użyj zarządzanego OAuth i przejdź do Rejestruj połączenie z Unity Catalog jako usługę MCP.

Postępuj zgodnie z poniższymi krokami, aby zarejestrować niestandardowy serwer MCP GitHub jako usługę MCP dostosowaną do Twoich specyficznych potrzeb związanych z danymi i bezpieczeństwem. Po pierwsze, wybierz, jak usługa MCP się uwierzytelnia:

  • Zarządzany OAuth: Databricks zarządza aplikacją GitHub OAuth oraz poświadczeniami uwierzytelniającymi. Pomiń aplikację GitHub i poniższe kroki dotyczące client secret, a następnie wybierz zarządzanego dostawcę podczas tworzenia połączenia.
  • Niestandardowy OAuth: Stwórz własną aplikację GitHub i podaj jej dane poświadczenia podczas tworzenia połączenia.

Utwórz aplikację GitHub (tylko własny OAuth)

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

    • Przejdź do Ustawienia profilu > Ustawienia dewelopera > GitHub Apps > i kliknij Nowa aplikacja GitHub.
    • 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żna go ustawić na dowolną preferowaną wartość.
      • Wyczyść pole wyboru Aktywne , aby adres URL elementu webhook był opcjonalnym polem.
    • 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ść.

Zarejestruj połączenie Unity Catalog jako usługę MCP

  1. Utworzyć lub ponownie użyć połączenia HTTP usługi Unity Catalog dla GitHub. Musisz mieć uprawnienia CREATE CONNECTION do tworzenia w tym schemacie. Jeśli ponownie używasz istniejącego połączenia, musisz mieć na nim USE CONNECTION. Kontynuuj rejestrację tego połączenia jako usługi MCP w kolejnym kroku. Dla nowego połączenia użyj jednej z następujących opcji uwierzytelniania:

    • Zarządzany OAuth: Wybierz typ uwierzytelniania OAuth User to Machine Per User oraz dostawcę OAuth GitHub. Databricks dostarcza host GitHub, ścieżkę bazową oraz poświadczenia OAuth.
    • Niestandardowy OAuth: Wybierz typ uwierzytelniania OAuth User to Machine Per User oraz dostawcę OAuth Manual configuration. Wprowadź następujące wartości:
      • Gospodarz: https://api.githubcopilot.com
      • Zakres OAuth: zakresy aplikacji. Na przykład mcp:access read:user user:email repo read:org
      • Sekret klienta i identyfikator klienta: wygenerowane w powyższych krokach aplikacji GitHub
      • 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
    • Kliknij pozycję Utwórz połączenie.

  2. Zarejestruj usługę MCP korzystającą z połączenia HTTP. Wymagane uprawnienia można znaleźć w artykule Zewnętrzne serwery MCP.

    • W swoim obszarze roboczym Azure Databricks przejdź do Katalogu, wybierz schemat i kliknij Utwórz>usługę MCP.
    • Wprowadź katalog, schemat i nazwę usługi MCP.
    • Wybierz połączenie HTTP, które stworzyłeś lub użyłeś ponownie, wybierz narzędzia do udostępnienia i kliknij Create.

  3. Jeśli wybrałeś OAuth dla użytkownika, otwórz usługę MCP w Eksploratorze katalogu i kliknij Zaloguj się, aby autoryzować swoje konto GitHub.

  4. Przyznaj użytkownikom lub grupom EXECUTE w usłudze MCP, a także USE CATALOG i USE SCHEMA w jej katalogu nadrzędnym i schemacie. Nie przyznawaj użytkownikom końcowym USE CONNECTION. Zobacz Udostępnij MCP.

Usługa GitHub MCP jest gotowa do użycia. Dodaj to do Genie Code.

  • Ostatnia aktualizacja o