Připojení kódu Genie k serverům MCP

Genie Code se připojuje k externím nástrojům, dokumentům a datům prostřednictvím serverů MCP (Model Context Protocol) a nativních konektorů pro Disk Google, SharePoint, GitHub, Glean, Atlassian a Slack. Použijte nativní konektory pro běžné zdroje SaaS nebo přidejte vlastní externí nebo vlastní servery MCP z pracovního prostoru. Přístup MCP je omezený na 20 nástrojů na všech serverech; zvolíte nástroje, které se mají povolit v nastavení Genie Code.

Co je MCP?

MCP je open source standard, který připojuje agenty AI k nástrojům, prostředkům, výzvám a dalším kontextovým informacím. MCP poskytuje standardizovaný způsob, jak zpřístupnit nástroje, data a pracovní postupy genie Code bez vložení kontextu přímo do výzev nebo pokynů.

MCP je navržený pro případy, kdy už existuje důležitý kontext, ale je obtížné získat přístup od agenta umělé inteligence, jako je Genie Code. MCP nabízí bezpečný způsob, jak poskytnout Genie Code přístup k kontextu, jako je následující:

  • Systémy dokumentace: Teams často udržuje runbooky nebo provozní dokumenty v nástrojích, jako je Confluence. Místo kopírování oddílů do výzev je možné tento obsah vystavit jednou prostřednictvím externího serveru MCP a odkazovat na něj, pokud je to relevantní. Vaše dokumenty už také mohou být v Databricks ve formě indexu AI Search, který může Genie Code použít k vyhledávání relevantních dokumentů.
  • Nástroje a služby: Týmy platforem můžou udržovat rozhraní API nebo skripty pro nastavení, ověření nebo nasazení. MCP tyto funkce zpřístupňuje přímo Genie Code.
  • Zdroje dat: Pokud už data v Databricks máte, můžete Genie Code připojit k agentovi Genie, který vám pomůže analyzovat data pomocí přirozeného jazyka. U dat uložených mimo Databricks můžete genie Code poskytnout zabezpečený přístup prostřednictvím externích serverů MCP.
  • Vlastní aplikace: Můžete také přidat vlastní funkce hostované prostřednictvím Databricks Apps. Díky tomu můžete Genie Code připojit k proprietárním nástrojům, pracovním postupům nebo integracím vytvořeným speciálně pro vás nebo vaši organizaci, které jsou spravovány bezpečně v rámci vašeho pracovního prostoru Databricks.

V těchto případech MCP nahrazuje ruční vkládání kopírování strukturovaným, opakovaně použitelným přístupem a zpřístupňuje správný kontext pouze v případě, že je potřeba.

Genie Code můžete připojit k libovolnému serveru MCP ve vašem pracovním prostoru, ke kterému máte oprávnění. Správci pracovních prostorů určují, které servery jsou dostupné, zatímco uživatelé můžou podle potřeby vybírat z těchto schválených zdrojů.

Další informace o serverech MCP v Databricks a o tom, jak vytvořit vlastní, najdete v tématu Model Context Protocol (MCP) na Azure Databricks.

Použití nativních konektorů pro zdroje dat třetích stran

Důležité

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.

Genie Code poskytuje integrované konektory pro běžné firemní zdroje dat, včetně Google Drive, SharePointu, GitHubu, Gleanu, Atlassianu a Slacku.

Připojení k těmto zdrojům dat umožňuje Genie Code prohledávat dokumenty při odpovídání na otázky. Každý uživatel se ověřuje jednotlivě a tokeny OAuth se mezi uživateli nesdílí.

Připojení zdroje dat třetí strany:

  1. V pracovním prostoru klikněte na ikonu kódu Sparkle Genie. Genie Code v pravém horním rohu a otevře chat.
  2. Na panelu výzvy klikněte na ikonu Nový. Ikona plus.
  3. Vedle zdroje dat, ke kterému se chcete připojit, klikněte na Připojit.
  4. Dokončete kroky pro přihlášení.

Po ověření může Genie Code při odpovídání na otázky prohledávat vaše dokumenty. Správci metastoru a vlastníci připojení můžou spravovat nebo odvolávat uživatelská oprávnění k připojení. Viz Udělení přístupu členům týmu.

Poznámka:

Nástroje pro zdroje dat se neaktivují vždy automaticky. Pokud se vyhledávání dokumentu nespustí, zkuste explicitně vyzvat Genie Code, aby nástroj používal, například "use Google Docs" nebo "use SharePoint" (použít SharePoint).

Pokud chcete připojit další zdroje dat, přidejte je ručně do Genie Code. Viz Ruční přidání serverů MCP do Kódu Genie.

Omezení disku Google

  • Při povolení Disku Google se může zobrazit obrazovka s varováním "neověřená aplikace". Klikněte na Upřesnit a pokračujte v procesu autorizace.
  • Maximální velikost souboru je 10 MB.
  • Podporují se jenom nativní soubory Google Workspace (Dokumenty, Listy, Snímky). Soubory PDF, obrázky a jiné binární formáty nejsou podporovány.
  • Ve výstupu agenta se můžou zobrazit chyby vypršení platnosti připojení nebo tokenu. Znovu se ověřte, aby bylo možné problém vyřešit.

Poznámka:

Použití a přenos nezpracovaných nebo odvozených uživatelských dat přijatých z rozhraní API Google Workspace bude dodržovat zásady uživatelských dat rozhraní API google, včetně požadavků na omezené použití.

omezení SharePoint

  • Maximální velikost souboru je 10 MB.
  • Mezi podporované typy souborů patří dokumenty Office (.docx, .xlsx, .pptx), a také běžné textové formáty, jako .txt, .csv, .json, .md a další. Soubory PDF, obrázky a jiné binární formáty nejsou podporovány.

omezení GitHub

  • Ve výchozím nastavení má konektor Databricks GitHub MCP přístup jenom k veřejným úložištím. Pokud chcete konektoru udělit přístup pro čtení k privátním podnikovým úložištím GitHub, musí správce organizace dokončit další nastavení. Viz Povolení přístupu k privátnímu úložišti.
  • GitHub Enterprise Server (místní verze GitHub) se nepodporuje.

Omezení služby Glean

  • Správce pracovního prostoru musí nejprve nakonfigurovat ID tenanta Glean, aby uživatelé, kteří nejsou správci, mohli připojení použít. Správce může při prvním připojování k Gleanu zadat ID tenanta.

Ruční přidání serverů MCP do kódu Genie

Pokud chcete genie Code připojit k serveru MCP, přidejte ho do nastavení Kódu Genie:

  1. Otevřete nastavení Genie Code. Na panelu Kód Genie klikněte na ikonu ozubeného kola. Nastavení.
  2. V části Servery MCP klepněte na tlačítko Nová ikona. Přidat server.
  3. Vyberte servery MCP, které chcete přidat. Můžete vybrat servery MCP spravované službou Databricks nebo externí servery MCP:
    • Funkce Katalogu Unity: Vyberte schéma funkce. Díky tomu může Genie Code používat funkce ke spouštění předdefinovaných dotazů SQL.
    • Vyhledávání AI: Vyberte schéma indexu. To umožňuje nástroji Genie Code dotazovat se indexu AI Search a vyhledat relevantní dokumenty.
    • Agent Genie: Vyberte agenta Genie. Genie MCP vyvolá Genie jako nástroj, který umožňuje dotazovat agenta Genie na analýzu dat pomocí přirozeného jazyka.
    • Externí server MCP: Vyberte připojení katalogu Unity, které chcete použít jako externí server MCP. Nejdřív se musíte přihlásit k připojení, abyste ho mohli použít.
    • Vlastní server MCP: Vyberte aplikaci Databricks, která se má použít jako vlastní server MCP. To vám umožní používat všechny vlastní definované nástroje. Platí následující požadavky:
      • Aplikace musí být nasazená ve stejném pracovním prostoru, ze kterého se pokoušíte připojit.
      • Server MCP musí být přístupný na adrese https://<server-url>/mcp.
      • Vaše aplikace musí být bezstavová. Například nastavte mcp_app = mcp_server.http_app(stateless_http=True).
      • Pokud narazíte na chyby CORS, možná budete muset přidat adresu URL pracovního prostoru do seznamu povolených zdrojů vaší aplikace. Například nastavte app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
  4. Klikněte na Uložit.

Po jejich přidání jsou servery MCP okamžitě dostupné pro Genie Code. Můžete je začít používat beze změny výzev nebo pokynů. Genie Code bude automaticky využívat tyto servery, když to bude relevantní.

Přístup MCP je v současné době omezený na 20 nástrojů na všech serverech. V nastavení Genie Code můžete zvolit nástroje a servery, které se mají povolit nebo zakázat.

Omezení

  • Last updated on