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ů Model Context Protocol (MCP) a nativních konektorů pro Google Drive, Gmail, Google Kalendář, Microsoft 365, Atlassian, Glean, Slack a GitHub. Použijte nativní konektory pro běžné zdroje SaaS nebo přidejte vlastní externí nebo vlastní servery MCP z pracovního prostoru. Zvolíte, které nástroje se mají povolit v nastavení Genie Code.

Co je MCP?

MCP je open source standard, který připojuje agenty k nástrojům, prostředkům, výzev 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 z agenta, 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ího prostoru určují, které servery jsou k dispozici, zatímco uživatelé můžou podle potřeby vybírat z těchto schválených zdrojů.

Chcete-li se dozvědět více o MCP serverech v Databricks a jak si vytvořit vlastní, podívejte se na MCP a nástroje agentů.

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

Genie Code poskytuje vestavěné konektory pro běžné podnikové datové zdroje:

• Google Drive: Vyhledávat a vytvářet Google Docs, Sheets a Slides; upravovat Docs, které vytvořil.
• Gmail: Vyhledávání, čtení a psaní e-mailů.
• Google Kalendář: Vyhledávejte a vytvářejte události v kalendáři.
• Microsoft 365: Vyhledávat v SharePoint, Teams, Outlook a Kalendáři; sestavovat e-maily v Outlook.
• Atlassian: Vyhledat a aktualizovat Jiru a Confluence.
• Glean (Beta): Hledejte ve všech propojených aplikacích vaší organizace pomocí Glean.
• Slack: Vyhledávejte zprávy a kanály na Slacku a posílejte zprávy.
• GitHub: Vyhledávání a aktualizace repozitářů, problémů a pull requestů.

Připojení k těmto datovým zdrojům umožňuje Genie Code vyhledávat vaše dokumenty a provádět akce v propojených nástrojích 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í.

Tato připojení používají MCP konektory poskytované Databricks, takže není žádný server k hostování a žádná OAuth aplikace k registraci. Azure Databricks řídí každé spojení prostřednictvím Unity Catalog a Unity Gateway. Gateway autorizuje každé volání nástroje proti oprávněním vašeho Unity Catalog, aplikuje vestavěné politiky a schvalovací požadavky a zaznamenává záznamy o využití a auditech v systémových tabulkách. Viz Registrujte externí MCP server.

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

1. V pracovním prostoru klikněte na Genie Code v pravém horním rohu a otevře chat.
2. Na panelu výzvy klikněte na 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 krok 4. Udělit přístup ke službě MCP.

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.

Plánované úlohy a autentizace

• Genie Code vás neupozorní, když vyprší ověření spojení. Možná se to dozvíte až když selže volání nástroje nebo když otevřete seznam připojení. Znovu se ověřte, aby bylo možné problém vyřešit.
• Změna oprávnění připojení vyžaduje, aby se každý uživatel znovu autentizoval. Plánované úlohy, které využívají připojení, selžou, dokud se uživatel znovu neautentizuje.

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 25 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.
• Genie Code může vytvářet Google Docs, Sheets a Slides a upravovat Google Docs, které vytvořil přes konektor. Nemůže upravovat dokumenty vytvořené mimo konektor ani upravovat existující Sheets či Slides.
• Čtení velmi rozsáhlého dokumentu může být pomalé.

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í Gmailu

• Genie Code umí vyhledávat, číst a sestavovat e-maily, ale nemůže posílat e-maily ani upravovat existující zprávy.
• Genie Code nemůže přidávat soubory z Drive jako nativní přílohy Gmailu. Jako řešení zahrňte odkazy na soubory přímo v těle e-mailu.

Omezení Microsoft 365

• Zahrnuje SharePoint, Teams, Outlook a Kalendář.
• Genie Code umí vytvářet e-mail pro Outlook, ale nemůže ho odeslat.
• Maximální velikost souboru je 25 MB pro SharePoint soubory.
• Podporované typy souborů SharePoint zahrnují Office dokumenty (.docx, .xlsx, .pptx), stejně jako 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í Gleanu (Beta)

• Glean je pouze pro vyhledávání. Nemůže přečíst dokument z přímého odkazu.
• Správce metastore musí nejprve nakonfigurovat ID tenanta Glean, než mohou uživatelé bez administrátorů použít připojení. Správce může při prvním připojování k Gleanu zadat ID tenanta.
• Pro připojení ke konkrétnímu Glean MCP serveru může správce metastore volitelně nastavit cestu MCP serveru (například /mcp/eng) při navazování připojení. Toto pole nechte prázdné, abyste mohli použít výchozí cestu (/mcp/default). Uživatelé bez administrátorů nemohou specifikovat ani měnit cestu k serveru Glean MCP.

Omezení uvolnění

• Genie Code nemůže upravovat ani mazat zprávu po odeslání.

omezení GitHub

• Zápisy jsou omezeny na obsah souborů, problémy a pull requesty.
• 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.

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. V podokně Genie Code klikněte na Nastavení.
2. V části Servery MCP klepněte na 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.
     • Nápovědu k vytvoření vlastního serveru GitHub MCP najdete v tématu Vyhledat kód GitHub pomocí kódu Genie Code.
   • 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 tyto servery automaticky využívá, když je to relevantní.

V nastavení Genie Code můžete zvolit nástroje a servery, které se mají povolit nebo zakázat.

Omezení

Pokyny pro zajištění souladu pro připojené aplikace naleznete v části omezení služby MCP poskytované společností Databricks.

• Externí servery MCP jsou dostupné jenom v oblastech, kde je podporováno poskytování modelů. Viz Dostupnost funkcí obsluhy modelu.