Ansluta Genie Code till MCP-servrar

Genie Code ansluter till externa verktyg, dokument och data via MCP-servrar (Model Context Protocol) och interna anslutningsappar för Google Drive, SharePoint, GitHub, Glean, Atlassian och Slack. Använd de interna anslutningsprogrammen för vanliga SaaS-källor eller lägg till dina egna externa eller anpassade MCP-servrar från arbetsytan. Du väljer vilka verktyg som ska aktiveras i inställningarna för Genie Code.

Vad är MCP?

MCP är en open-source standard som ansluter agenter till verktyg, resurser, uppmaningar och annan kontextuell information. MCP är ett standardiserat sätt att exponera verktyg, data och arbetsflöden för Genie Code utan att bädda in kontexten direkt i uppmaningar eller instruktioner.

MCP är utformat för fall där det redan finns en viktig kontext men är svår att komma åt från en agent, till exempel Genie Code. MCP erbjuder ett säkert sätt att ge Genie Code åtkomst till kontext som följande:

  • Dokumentationssystem: Teams behåller ofta runbooks eller operativa dokument i verktyg som Confluence. I stället för att kopiera avsnitt till prompter kan innehållet exponeras en gång via en extern MCP-server och refereras när det är relevant. Dina dokument kanske också redan finns i Databricks som ett AI Search-index, som Genie Code kan använda för att fråga relevanta dokument.
  • Verktyg och tjänster: Plattformsteam kan underhålla API:er eller skript för installation, validering eller distribution. MCP gör dessa funktioner direkt tillgängliga för Genie Code.
  • Datakällor: Om du redan har data i Databricks kan du ansluta Genie Code till en Genie-agent som hjälper dig att analysera data med naturligt språk. För data som lagras utanför Databricks kan du ge Genie Code säker åtkomst via externa MCP-servrar.
  • Anpassade appar: Du kan också lägga till anpassade funktioner som hanteras via Databricks-appar. På så sätt kan du ansluta Genie Code till egna verktyg, arbetsflöden eller integreringar som skapats specifikt för dig eller din organisation, som alla hanteras på ett säkert sätt på din Databricks-arbetsyta.

I dessa fall ersätter MCP manuell kopiering med en strukturerad, återanvändbar metod, vilket gör rätt kontext tillgänglig endast när den behövs.

Du kan ansluta Genie Code till alla MCP-servrar på din arbetsyta som du har behörighet att använda. Arbetsyteadministratörer styr vilka servrar som är tillgängliga, medan användare kan välja från de godkända källorna efter behov.

För att lära dig mer om MCP-servrar i Databricks och hur du skapar egna, se MCP:er och agentverktyg.

Använd inbyggda anslutningar för datakällor från tredje part

Viktigt!

Den här funktionen finns i Beta. Om du vill använda anslutningsprogram för datakällor från tredje part måste en arbetsyteadministratör aktivera förhandsversionen av anslutningsprogram från tredje part för agenter . Se Hantera Azure Databricks förhandsversioner.

Genie Code tillhandahåller inbyggda anslutningsappar för vanliga företagsdatakällor, inklusive Google Drive, SharePoint, GitHub, Glean, Atlassian och Slack.

Genom att ansluta till dessa datakällor kan Genie Code söka i dina dokument när du svarar på frågor. Varje användare autentiserar individuellt och OAuth-token delas inte mellan användare.

Så här ansluter du en datakälla från tredje part:

  1. På din arbetsyta klickar du på Sparkle genie code-ikonen. Genie Code i det övre högra hörnet för att öppna en chatt.
  2. I promptfältet klickar du på Ny ikon. plusikonen.
  3. Bredvid den datakälla som du vill ansluta till klickar du på Anslut.
  4. Slutför stegen för att logga in.

När du har autentiserats kan Genie Code söka i dina dokument när du svarar på frågor. Metastoreadministratörer och anslutningsägare kan hantera eller återkalla användarbehörigheter på anslutningen. Se Steg 4. Bevilja åtkomst till teammedlemmar.

Anmärkning

Datakällans verktyg aktiveras inte alltid automatiskt. Om dokumentsökningen inte startar kan du prova att uttryckligen uppmana Genie Code att använda verktyget, till exempel "använd Google Docs" eller "använd SharePoint".

Om du vill ansluta andra datakällor lägger du till dem manuellt i Genie Code. Se Lägga till MCP-servrar i Genie Code manuellt.

Begränsningar för Google Drive

  • När du auktoriserar Google Drive kan du se en "icke-verifierad app"-skärm. Klicka på Avancerat och fortsätt auktoriseringsprocessen.
  • Maximal filstorlek är 10 MB.
  • Endast interna Google Workspace-filer (Docs, Sheets, Slides) stöds. PDF-filer, bilder och andra binära format stöds inte.
  • Anslutnings- eller tokens förfallofel kan visas i agentens utdata. Autentisera igen för att lösa.

Anmärkning

Användning och överföring av rådata eller härledda användardata som tas emot från Google Workspace-API:er följer Google API-tjänsternas användardataprincip, inklusive kraven på begränsad användning.

SharePoint begränsningar

  • Maximal filstorlek är 10 MB.
  • Filtyper som stöds är Office-dokument (.docx, .xlsx, .pptx), samt vanliga textbaserade format som .txt, .csv, .json, .mdoch andra. PDF-filer, bilder och andra binära format stöds inte.

GitHub begränsningar

  • Som standard kan Databricks GitHub MCP-anslutningsprogram endast komma åt offentliga lagringsplatser. Om du vill ge anslutningsappen läsbehörighet till dina privata företagslagringsplatser måste en GitHub organisationsadministratör slutföra ytterligare konfiguration. Se Aktivera åtkomst till privata lagringsplatser.
  • GitHub Enterprise Server (den lokalt installerade versionen av GitHub) stöds inte.

Glean-begränsningar

  • En metastore-administratör måste först konfigurera Glean-tenant-ID:t innan icke-administratörsanvändare kan använda anslutningen. Administratören kan ange klientorganisations-ID:t när den först ansluter till Glean.
  • För att ansluta till en specifik Glean MCP-server kan en metastore-administratör valfritt ställa in MCP-servervägen (till exempel /mcp/eng) vid anslutningen. Låt detta fält vara tomt för att använda standardsökvägen (/mcp/default). Icke-administratörsanvändare kan inte specificera eller ändra Glean MCP-serverns sökväg.

Lägg till MCP-servrar i Genie Code manuellt

Om du vill ansluta Genie Code till en MCP-server lägger du till den i inställningarna för Genie Code:

  1. Öppna inställningarna för Genie Code. I fönstret Genie Code klickar du på kugghjulsikonen. Inställningar.
  2. Under MCP-servrar klickar du på Ny ikon. Lägg till server.
  3. Välj de MCP-servrar som du vill lägga till. Du kan välja Databricks-hanterade MCP-servrar eller externa MCP-servrar:
    • Funktionen Unity Catalog: Välj schemat för funktionen. På så sätt kan Genie Code använda funktioner för att köra fördefinierade SQL-frågor.
    • AI-sökning: Välj schemat för indexet. På så sätt kan Genie Code köra frågor mot AI Search-indexet för att hitta relevanta dokument.
    • Genie-agent: Välj Genie-agenten. Genie MCP anropar Genie som ett verktyg, så att du kan fråga Genie Agent för att analysera data med naturligt språk.
    • Extern MCP-server: Välj den Unity Catalog-anslutning som ska användas som en extern MCP-server. Du måste logga in på anslutningen först innan den kan användas.
    • Anpassad MCP-server: Välj den Databricks-app som ska användas som en anpassad MCP-server. På så sätt kan du använda alla anpassade verktyg. Följande krav gäller:
      • Appen måste distribueras på samma arbetsyta som du försöker ansluta till den från.
      • MCP-servern måste nås på https://<server-url>/mcp.
      • Appen måste vara tillståndslös. Ange mcp_app = mcp_server.http_app(stateless_http=True)till exempel .
      • Om du stöter på CORS-fel kan du behöva lägga till din arbetsyte-URL i appens lista över tillåtna ursprung. Ange app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])till exempel .
  4. Klicka på Spara.

När de har lagts till är MCP-servrar omedelbart tillgängliga för Genie Code. Du kan börja använda dem utan att ändra dina uppmaningar eller instruktioner. Genie Code använder automatiskt dessa servrar när det är relevant.

Du kan välja vilka verktyg och servrar som ska aktiveras eller inaktiveras i inställningarna för Genie Code.

Limitations

  • Last updated on