Genie Code verbinden met MCP-servers

Verbind Genie Code met externe hulpprogramma's en gegevensbronnen via het Model Context Protocol (MCP). Genie Code kan alle MCP-servers gebruiken die zijn toegevoegd aan uw werkruimte en die u gemachtigd hebt om te gebruiken.

Wat is MCP?

MCP is een open source standaard waarmee AI-agents worden verbonden 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 AI-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 vectorzoekindex, 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 Space 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 een keuze kunnen maken uit deze goedgekeurde bronnen.

Zie Model Context Protocol (MCP) op Databricks voor meer informatie over MCP-servers in Databricks en hoe u uw eigen servers maakt.

Verbinding maken met gegevensbronnen van derden

Genie Code biedt ingebouwde connectors voor algemene zakelijke gegevensbronnen, waaronder Google Drive en SharePoint.

Door verbinding te maken met deze gegevensbronnen kan Genie Code uw documenten doorzoeken bij het beantwoorden van vragen. Elke gebruiker wordt afzonderlijk geverifieerd en OAuth-tokens worden niet gedeeld tussen gebruikers.

Een gegevensbron van derden verbinden:

1. Klik in uw werkruimte op Genie Code in de rechterbovenhoek om een chat te openen.
2. Klik in de promptbalk op 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 verbindingseigenaren kunnen gebruikersmachtigingen voor de verbinding beheren of intrekken. Zie De MCP-serververbinding delen.

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

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 10 MB.
• Alleen systeemeigen Google Workspace-bestanden (Docs, Sheets, Dia's) worden ondersteund. PDF-bestanden, afbeeldingen en andere binaire indelingen worden niet ondersteund.
• Fouten met verlopen verbindingen of tokens kunnen worden weergegeven in de uitvoer van de agent. Herauthenticeer om het probleem te verhelpen.

SharePoint beperkingen

• De maximale bestandsgrootte is 10 MB.
• Ondersteunde bestandstypen zijn Onder andere Office-documenten (.docx, .xlsx, .pptx), evenals veelgebruikte indelingen op basis van tekst, zoals .txt, .csv.json, en .mdandere. PDF-bestanden, afbeeldingen en andere binaire indelingen worden 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 Instellingen.
2. Klik onder MCP-servers op Server toevoegen.
3. Selecteer de MCP-servers die u wilt toevoegen. U kunt door Databricks beheerde MCP-servers of externe MCP-servers selecteren:
   • Unity Catalog- functie: selecteer het schema voor de functie. Hierdoor kan Genie Code functies gebruiken om vooraf gedefinieerde SQL-query's uit te voeren.
     • Zie maak van een GitHub MCP-server voor hulp bij het toevoegen van een GitHub MCP-server.
   • Vectorzoekopdrachten: selecteer het schema voor de index. Hierdoor kan Genie Code een query uitvoeren op de vectorzoekindex om relevante documenten te vinden.
   • Genie Space: Selecteer de Genie Space. De Genie MCP roept Genie aan als een hulpprogramma, zodat u een query kunt uitvoeren op de Genie-ruimte om gegevens te analyseren met natuurlijke taal.
   • Externe MCP-server: selecteer de Unity Catalog-verbinding die moet worden gebruikt als een externe MCP-server. U moet zich eerst aanmelden bij de verbinding voordat deze kan worden gebruikt.
   • 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 deze gaan gebruiken in de agentmodus zonder uw prompts of instructies te wijzigen. Genie Code maakt automatisch aanspraak op deze servers wanneer dit relevant is.

Momenteel is MCP-toegang beperkt tot 20 hulpprogramma's op alle servers. U kunt kiezen welke hulpprogramma's en servers u wilt in- of uitschakelen in uw Genie Code-instellingen.