Vyhledávání GitHub kódu pomocí Genie Code

Genie Code může prohledávat úložiště GitHub, když ho připojíte prostřednictvím nativního konektoru Databricks GitHub nebo >sousměrného GitHub serveru MCP. Ve většině případů použijte nativní konektor. Přístup k privátnímu úložišti vyžaduje, aby správce GitHub organizace nainstaloval aplikaci konektoru GitHub Databricks.

Použití nativního konektoru (doporučeno)

Important

Tato funkce je v beta verzi. Pokud chcete používat konektory zdroje dat třetích stran, musí správce pracovního prostoru povolit konektory třetích stran pro agenty ve verzi Preview. Viz Manage Azure Databricks preview.

Pokud chcete připojit Genie One nebo Genie Code k GitHub, použijte konektor třetí strany Databricks. Viz Použití nativních konektorů pro zdroje dat třetích stran a připojení Genie One k externím nástrojům a zdrojům. V případě privátních úložišť musí správci povolit přístup.

  • Nativní konektor používá výchozí systémové připojení Databricks. Chcete-li místo toho použít vlastní server GitHub MCP, přidejte ho ručně. Viz Ruční přidání serverů MCP do Kódu Genie.
  • Pokud chcete zlepšit odpovědi, přidejte pro každé úložiště osobní kontext, který vám pomůže GitHub vyhledávacím nástrojům porozumět základu kódu.

Zaregistrujte si vlastní GitHub MCP server (nedoporučuje se)

Přeskočte tuto sekci, pokud váš pracovní prostor Azure Databricks už má k dispozici MCP službu GitHub Unity Catalog, kterou můžete použít. Pokud potřebujete přístup pouze k veřejným repozitářům a informacím o svém vlastním účtu, použijte spravovaný OAuth a přeskočte na Registrovat připojení k Unity Catalog jako službu MCP.

Postupujte podle níže uvedených kroků k registraci vlastního GitHub MCP serveru jako MCP služby pro vaše konkrétní potřeby dat a bezpečnosti. Nejprve si zvolte, jak se vaše služba MCP autentizuje:

  • Spravované OAuth: Databricks spravuje aplikaci GitHub OAuth a přihlašovací údaje. Přeskočte níže uvedenou aplikaci GitHub a kroky s klientským tajemstvím, poté při vytváření připojení vyberte spravovaný poskytovatel.
  • Vlastní OAuth: Vytvořte si vlastní aplikaci na GitHubu a při vytváření připojení zadejte její přístupové údaje.

Vytvořte aplikaci na GitHub (pouze vlastní OAuth)

  1. Vytvořte aplikaci GitHub. V případě podnikových základů kódu musí tento krok dokončit správce organizace GitHub.

    • Přejděte na Nastavení >> profilu > Pro vývojáře GitHub Aplikace a klikněte na Nová GitHub Aplikace.
    • Vyplňte požadovaná pole. Adresa URL zpětného volání by měla být https://<your-databricks-workspace-url>/login/oauth/http.html. Takto se GitHub ověřuje vůči vašemu pracovnímu prostoru Databricks.
      • Adresa URL domovské stránky nemá vliv na server MCP a je možné ji nastavit na libovolnou hodnotu, kterou dáváte přednost.
      • Zrušte zaškrtnutí políčka Aktivní , aby adresa URL webhooku byla nepovinným polem.
    • Udělte aplikaci GitHub potřebná oprávnění pro přístup k úložišti a organizaci.
    • Klikněte na Vytvořit aplikaci GitHub.

  2. V nově vytvořené aplikaci v části Tajné kódy klienta klikněte na Vygenerovat nový tajný klíč klienta. Zkopírujte tuto hodnotu.

Zaregistrujte spojení Unity Catalog jako MCP službu

  1. Vytvořte nebo znovu použijte HTTP připojení Unity Catalog pro GitHub. Musíte mít CREATE CONNECTION oprávnění ke schématu, abyste jej mohli vytvořit. Pokud znovu použijete existující připojení, musíte na něm mít USE CONNECTION. V dalším kroku pokračujte v registraci tohoto připojení jako MCP služby. Pro nové připojení použijte jednu z následujících možností autentizace:

    • Spravované OAuth: Vyberte typ autentizace OAuth User to Machine Per User a poskytovatele OAuth GitHub. Databricks poskytuje hostitele GitHubu, základní cestu a přihlašovací údaje OAuth.
    • Vlastní OAuth: Vyberte typ ověření OAuth User to Machine Per User a poskytovatele OAuth Ruční konfigurace. Zadejte následující hodnoty:
      • Hostitel: https://api.githubcopilot.com
      • Rozsah OAuth: Obory vaší aplikace. Například mcp:access read:user user:email repo read:org
      • Tajný klíč klienta a ID klienta: generováno v krocích aplikace GitHub výše
      • Koncový bod autorizace: https://github.com/login/oauth/authorize
      • Koncový bod tokenu: https://github.com/login/oauth/access_token
      • Základní cesta: /mcp
    • Klikněte na Vytvořit připojení.

  2. Zaregistrujte MCP službu, která používá HTTP připojení. Informace o požadovaných oprávněních viz Externí servery MCP.

    • Ve vašem pracovním prostoru Azure Databricks přejděte do Catalog, vyberte schéma a klikněte na Vytvořit>MCP službu.
    • Zadejte katalog, schéma a název služby MCP.
    • Vyberte HTTP připojení, které jste vytvořili nebo znovu použili, vyberte nástroje pro vystavení a klikněte na Vytvořit.

  3. Pokud jste zvolili OAuth pro uživatele, otevřete službu MCP v Průzkumníku katalogu a klikněte na Přihlásit se, abyste autorizovali svůj účet GitHub.

  4. Udělit uživatelům nebo skupinám EXECUTE ve službě MCP, plus USE CATALOG a USE SCHEMA v jejím nadřazeném katalogu a schématu. Neposkytujte koncovým uživatelům USE CONNECTION. Vizte Sdílení MCP.

Vaše GitHub MCP služba je připravena k použití. Přidejte to do Genie Code.

  • Poslední aktualizace v