Genie Code verbinden met MCP-servers

Genie Code verbindt met externe tools, documenten en data via Model Context Protocol (MCP)-servers en native connectors voor Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack en GitHub. Gebruik de systeemeigen connectors voor algemene SaaS-bronnen of voeg uw eigen externe of aangepaste MCP-servers toe vanuit de werkruimte. U kiest welke hulpprogramma's u wilt inschakelen in Genie Code-instellingen.

Wat is MCP?

MCP is een open source standaard die agents verbindt met hulpprogramma's, resources, prompts en andere contextuele informatie. MCP biedt een gestandaardiseerde manier om hulpprogramma's, gegevens en werkstromen beschikbaar te maken voor Genie Code zonder die context rechtstreeks in te sluiten in prompts of instructies.

MCP is ontworpen voor gevallen waarin belangrijke context al bestaat, maar moeilijk toegankelijk is vanuit een agent, zoals Genie Code. MCP biedt een veilige manier om Genie Code toegang te geven tot context zoals hieronder:

  • Documentatiesystemen: Teams bewaart vaak runbooks of operationele documenten in hulpprogramma's zoals Confluence. In plaats van secties in prompts te kopiëren, kan die inhoud eenmaal worden weergegeven via een externe MCP-server en waarnaar wordt verwezen wanneer relevant is. Uw documenten zijn mogelijk ook al in Databricks als een AI Search-index, die Genie Code kan gebruiken om relevante documenten op te vragen.
  • Hulpprogramma's en services: Platformteams kunnen API's of scripts onderhouden voor het instellen, valideren of implementeren. MCP maakt deze mogelijkheden rechtstreeks beschikbaar voor Genie Code.
  • Gegevensbronnen: Als u al gegevens in Databricks hebt, kunt u Genie Code verbinden met een Genie-agent om u te helpen de gegevens te analyseren met natuurlijke taal. Voor gegevens die buiten Databricks zijn opgeslagen, kunt u Genie Code beveiligde toegang geven via externe MCP-servers.
  • Aangepaste apps: U kunt ook aangepaste functionaliteit toevoegen die wordt gehost via Databricks-apps. Hiermee kunt u Genie Code verbinden met eigen hulpprogramma's, werkstromen of integraties die speciaal voor u of uw organisatie zijn gebouwd, die allemaal veilig worden beheerd binnen uw Databricks-werkruimte.

In deze gevallen vervangt MCP handmatig kopiëren en plakken door een gestructureerde, herbruikbare benadering, waardoor de juiste context alleen beschikbaar is wanneer dit nodig is.

U kunt Genie Code verbinden met MCP-servers in uw werkruimte die u mag gebruiken. Werkruimtebeheerders bepalen welke servers beschikbaar zijn, terwijl gebruikers indien nodig uit deze goedgekeurde bronnen kunnen kiezen.

Voor meer informatie over MCP-servers in Databricks en hoe je je eigen servers kunt maken, zie MCP's.

Systeemeigen connectors gebruiken voor gegevensbronnen van derden

Genie Code biedt ingebouwde connectors voor veelvoorkomende bedrijfsdatabronnen:

  • 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.
  • 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.

Door verbinding te maken met deze databronnen kan Genie Code je documenten doorzoeken en acties uitvoeren in verbonden tools bij het beantwoorden van vragen. Elke gebruiker wordt afzonderlijk geverifieerd en OAuth-tokens worden niet gedeeld tussen gebruikers.

Deze verbindingen gebruiken door Databricks geleverde MCP-connectoren, dus er is geen server om te hosten en geen OAuth-app om te registreren. Azure Databricks beheert elke verbinding via Unity Catalog en Unity Gateway. De gateway autoriseert elke tooloproep tegen je Unity Catalog-rechten, past ingebouwde beleidsregels en goedkeuringseisen toe, en registreert gebruiks- en auditlogs in systeemtabellen. Zie Externe MCP-servers.

Een gegevensbron van derden verbinden:

  1. Klik in uw werkruimte op het codepictogram sparkle genie. Genie Code in de rechterbovenhoek om een chat te openen.
  2. Klik in de promptbalk op Nieuw pictogram. Het pluspictogram.
  3. Klik op Verbinden naast de gegevensbron waarmee u verbinding wilt maken.
  4. Voer de stappen uit om u aan te melden.

Nadat u zich hebt geverifieerd, kan Genie Code uw documenten doorzoeken bij het beantwoorden van vragen. Metastore-beheerders en eigenaren van verbindingen kunnen gebruikersmachtigingen voor de verbinding beheren of intrekken. Zie Machtigingen voor verbindingen verlenen en intrekken.

Opmerking

Tools voor gegevensbronnen worden niet altijd automatisch geactiveerd. Als documentzoekopdrachten niet worden gestart, probeert u genie code expliciet te vragen om het hulpprogramma te gebruiken, bijvoorbeeld 'Google Docs gebruiken' of 'gebruik SharePoint'.

Als u andere gegevensbronnen wilt verbinden, voegt u deze handmatig toe aan Genie Code. Zie MCP-servers handmatig toevoegen aan Genie Code.

Geplande taken en authenticatie

  • Genie Code waarschuwt je niet wanneer de authenticatie van een verbinding verloopt. Je komt er misschien pas achter als een tool-oproep mislukt of wanneer je de verbindingslijst opent. Herauthenticeer om het probleem te verhelpen.
  • Het wijzigen van de rechten van een verbinding vereist dat elke gebruiker opnieuw authenticeert. Geplande taken die de verbinding gebruiken, falen totdat de gebruiker zich opnieuw authenticeert.

Beperkingen voor Google Drive

  • Wanneer u Google Drive autoriseert, ziet u mogelijk het scherm 'niet-geverifieerde app'. 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.
  • Genie Code kan Google Docs, Sheets en Slides aanmaken en Google Docs bewerken via de connector. 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.

Opmerking

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-beperkingen

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

Microsoft 365 beperkingen

  • Bevat SharePoint, Teams, Outlook en Agenda.
  • Genie Code kan een Outlook-e-mail opstellen, maar kan die niet versturen.
  • De maximale bestandsgrootte is 25 MB voor SharePoint-bestanden.
  • Ondersteunde SharePoint bestandstypen zijn onder andere Office-documenten (.docx, .xlsx, .pptx), evenals veelgebruikte tekstgebaseerde formaten zoals .txt, .csv, .json, .md, , en andere. PDF-bestanden, afbeeldingen en andere binaire indelingen worden niet ondersteund.

Glean (Beta) beperkingen

  • 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 deze 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-beperkingen

  • Genie Code kan een bericht niet bewerken of verwijderen nadat het is verstuurd.

GitHub beperkingen

  • Schrijfopdrachten zijn beperkt tot bestandsinhoud, problemen en pull requests.
  • De Databricks-GitHub MCP-connector heeft standaard alleen toegang tot openbare opslagplaatsen. Als u de connector leestoegang wilt geven tot uw privé-bedrijfsopslagplaatsen, moet een GitHub organisatiebeheerder aanvullende instellingen voltooien. Zie GitHub private repositories.
  • GitHub Enterprise Server (de zelf-hostende versie van GitHub) wordt niet ondersteund.

MCP-servers handmatig toevoegen aan Genie Code

Als u Genie Code wilt verbinden met een MCP-server, voegt u deze toe aan uw Genie Code-instellingen:

  1. Open de instellingen van Genie Code. Klik in het deelvenster Genie Code op Tandwielpictogram. Instellingen.
  2. Klik onder MCP-servers op Nieuw pictogram. Server toevoegen.
  3. Selecteer de MCP-servers die u wilt toevoegen. U kunt door Databricks beheerde MCP-servers of externe MCP-servers selecteren:
    • UC MCP Service: Selecteer een service uit Selecteer een UC MCP-service. Gebruik een MCP-service voor een externe server die geregistreerd is in Unity Catalog. Zie Externe MCP-servers.
    • Unity Catalog- functie: selecteer het schema voor de functie. Hierdoor kan Genie Code functies gebruiken om vooraf gedefinieerde SQL-query's uit te voeren.
    • AI Search: selecteer het schema voor de index. Hierdoor kan Genie Code een query uitvoeren op de AI Search-index om relevante documenten te vinden.
    • Genie Agent: Selecteer de Genie Agent. De Genie MCP roept Genie aan als een hulpprogramma, zodat u een query kunt uitvoeren op de Genie-agent om gegevens te analyseren met natuurlijke taal.
    • Aangepaste MCP-server: selecteer de Databricks-app die u wilt gebruiken als een aangepaste MCP-server. Hiermee kunt u elk zelf gedefinieerd hulpprogramma gebruiken. De volgende vereisten zijn van toepassing:
      • Uw app moet worden geïmplementeerd in dezelfde werkruimte als waaruit u verbinding wilt maken.
      • De MCP-server moet worden geopend op https://<server-url>/mcp.
      • Uw app moet staatloos zijn. Stel bijvoorbeeld mcp_app = mcp_server.http_app(stateless_http=True)in.
      • Als er CORS-fouten optreden, moet u mogelijk uw werkruimte-URL toevoegen aan de lijst met toegestane origins van uw app. Stel bijvoorbeeld app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])in.
  4. Klik op Opslaan.

Nadat ze zijn toegevoegd, zijn MCP-servers onmiddellijk beschikbaar voor Genie Code. U kunt ze gaan gebruiken zonder uw aanwijzingen of instructies te wijzigen. Genie Code maakt automatisch gebruik van deze servers wanneer dit relevant is.

U kunt kiezen welke hulpprogramma's en servers u wilt in- of uitschakelen in uw Genie Code-instellingen.

Voor compliance-richtlijnen voor verbonden applicaties, zie Vereisten voor externe aanbieders.

Limitations

  • Laatst bijgewerkt om