Verbind een Genie Agent met MCP-tools en bronnen

Een Genie Agent kan MCP-connectors van Databricks gebruiken om context te halen uit en acties uit te voeren in externe tools en bronnen tijdens een Agent-modus gesprek. Een agent-auteur koppelt de connectors, en elke gebruiker authenticeert zich individueel bij hen. Elke tool-aanroep wordt uitgevoerd met de rechten van de gebruiker die de vraag stelt.

Important

Deze functie bevindt zich in de bètaversie. Om het te gebruiken, moet een workspace-beheerder MCP-tools inschakelen in Genie Agents via de pagina Previews . Zie Azure Databricks previews beheren.

Note

Genie Agenten werden voorheen Genie Spaces genoemd.

Hoe MCP-connectoren werken in een Genie Agent

MCP-connectors stellen een Genie Agent in staat zijn SQL- en bestandsanalyse te combineren met de externe applicaties die uw organisatie al gebruikt. Een enkel gesprek kan bijvoorbeeld een verkooptabel analyseren, gerelateerde context uit Google Drive halen en een samenvattende e-mail opstellen. Azure Databricks beheert elke tool-aanroep via Unity Catalog en Unity Gateway. Zie Een MCP beheren.

MCP-tools vallen in twee categorieën:

  • Hulpmiddelen met alleen-leestoegang (zoeken, ophalen en weergeven) draaien automatisch.
  • Schrijftools (bijvoorbeeld een bericht sturen of een e-mail opstellen) pauzeren en de gebruiker vragen de actie goed te keuren voordat deze wordt uitgevoerd.

Genie Agents ondersteunen de volgende door Databricks geleverde MCP-connectoren:

  • Google Drive: Zoek en maak Google Docs, Sheets en Dia's aan; bewerk de documenten die het heeft aangemaakt.
  • Gmail: Zoek, lees en stel e-mails op.
  • Google Calendar: Zoek en maak agenda-evenementen aan.
  • Microsoft 365: Zoek in SharePoint, Teams, Outlook en Agenda; stel Outlook-e-mail op.
  • Atlassian: Zoek en update Jira en Confluence.
  • Asana: Zoek in taken, projecten, portfolio's, gebruikers en teams, en maak of werk taken aan wanneer schrijfacties zijn toegestaan.
  • Glean (Beta): Zoek in de verbonden apps van je organisatie met Glean.
  • Slack: Zoek in Slack-berichten en -kanalen, en stuur berichten.
  • GitHub: Zoek repositories, issues en pull requests en werk deze bij.

Requirements

De volgende vereisten zijn van toepassing op de agent en de bijbehorende gebruikers:

  • Zowel de toegang tot de werkruimte als de toegangsrechten voor Databricks SQL voor elke gebruiker van de agent. Gebruikers met alleen consumententoegang, alleen Databricks SQL-toegang en alleen accounttoegang kunnen geen MCP-tools gebruiken. Zie Toegangsrechten.
  • Een account in elk verbonden extern systeem voor elke gebruiker van de agent.

Voeg connectoren toe aan een Genie Agent

Om connectoren aan een Genie Agent te koppelen:

  1. Open je Genie Agent.
  2. Open het tabblad Bronnen en klik vervolgens op Toevoegen.
  3. Selecteer één of meer MCP-diensten (MCP).

Om een connector te koppelen, heb je EXECUTE nodig voor de MCP-service van de connector in Unity Catalog, plus USE CATALOG en USE SCHEMA voor de bovenliggende catalogus en het schema. Connectoren waarvoor je geen toestemming hebt om uit te voeren zijn niet beschikbaar. Zie door Databricks geleverde MCP's.

Hulpprogramma's configureren

Nadat je een connector hebt aangesloten, configureer je hoe de agent deze gebruikt:

  • Voeg een duidelijke beschrijving toe waarin wordt uitgelegd hoe en wanneer de agent de tools van de connector moet gebruiken. Je kunt bijvoorbeeld de agent instrueren over het vereiste ticket-titelformaat of hem vragen het profiel van een gebruiker aan het begin van elk gesprek op te zoeken.
  • Schakel individuele tools in of uit binnen een connector om te bepalen welke acties de agent kan uitvoeren.

Gebruik MCP-tools in een gesprek

Om MCP-tools te gebruiken in een Genie Agent:

  1. Open een Genie Agent waaraan MCP-connectoren zijn gekoppeld.

  2. Schakel de agentmodus in het chatvak in.

  3. Verifieer je op de connector vanuit het Configure-paneel. Als de agent een connector nodig heeft die je niet hebt geautoriseerd, of je authenticatie is verlopen, vraagt de agent je om in te loggen.

    Als je organisatie het aanmelden blokkeert, zie Beheerdersgoedkeuring voor connectors verkrijgen.

  4. Stuur een prompt die de connector gebruikt. Wanneer de agent een schrijftool aanroept, kies Eenmalig toestaan om de enkele actie goed te keuren, Altijd toestaan in deze chat om die tool voor de rest van het gesprek toe te staan, of Weiger om deze te weigeren.

Om te bevestigen dat een connector werkt, stel je een vraag waarvoor die connector nodig is, bijvoorbeeld: "Zoek in mijn Google Drive naar het Q3-verkoopplan." De agent verwijst in zijn antwoord naar de externe bron die hij gebruikte.

Vraag om goedkeuring van de beheerder voor connectors

Twee groepen beheerders bepalen of gebruikers kunnen inloggen op een connector en wat de verbinding kan doen:

  • Providerbeheerders: De beheerders van je organisatie, Slack, Google Workspace, Microsoft Entra ID of GitHub bepalen of gebruikers de app kunnen autoriseren en welke rechten deze krijgt, zoals OAuth-scopes of toegang tot GitHub-repositories. Zij zijn vaak niet je Azure Databricks-beheerders.
  • Azure Databricks beheerders: Gebruikers met het MANAGE privilege op de MCP van een connector bepalen welke tools beschikbaar zijn en wie ze kan oproepen. Zie Een MCP beheren.

Als een provider het inloggen blokkeert of beperkt wat een connector kan benaderen, deel dan de stappen voor die provider met zijn beheerder. Nadat de beheerder de app heeft goedgekeurd, log je uit via de connector en log je opnieuw in om de goedgekeurde rechten te krijgen. Zie Aanmelden bij provider beheren.

Keur de Databricks Genie-app goed in Slack

Als je Slack-werkruimte app-goedkeuring vereist, waarschuwt het Slack-aanmeldscherm dat de app waarschijnlijk geblokkeerd is. Slack kan ook machtigingen intrekken die een beheerder niet heeft goedgekeurd. Bijvoorbeeld, het inloggen lukt, maar de connector kan geen berichten verzenden.

Een Slack Workspace-eigenaar of app-manager moet de Databricks Genie-app goedkeuren:

  1. Klik in Slack op Admin in de zijbalk.
  2. Selecteer apps en workflows om de Slack Marketplace te openen.
  3. Klik op Bladeren, zoek vervolgens naar en selecteer Databricks Genie.
  4. Bekijk de gevraagde rechten en klik op Goedkeuren. De toestemming chat:write () laat gebruikers berichten via de connector verzenden.

Als een gebruiker de app al heeft aangevraagd, kan de Workspace Owner of appmanager het openstaande verzoek goedkeuren. Zie App-goedkeuring beheren voor je werkruimte.

Wanneer Azure Databricks een toestemming toevoegt aan de connector, vraagt Slack opnieuw om goedkeuring. Totdat de nieuwe toestemming is goedgekeurd, mislukt het inloggen of negeert Slack de nieuwe toestemming.

Wanneer je opnieuw inlogt, controleer dan de acties die Databricks Genie kan uitvoeren op het Slack-inlogscherm. De lijst zou het verzenden van berichten moeten bevatten. Als de connector nog steeds geen berichten kan versturen, vraag dan een metastore-beheerder of een andere gebruiker met MANAGE op system.ai.slack om zijn tools te controleren:

  1. Selecteer in Unity GatewayMCP's en open system.ai.slack.
  2. Klik op Tools bewerken op Overzicht.
  3. Controleer of de tools die berichten verzenden geselecteerd zijn en klik dan op Wijzigingen opslaan.

Zie Kies beschikbare tools.

Laat de connectors in Google Workspace toe

Als Google-aanmelding een toegangsblokkeerfout toont of zegt dat het beleid van je beheerder de app blokkeert, beperkt je Google Workspace-beheerder welke apps van derden toegang hebben tot Google-gegevens. De koppelingen voor Google Drive, Gmail en Google Agenda gebruiken dezelfde Google OAuth-app, dus één configuratie dekt alle drie.

Een Google Workspace-beheerder met het beheerdersrecht Service Settings moet de app configureren:

  1. Ga in de Google Admin-console naar Security>Toegang en gegevensbeheer>API-controles.
  2. Klik op App-toegang beheren.
  3. Voor geconfigureerde apps, klik op Configureer nieuwe app.
  4. Voer de client-ID 645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.comin, klik op Zoeken en klik op de app in de zoekresultaten.
  5. Voor Scope laat je de bovenste organisatie-eenheid geselecteerd om toegang voor alle gebruikers te configureren, of klik je op Org-eenheden selecteren om specifieke organisatie-eenheden te kiezen. Klik op Continue.
  6. Voor Toegang tot Google-gegevens, selecteer Vertrouwd. Om alleen de scopes toe te staan die de connectors aanvragen, kies je in plaats daarvan Specifieke Google-data en voeg je de scopes toe die in Managed OAuth providers staan. Klik op Continue.
  7. Bekijk de instellingen en klik op Voltooien.

De app verschijnt in de lijst Geconfigureerde apps met het toegangsniveau dat je hebt gekozen. Zie Beheer welke apps toegang krijgen tot Google Workspace-gegevens.

Keur Microsoft 365-rechten goed

De Microsoft 365-connector vraagt zijn machtigingen van Microsoft Graph aan voor SharePoint, OneDrive, Teams, Outlook, Agenda en online vergaderingen in één toestemmingverlening. Gebruikers en beheerders kunnen niet alleen voor sommige ervan toestemming geven, zoals alleen de Outlook-mailrechten. Voor de volledige lijst, zie Microsoft 365 scopes.

Rechten die eindigen op .All vereisen doorgaans toestemming van de administrator. Als je organisatie goedkeuring van beheerders vereist, deel dan de app-naam uit het toestemmingsscherm met je Microsoft Entra ID-beheerder.

Om te beperken wat de connector kan doen, kan een metastore-beheerder of een andere gebruiker met MANAGE op system.ai.microsoft_365 zijn schrijftools verwijderen. Zie Kies beschikbare tools. Het verwijderen van tools bepaalt welke tools de connector kan oproepen. Het verandert de rechten die het toestemmingsscherm vraagt niet.

Schakel GitHub schrijftoegang en privé-repositorytoegang in

Standaard kan de GitHub-connector (system.ai.github) alleen publieke repositories lezen. Om toegang te krijgen tot private repositories, of om wijzigingen aan te brengen zoals het committen van bestanden of het aanmaken van issues en pull requests, moet de repository-eigenaar of een GitHub-organisatiebeheerder:

  1. Installeer de Databricks GitHub connector-app en geef deze toegang tot de vereiste repositories.

  2. Als de organisatie een IP-toelaatlijst gebruikt, voeg dan de Azure Databricks serverless uitgaande IP's toe voor de cloud en regio van je werkruimte.

Nadat de app is geïnstalleerd, kunnen gebruikers met de toegekende repositories werken via de connector, binnen hun eigen GitHub-rechten.

Limitations

De volgende beperkingen zijn van toepassing:

  • MCP-tools draaien alleen in Agent-modus. Ze draaien niet in Chatmodus.
  • Via de Agent-modus API's werken alleen leestools, en kunnen gebruikers zich niet authenticeren bij een connector. Voltooi authenticatie en goedkeuring voor de schrijftool in de UI.
  • Voor compliance-richtlijnen voor verbonden applicaties, zie Vereisten voor externe aanbieders.

De volgende secties beschrijven beperkingen voor specifieke connectoren.

Google Drive

  • Bij het autoriseren van Google Drive kun je een scherm voor de niet-geverifieerde app zien. Klik op Geavanceerd en ga door met het autorisatieproces.
  • De maximale bestandsgrootte is 25 MB.
  • Alleen systeemeigen Google Workspace-bestanden (Docs, Sheets, Dia's) worden ondersteund. PDF-bestanden, afbeeldingen en andere binaire indelingen worden niet ondersteund.
  • De connector kan Google Docs, Sheets en Slides aanmaken en Google Docs bewerken die hij heeft aangemaakt. Het kan geen documenten bewerken die buiten de connector zijn gemaakt, of bestaande sheets of dia's bewerken.
  • Het lezen van een heel groot document kan traag zijn.

Note

Het gebruik en de overdracht van onbewerkte of afgeleide gebruikersgegevens die zijn ontvangen van Google Workspace-API's, voldoen aan het beleid voor gebruikersgegevens van Google API-services, met inbegrip van de vereisten voor beperkt gebruik.

Gmail

  • De connector kan e-mails zoeken, lezen en opstellen, maar kan geen e-mails versturen of bestaande berichten bewerken.
  • De connector kan geen Drive-bestanden toevoegen als native Gmail-bijlagen. Als workaround kun je links naar de bestanden in de e-mailtekst opnemen.

Microsoft 365

  • Omvat SharePoint, OneDrive, Teams, Outlook, Agenda en online vergaderingen.
  • De connector kan een Outlook-e-mail opstellen, maar kan deze niet versturen.
  • De maximale bestandsgrootte is 25 MB voor SharePoint-bestanden.
  • Ondersteunde SharePoint bestandstypen zijn ingebouwde SharePoint documenten, spreadsheets en presentaties, evenals algemene tekstindelingen zoals .txt, .csv, .json, en .mdandere. PDF-bestanden, afbeeldingen en andere binaire indelingen worden niet ondersteund.

Glean (Beta)

  • Glean is alleen zoekbaar. Het kan geen document lezen via een directe link.
  • Een metastore-beheerder moet eerst de Glean-tenant-ID configureren voordat niet-beheerders de verbinding kunnen gebruiken. De beheerder kan de tenant-id invoeren wanneer hij voor het eerst verbinding maakt met Glean.
  • Om verbinding te maken met een specifieke Glean MCP-server kan een metastore-beheerder optioneel het MCP-serverpad instellen (bijvoorbeeld /mcp/eng) bij het instellen van de verbinding. Laat dit veld leeg om het standaardpad (/mcp/default) te gebruiken. Niet-beheerders kunnen het Glean MCP-serverpad niet specificeren of wijzigen.

Slack

  • De connector kan een bericht niet bewerken of verwijderen nadat het is verzonden.

GitHub

  • Schrijfopdrachten zijn beperkt tot bestandsinhoud, problemen en pull requests.
  • De Databricks-GitHub MCP-connector heeft standaard alleen toegang tot openbare opslagplaatsen. Om toegang te krijgen tot private repositories, of om wijzigingen aan te brengen zoals het committen van bestanden of het aanmaken van issues en pull requests, moet de repository-eigenaar of een GitHub-organisatiebeheerder extra instellingen uitvoeren. Zie GitHub schrijftoegang en privé-repository toegang inschakelen.
  • GitHub Enterprise Server (de zelf-hostende versie van GitHub) wordt niet ondersteund.

Aanvullende bronnen

Zie de volgende bronnen voor gerelateerde informatie: