Genie Code csatlakoztatása MCP-kiszolgálókhoz

A Genie Code külső eszközökhöz, dokumentumokhoz és adatokhoz kapcsolódik Model Context Protocol (MCP) szervereken és natív csatlakozókon keresztül Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack és GitHub számára. Használja a natív összekötőket a gyakori SaaS-forrásokhoz, vagy adjon hozzá saját külső vagy egyéni MCP-kiszolgálókat a munkaterületről. Kiválaszthatja, hogy mely eszközöket szeretné engedélyezni a Genie Code beállításai között.

Mi az MCP?

Az MCP egy nyílt forráskód szabvány, amely az ügynököket eszközökhöz, erőforrásokhoz, kérésekhez és egyéb környezeti információkhoz csatlakoztatja. Az MCP szabványosított módot biztosít eszközök, adatok és munkafolyamatok Genie Code-nak való elérhetővé ására anélkül, hogy közvetlenül beágyaznák ezt a környezetet a kérésekbe vagy utasításokba.

Az MCP olyan esetekre lett kialakítva, ahol már létezik fontos környezet, de nehezen érhető el egy ügynökből, például a Genie Code-ból. Az MCP biztonságos módot kínál a Genie Code-hoz való hozzáférésre az alábbihoz hasonló környezetekhez:

• Dokumentációs rendszerek: A Teams gyakran runbookokat vagy operatív dokumentumokat tárol olyan eszközökben, mint a Confluence. A szakaszokat a felhasználói kérésekbe másolása helyett ez a tartalom egy külső MCP-kiszolgálón keresztül egyszer is közzétehető, és releváns esetekben hivatkozni lehet rá. Előfordulhat, hogy a dokumentumok már AI Search-indexként is megtalálhatók a Databricksben, amellyel a Genie Code lekérdezheti a releváns dokumentumokat.
• Eszközök és szolgáltatások: A platformcsapatok api-kat vagy szkripteket tarthatnak fenn a beállításhoz, az ellenőrzéshez vagy az üzembe helyezéshez. Az MCP ezeket a képességeket közvetlenül elérhetővé teszi a Genie Code számára.
• Adatforrások: Ha már rendelkezik adatokkal a Databricksben, a Genie Code-ot egy Genie-ügynökhöz csatlakoztathatja, így természetes nyelven elemezheti az adatokat. A Databricksen kívül tárolt adatok esetében a Genie Code biztonságos hozzáférést biztosíthat külső MCP-kiszolgálókon keresztül.
• Egyéni alkalmazások: A Databricks Appsen keresztül üzemeltetett egyéni funkciókat is hozzáadhat. Ez lehetővé teszi, hogy a Genie Code-ot olyan saját fejlesztésű eszközökhöz, munkafolyamatokhoz vagy integrációkhoz csatlakoztassa, amelyet kifejezetten Önnek vagy a szervezetének fejlesztettek ki, és mindezt biztonságosan kezelik a Databricks-munkaterületen belül.

Ezekben az esetekben az MCP a manuális másolási beillesztést strukturált, újrafelhasználható megközelítésre cseréli, így a megfelelő környezet csak akkor érhető el, ha szükség van rá.

A Genie Code-ot csatlakoztathatja a munkaterületen található bármely OLYAN MCP-kiszolgálóhoz, amelyhez engedéllyel rendelkezik. A munkaterület rendszergazdái szabályozhatják, hogy mely kiszolgálók érhetők el, a felhasználók pedig igény szerint választhatnak ezek közül a jóváhagyott források közül.

Ha többet szeretnél megtudni a Databricks MCP szervereiről és arról, hogyan lehet saját szervereket létrehozni, lásd az MCP-ket és az ügynök eszközöket.

Natív összekötők használata külső adatforrásokhoz

A Genie Code beépített csatlakozókat biztosít a gyakori vállalati adatforrásokhoz:

• Google Drive: Google Docs, Sheets és Slides keresése és létrehozása; az általa létrehozott Dokumentumok szerkesztése.
• Gmail: Keress, olvass és írj e-maileket.
• Google Naptár: Keress és hozz létre naptári eseményeket.
• Microsoft 365: SharePoint, Teams, Outlook és Calendar keresése; Outlook e-mail vázlat.
• Atlassian: Keresés és frissítés a Jirában és a Confluence-ben.
• Glean (Beta): Keress a szervezeted összekapcsolt alkalmazásai között a Glean segítségével.
• Slack: Keress Slack üzeneteket és csatornákat, és küldj üzeneteket.
• GitHub: repozitóriumok, hibajegyek és beolvasztási kérelmek keresése és frissítése.

Ezekhez az adatforrásokhoz való csatlakozás lehetővé teszi, hogy a Genie Code keressen dokumentumaidat és műveleteket végezzen kapcsolódó eszközökön a kérdések megválaszolásakor. Minden felhasználó egyenként hitelesít, és az OAuth-jogkivonatok nem lesznek megosztva a felhasználók között.

Ezek a kapcsolatok Databricks által biztosított MCP csatlakozókat használnak, így nincs szerver, amit hostolhatnának, és nincs OAuth alkalmazás, amit regisztrálhatnának. Azure Databricks minden kapcsolatot a Unity Catalog és a Unity Gateway segítségével irányít. A gateway minden eszközhívást engedélyez a Unity Catalog jogosultságai ellen, beépített szabályzatokat és jóváhagyási követelményeket alkalmaz, valamint a használati és audit naplókat rögzíti a rendszertáblákban. Lásd : Regisztrálj egy külső MCP szervert.

Külső adatforrás csatlakoztatása:

1. A munkaterületén kattintson a A jobb felső sarokban található Genie Code ikon megnyit egy csevegést.
2. A parancssori sávon kattintson az a plusz ikonra.
3. A csatlakozni kívánt adatforrás mellett kattintson a Csatlakozás gombra.
4. Végezze el a bejelentkezéshez szükséges lépéseket.

A hitelesítés után a Genie Code a kérdések megválaszolásakor kereshet a dokumentumokban. A metaadattár-rendszergazdák és a kapcsolattulajdonosok kezelhetik vagy visszavonhatják a kapcsolat felhasználói engedélyeit. Lásd a 4. lépést. Hozzáférés biztosítása MCP szolgáltatáshoz.

Megjegyzés:

Az adatforrás-eszközök nem mindig aktiválódnak automatikusan. Ha a dokumentumkeresés nem indul el, próbálja meg explicit módon kérni a Genie Code-ot az eszköz használatára, például "a Google Docs használata" vagy a "SharePoint használata".

Más adatforrások csatlakoztatásához manuálisan vegye fel őket a Genie Code-ba. Lásd: McP-kiszolgálók hozzáadása a Genie Code-hoz manuálisan.

Ütemezett feladatok és hitelesítés

• A Genie Code nem figyelmeztet, ha egy kapcsolat hitelesítése lejár. Lehet, hogy csak akkor tudod meg, amikor egy eszközhívás meghibásodik, vagy amikor megnyitod a kapcsolatok listáját. Az újrahitelesítéssel megoldhatja a problémát.
• A kapcsolat jogosultságainak megváltoztatásához minden felhasználónak újra hitelesítést kell tennie. Az ütemezett feladatok, amelyek a kapcsolatot használják, kudarcot vallottak, amíg a felhasználó újra nem autentikál.

A Google Drive korlátozásai

• A Google Drive engedélyezésekor előfordulhat, hogy egy "ellenőrizetlen alkalmazás" képernyő jelenik meg. Kattintson a Speciális lehetőségre, és folytassa az engedélyezési folyamatot.
• A fájl maximális mérete 25 MB.
• Csak a natív Google Workspace-fájlok (Dokumentumok, Lapok, Prezentációk) támogatottak. A PDF-fájlok, képek és más bináris formátumok nem támogatottak.
• A Genie Code képes Google Docs-ot, Sheet-et és Slide-et létrehozni, valamint szerkeszteni a Google Docs-okat, amelyeket a csatlakozón keresztül készített. Nem tudja szerkeszteni a csatlakozón kívül létrehozott dokumentumokat, vagy nem tudja szerkeszteni a meglévő táblázatokat vagy diákat.
• Egy nagyon nagy dokumentum olvasása lassú lehet.

Megjegyzés:

A Google Workspace API-któl kapott nyers vagy származtatott felhasználói adatok használata és átvitele megfelel a Google API-szolgáltatások felhasználói adatszabályzatának, beleértve a korlátozott használati követelményeket is.

Gmail korlátozások

• A Genie Code képes keresni, olvasni és megfogalmazni az e-maileket, de nem tud e-maileket küldeni vagy szerkeszteni a meglévő üzeneteket.
• A Genie Code nem tud Drive fájlokat natív Gmail-mellékletként hozzáadni. Megoldásként tegyél be linkeket a fájlokra az e-mail törzsben.

Microsoft 365 korlátozások

• Tartalmazza a SharePoint, a Teamst, a Outlook és a Naptárt.
• A Genie Code képes Outlook e-maileket írni, de nem tudja elküldeni.
• A SharePoint fájlok maximális fájlmérete 25 MB.
• A támogatott SharePoint fájltípusok közé tartoznak az Office dokumentumok (.docx, .xlsx, .pptx), valamint a gyakori szövegalapú formátumok, mint .txtpéldául , .csv, .json, .md, , és mások. A PDF-fájlok, képek és más bináris formátumok nem támogatottak.

Glean (Beta) korlátozások

• A Glean csak keresésre alkalmas. Nem tud dokumentumot olvasni közvetlen linkről.
• A metastore adminisztrátornak először be kell állítania a Glean bérlőazonosítót, mielőtt a nem adminisztrátor felhasználók használhatnák a kapcsolatot. A rendszergazda megadhatja a bérlőazonosítót, amikor először csatlakozik a Gleanhez.
• Egy adott Glean MCP szerverhez való csatlakozáshoz a metastore adminisztrátor opcionálisan beállíthatja az MCP szerver útját (például /mcp/eng) a kapcsolat beállításakor. Hagyd üresen ezt a mezőt, hogy az alapértelmezett útvonalat (/mcp/default). használd A nem adminisztrátor felhasználók nem határozhatják meg vagy változtathatják meg a Glean MCP szerver útvonalát.

Laza korlátozások

• A Genie Code nem tud szerkeszteni vagy törölni egy üzenetet az elküldés után.

GitHub korlátozások

• Az írások csak fájl tartalmára, problémákra és pull requestekre korlátozódnak.
• Alapértelmezés szerint a Databricks GitHub MCP-összekötő csak nyilvános adattárakat tud elérni. Ahhoz, hogy az összekötő olvasási hozzáférést kapjon a magánvállalati adattárakhoz, a GitHub szervezet rendszergazdájának további beállításokat kell elvégeznie. Lásd: Privát adattár-hozzáférés engedélyezése.
• GitHub Enterprise Server (a GitHub saját üzemeltetésű verziója) nem támogatott.

MCP-kiszolgálók hozzáadása manuálisan a Genie Code-hoz

Ha a Genie Code-ot egy MCP-kiszolgálóhoz szeretné csatlakoztatni, adja hozzá a Genie-kód beállításaihoz:

1. Nyissa meg a Genie-kód beállításait. A Genie Code panelen kattintson a Beállítások.
2. Az MCP-kiszolgálók területen kattintson az Kiszolgáló hozzáadása.
3. Válassza ki a hozzáadni kívánt MCP-kiszolgálókat. Kiválaszthatja a Databricks által felügyelt MCP-kiszolgálókat vagy külső MCP-kiszolgálókat:
   • Unity Catalog függvény: Válassza ki a függvény sémáját. Ez lehetővé teszi, hogy a Genie Code függvényeket használjon előre definiált SQL-lekérdezések futtatásához.
     • Ha segítségre van szüksége egyéni GitHub MCP-kiszolgáló létrehozásához, lásd: Genie Code-dal kereshet a GitHub-kódban.
   • AI-keresés: Válassza ki az index sémáját. Ez lehetővé teszi, hogy a Genie Code lekérdezhesse az AI Search-indexet a releváns dokumentumok megkereséséhez.
   • Genie-ügynök: Válassza ki a Genie-ügynököt. A Genie MCP eszközként meghívja a Genie-t, így lekérdezheti a Genie-ügynököt az adatok természetes nyelv használatával történő elemzéséhez.
   • Külső MCP-kiszolgáló: Válassza ki a külső MCP-kiszolgálóként használni kívánt Unity Catalog-kapcsolatot. A használat előtt először be kell jelentkeznie a kapcsolatba.
   • Egyéni MCP-kiszolgáló: Válassza ki azt a Databricks-alkalmazást , amelyet egyéni MCP-kiszolgálóként szeretne használni. Ez lehetővé teszi az egyénileg definiált eszközök használatát. A következő követelmények érvényesek:
     • Az alkalmazást ugyanabban a munkaterületen kell üzembe helyezni, ahonnan csatlakozni próbál.
     • Az MCP-kiszolgálót a következő helyen https://<server-url>/mcpkell elérni: .
     • Az alkalmazásnak állapot nélkülinek kell lennie. Például állítsa be a mcp_app = mcp_server.http_app(stateless_http=True).
     • Ha CORS-hibákba ütközik, előfordulhat, hogy hozzá kell adnia a munkaterület URL-címét az alkalmazás engedélyezett forráslistájához. Például állítsa be a app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Kattintson a Mentés lehetőségre.

A hozzáadásuk után az MCP-kiszolgálók azonnal elérhetők a Genie Code számára. A kérések és utasítások módosítása nélkül is elkezdheti használni őket. A Genie Code automatikusan ezeket a kiszolgálókat használja, amikor releváns.

A Genie-kód beállításai között kiválaszthatja, hogy mely eszközöket és kiszolgálókat szeretné engedélyezni vagy letiltani.

Limitations

A csatlakoztatott alkalmazások megfelelőségi útmutatójáért lásd: Databricks által biztosított MCP szolgáltatás korlátai.

• A külső MCP-kiszolgálók csak olyan régiókban érhetők el, ahol a modellkiszolgáló támogatott. Lásd: A modell kiszolgálói funkcióinak rendelkezésre állása.