Verbinden Sie einen Genie-Agenten mit externen Werkzeugen und Quellen

Ein Genie Agent kann von Databricks bereitgestellte MCP-(Model Context Protocol)-Connectoren verwenden, um während einer Agenten-Modus-Konversation Kontext aus externen Werkzeugen und Quellen zu ziehen und in externen Werkzeugen und Quellen Aktionen auszuführen. Ein Agentenautor hängt die Connectoren an, und jeder Nutzer authentifiziert sich individuell bei ihnen. Jeder Toolaufruf läuft mit den Berechtigungen des Nutzers, der die Frage stellt.

Important

Dieses Feature befindet sich in der Betaversion. Um es zu verwenden, muss ein Workspace-Admin Externe Werkzeuge in Genie Agents verbinden auf der Seite Vorschau aktivieren. Siehe Manage Azure Databricks Previews.

Note

Genie Agents waren früher als Genie Spaces bekannt.

Wie MCP-Konnektoren in einem Genie-Agenten funktionieren

MCP-Connectors ermöglichen es einem Genie Agent, seine SQL- und Dateianalyse mit den externen Anwendungen zu kombinieren, die Ihre Organisation bereits nutzt. Zum Beispiel kann ein einzelnes Gespräch eine Verkaufstabelle analysieren, verwandten Kontext aus Google Drive abrufen und eine Zusammenfassungs-E-Mail verfassen. Azure Databricks steuert jeden Toolaufruf über Unity Catalog und Unity Gateway. Siehe Govern an MCP.

MCP-Werkzeuge lassen sich in zwei Kategorien einteilen:

  • Schreibgeschützte Werkzeuge (Suche, Abruf und Auflisten) laufen automatisch.
  • Schreibwerkzeuge (zum Beispiel eine Nachricht verschicken oder eine E-Mail entwerfen) pausieren und bitten den Benutzer, die Aktion zu genehmigen, bevor sie ausgeführt wird.

Genie Agents unterstützen die folgenden von Databricks bereitgestellten MCP-Anschlüsse:

  • Google Drive: Google Docs, Sheets und Folien suchen und erstellen; Dokumente bearbeiten, die es erstellt hat.
  • Gmail: E-Mails suchen, lesen und verfassen.
  • Google Kalender: Suche und erstelle Kalenderereignisse.
  • Microsoft 365: Suche in SharePoint, Teams, Outlook und Kalender; Entwurf einer Outlook-E-Mail.
  • Atlassian: Suche und aktualisiere Jira und Confluence.
  • Glean (Beta): Durchsuchen Sie die verbundenen Apps Ihrer Organisation mit Glean.
  • Slack: Durchsuche Slack-Nachrichten und -Kanäle und sende Nachrichten.
  • GitHub: Suche und aktualisiere Repositories, Issues und Pull Requests.

Requirements

Die folgenden Anforderungen gelten für den Agent und seine Benutzer:

  • Sowohl arbeitsbereichszugriff als auch Databricks SQL-Zugriffsberechtigungen für jeden Benutzer des Agents. Benutzer, die nur Consumer-, nur Databricks SQL- oder nur Kontozugriff haben, können keine MCP-Tools verwenden. Siehe Zugriffsberechtigungen.
  • Ein Konto in jedem angeschlossenen externen System für jeden Nutzer des Agenten.

Verbinder zu einem Genie-Agenten hinzufügen

Um Konnektoren an einen Genie Agent anzuschließen:

  1. Öffne deinen Genie Agent.
  2. Öffnen Sie die Registerkarte "Quellen ", und klicken Sie dann auf "Hinzufügen".
  3. Wählen Sie einen oder mehrere MCP-Dienste aus.

Um einen Connector anzuhängen, benötigt man EXECUTE für den MCP-Service des Connectors im Unity-Katalog sowie USE CATALOG und USE SCHEMA für dessen Elternkatalog und Schema. Connectoren, die du nicht ausführen darfst, sind nicht verfügbar. Siehe von Databricks bereitgestellte MCPs.

Konfigurieren von Tools

Nachdem du einen Connector angeschlossen hast, konfiguriere, wie der Agent ihn verwendet:

  • Fügen Sie eine klare Beschreibung hinzu, die erklärt, wie und wann der Agent die Werkzeuge des Connectors verwenden soll. Zum Beispiel können Sie den Agenten über das erforderliche Ticket-Title-Format anweisen oder ihm sagen, dass er zu Beginn jedes Gesprächs das Profil eines Nutzers nachschlagen soll.
  • Aktivieren oder deaktivieren Sie einzelne Werkzeuge innerhalb eines Connectors, um zu bestimmen, welche Maßnahmen der Agent ausführen kann.

Verwenden Sie MCP-Tools in einem Gespräch

So verwenden Sie MCP-Tools in einem Genie Agent:

  1. Öffne einen Genie Agent, der mit MCP-Konnektoren versehen ist.
  2. Aktivieren Sie den Agent-Modus im Chatfeld.
  3. Authentifizieren Sie sich über das Konfigurationspanel am Connector. Wenn der Agent einen Connector benötigt, den du nicht autorisiert hast, oder deine Authentifizierung abgelaufen ist, fordert er dich auf, dich anzumelden.
  4. Senden Sie einen Prompt, der den Konnektor verwendet. Wenn der Agent ein Schreibwerkzeug aufruft, wähle Einmal erlauben, um die einzelne Aktion zu genehmigen, In diesem Chat immer erlauben, um dieses Tool für den Rest der Konversation zu genehmigen, oder Ablehnen, um es abzulehnen.

Um zu bestätigen, dass ein Connector funktioniert, stellen Sie eine Frage, die ihn benötigt, zum Beispiel: "Durchsuchen Sie meinen Google Drive nach dem Q3-Verkaufsplan." Der Agent nennt in seiner Antwort die externe Ressource, die er verwendet hat.

Limitations

Es gelten die folgenden Einschränkungen:

  • MCP-Tools laufen nur im Agentenmodus. Sie laufen nicht im Chat-Modus.
  • Über die APIs im Agent-Modus funktionieren nur Lesewerkzeuge, und Nutzer können sich nicht bei einem Connector authentifizieren. Schließen Sie die Authentifizierung und die Schreibwerkzeug-Freigabe in der Benutzeroberfläche ab.
  • Für Compliance-Richtlinien für verbundene Anwendungen siehe Anforderungen externer Anbieter.

Die folgenden Abschnitte beschreiben Einschränkungen für bestimmte Steckverbinder.

Google Drive

  • Beim Autorisieren von Google Drive kann es sein, dass ein Nicht bestätigte App-Bildschirm angezeigt wird. Klicken Sie auf "Erweitert" , und setzen Sie den Autorisierungsprozess fort.
  • Die maximale Dateigröße beträgt 25 MB.
  • Es werden nur native Google Workspace-Dateien (Docs, Sheets, Slides) unterstützt. PDFs, Bilder und andere Binärformate werden nicht unterstützt.
  • Der Connector kann Google Docs, Sheets und Slides erstellen und die von ihm erstellten Google Docs bearbeiten. Es kann keine außerhalb des Connectoren erstellten Dokumente bearbeiten oder bestehende Sheets oder Folien bearbeiten.
  • Das Lesen eines sehr großen Dokuments kann langsam sein.

Note

Die Verwendung und Übertragung von rohen oder abgeleiteten Benutzerdaten, die von Google Workspace-APIs empfangen werden, entsprechen der Google API-Dienste-Benutzerdatenrichtlinie, einschließlich der Anforderungen für die eingeschränkte Nutzung.

Gmail

  • Der Connector kann E-Mails suchen, lesen und entwerfen, aber er kann keine E-Mails senden oder bestehende Nachrichten bearbeiten.
  • Der Connector kann keine Drive-Dateien als native Gmail-Anhänge hinzufügen. Als Workaround fügen Sie Links zu den Dateien im E-Mail-Text ein.

Microsoft 365

  • Umfasst SharePoint, Teams, Outlook und Kalender.
  • Der Connector kann eine Outlook-E-Mail entwerfen, kann sie aber nicht senden.
  • Die maximale Dateigröße beträgt 25 MB für SharePoint-Dateien.
  • Zu den unterstützten SharePoint-Dateitypen gehören integrierte SharePoint-Dokumente, Tabellenkalkulationen und Präsentationen sowie gängige textbasierte Formate wie .txt, .csv, .json, .md und andere. PDFs, Bilder und andere Binärformate werden nicht unterstützt.

Glean (Beta)

  • Glean ist nur für die Suche gedacht. Es kann ein Dokument nicht über einen direkten Link lesen.
  • Ein Metastore-Administrator muss zuerst die Glean-Tenant-ID konfigurieren, bevor Nicht-Administratoren die Verbindung nutzen können. Der Administrator kann beim ersten Herstellen einer Verbindung mit Glean die Mandanten-ID eingeben.
  • Um sich mit einem bestimmten Glean MCP-Server zu verbinden, kann ein Metastore-Admin optional den MCP-Serverpfad (zum Beispiel /mcp/eng) beim Einrichten der Verbindung festlegen. Lassen Sie dieses Feld frei, um den Standardpfad (/mcp/default) zu verwenden. Nicht-Admin-Nutzer können den Glean MCP-Serverpfad nicht angeben oder ändern.

Slack

  • Der Connector kann eine Nachricht nach dem Senden nicht bearbeiten oder löschen.

GitHub

  • Schreibvorgänge sind auf Dateiinhalte, Probleme und Pull Requests beschränkt.
  • Standardmäßig kann der Databricks-GitHub MCP-Connector nur auf öffentliche Repositorys zugreifen. Um dem Connector Lesezugriff auf Ihre privaten Unternehmensrepositorys zu gewähren, muss ein GitHub Organisationsadministrator zusätzliche Einrichtung durchführen. Siehe GitHub private Repositories.
  • GitHub Enterprise Server (die selbst gehostete Version von GitHub) wird nicht unterstützt.

Weitere Ressourcen

Weitere Informationen finden Sie in den folgenden Ressourcen:

  • Zuletzt aktualisiert um