Freigeben über


Verbinden von Genie Code mit MCP-Servern

Verbinden Sie Genie Code mit externen Tools und Datenquellen über das Model Context Protocol (MCP). Genie Code kann beliebige MCP-Server verwenden, die Ihrem Arbeitsbereich hinzugefügt wurden und zu deren Nutzung Sie berechtigt sind.

Hinweis

MCP-Server werden nur im Modus "Genie Code Agent" unterstützt.

Was ist MCP?

MCP ist ein open source Standard, der KI-Agents mit Tools, Ressourcen, Eingabeaufforderungen und anderen kontextbezogenen Informationen verbindet. MCP bietet eine standardisierte Möglichkeit, Tools, Daten und Workflows für Genie Code verfügbar zu machen, ohne diesen Kontext direkt in Eingabeaufforderungen oder Anweisungen einzubetten.

MCP ist für Fälle konzipiert, in denen bereits ein wichtiger Kontext vorhanden ist, aber nur schwer von einem KI-Agenten wie Genie Code zugegriffen werden kann. MCP bietet eine sichere Möglichkeit, Genie Code Zugriff auf Kontext wie die folgenden zu gewähren:

  • Dokumentationssysteme: Teams behalten häufig Runbooks oder betriebsbereite Dokumente in Tools wie Confluence. Anstatt Abschnitte in Eingabeaufforderungen zu kopieren, können diese Inhalte einmal über einen externen MCP-Server verfügbar gemacht und bei Relevanz referenziert werden. Ihre Dokumente befinden sich möglicherweise auch bereits in Databricks als Vektorsuchindex, den Genie Code zum Abfragen relevanter Dokumente verwenden kann.
  • Tools und Dienste: Plattformteams können APIs oder Skripts für Setup, Validierung oder Bereitstellung verwalten. MCP stellt diese Funktionen direkt für Genie Code zur Verfügung.
  • Datenquellen: Wenn Sie bereits Daten in Databricks haben, können Sie Genie Code mit einem Genie-Raum verbinden, um Die Daten mithilfe natürlicher Sprache zu analysieren. Für Daten, die außerhalb von Databricks gespeichert sind, können Sie Genie Code sicheren Zugriff über externe MCP-Server gewähren.
  • Benutzerdefinierte Apps: Sie können auch benutzerdefinierte Funktionen hinzufügen, die über Databricks-Apps gehostet werden. Auf diese Weise können Sie Genie Code mit proprietären Tools, Workflows oder Integrationen verbinden, die speziell für Sie oder Ihre Organisation erstellt wurden und alle sicher in Ihrem Databricks-Arbeitsbereich verwaltet werden.

In diesen Fällen ersetzt MCP manuelles Kopieren und Einfügen durch einen strukturierten, wiederverwendbaren Ansatz, sodass der richtige Kontext nur verfügbar ist, wenn er benötigt wird.

Sie können Genie Code mit allen MCP-Servern in Ihrem Arbeitsbereich verbinden, die Sie verwenden dürfen. Arbeitsbereichsadministratoren steuern, welche Server verfügbar sind, während Benutzer nach Bedarf aus diesen genehmigten Quellen auswählen können.

Weitere Informationen zu MCP-Servern in Databricks und zum Erstellen Eigener finden Sie unter Model Context Protocol (MCP) auf Databricks.

Herstellen einer Verbindung mit Datenquellen von Drittanbietern

Von Bedeutung

Dieses Feature befindet sich in der Betaversion. Um Datenquellen-Connectoren von Drittanbietern zu verwenden, muss ein Arbeitsbereichsadministrator die Vorschau auf Connectors von Drittanbietern für Agents aktivieren. Siehe Manage Azure Databricks Previews.

Genie Code bietet integrierte Connectors für gängige Unternehmensdatenquellen, einschließlich Google Drive und SharePoint.

Wenn Sie eine Verbindung mit diesen Datenquellen herstellen, kann Genie Code Ihre Dokumente durchsuchen, wenn Sie Fragen beantworten. Jeder Benutzer authentifiziert sich individuell, und OAuth-Token werden nicht zwischen den Benutzern geteilt.

So verbinden Sie eine Drittanbieterdatenquelle:

  1. Klicken Sie in Ihrem Arbeitsbereich auf sparkle genie code icon. Genie Code in der oberen rechten Ecke, um einen Chat zu öffnen.
  2. Klicken Sie in der Eingabeaufforderungsleiste auf das Symbol Das Plussymbol.
  3. Klicken Sie neben der Datenquelle, mit der Sie eine Verbindung herstellen möchten, auf "Verbinden".
  4. Führen Sie die Schritte zum Anmelden aus.

Nach der Authentifizierung kann Genie Code Ihre Dokumente durchsuchen, wenn Sie Fragen beantworten. Metastore-Administratoren und Verbindungsbesitzer können Benutzerberechtigungen für die Verbindung verwalten oder widerrufen. Siehe Freigeben der MCP-Serververbindung.

Hinweis

Datenquellentools werden nicht immer automatisch ausgelöst. Wenn die Dokumentsuche nicht gestartet wird, versuchen Sie, Genie Code explizit aufzufordern, das Tool zu verwenden, z. B. "Google Docs verwenden" oder "SharePoint verwenden".

Um andere Datenquellen zu verbinden, fügen Sie sie manuell zu Genie Code hinzu. Siehe manuelles Hinzufügen von MCP-Servern zu Genie Code.

Google Drive-Einschränkungen

  • Die maximale Dateigröße beträgt 10 MB.
  • Es werden nur native Google Workspace-Dateien (Docs, Sheets, Slides) unterstützt. PDFs, Bilder und andere Binärformate werden nicht unterstützt.
  • Verbindungs- oder Tokenablauffehler könnten in der Agentenausgabe angezeigt werden. Erneut authentifizieren, um das Problem zu beheben.

SharePoint Einschränkungen

  • Die maximale Dateigröße beträgt 10 MB.
  • Unterstützte Dateitypen umfassen Office-Dokumente (.docx, .xlsx, .pptx) sowie allgemeine textbasierte Formate wie .txt, , .csv, .jsonund .mdandere. PDFs, Bilder und andere Binärformate werden nicht unterstützt.

Manuelles Hinzufügen von MCP-Servern zu Genie Code

Um Genie Code mit einem MCP-Server zu verbinden, fügen Sie ihn in Ihren Genie Code-Einstellungen hinzu:

  1. Öffnen Sie die Einstellungen von Genie Code. Klicken Sie im Bereich "Genie Code" auf das Zahnradsymbol. Einstellungen.
  2. Klicken Sie unter MCP-Server auf das Symbol Server hinzufügen.
  3. Wählen Sie die MCP-Server aus, die Sie hinzufügen möchten. Sie können von Databricks verwaltete MCP-Server oder externe MCP-Server auswählen:
    • Unity Catalog-Funktion: Wählen Sie das Schema für die Funktion aus. Auf diese Weise kann Genie Code Funktionen verwenden, um vordefinierte SQL-Abfragen auszuführen.
    • Vektorsuche: Wählen Sie das Schema für den Index aus. Auf diese Weise kann Genie Code den Vektorsuchindex abfragen, um relevante Dokumente zu finden.
    • Genie space: Wählen Sie den Genie space aus. Der Genie MCP ruft Genie als Werkzeug auf, sodass Sie den Genie-Raum abfragen können, um Daten mit natürlicher Sprache zu analysieren.
    • Externer MCP-Server: Wählen Sie die Unity Catalog-Verbindung aus, die als externer MCP-Server verwendet werden soll. Sie müssen sich zuerst bei der Verbindung anmelden, bevor sie verwendet werden kann.
    • Benutzerdefinierter MCP-Server: Wählen Sie die Databricks-App aus, die als benutzerdefinierter MCP-Server verwendet werden soll. Auf diese Weise können Sie alle benutzerdefinierten Tools verwenden. Die folgenden Anforderungen gelten:
      • Ihre App muss im selben Arbeitsbereich bereitgestellt werden, von dem Aus sie eine Verbindung herstellen möchten.
      • Der Zugang zum MCP-Server muss erfolgen über https://<server-url>/mcp.
      • Ihre App muss zustandslos sein. Legen Sie z. B. fest mcp_app = mcp_server.http_app(stateless_http=True).
      • Wenn CORS-Fehler auftreten, müssen Sie möglicherweise Ihre Arbeitsbereichs-URL zur Liste der zulässigen Ursprünge Ihrer App hinzufügen. Legen Sie z. B. fest app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
  4. Klicke auf Speichern.

Nachdem sie hinzugefügt wurden, sind MCP-Server sofort für Genie Code verfügbar. Sie können sie im Agent-Modus verwenden, ohne Ihre Eingabeaufforderungen oder Anweisungen zu ändern. Genie Code wird automatisch auf diese Server zugreifen, wenn es relevant ist.

Derzeit ist der MCP-Zugriff auf 20 Tools auf allen Servern beschränkt. Sie können auswählen, welche Tools und Server in Ihren Genie Code-Einstellungen aktiviert oder deaktiviert werden sollen.