Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Connectez Genie Code à des outils et sources de données externes via le protocole MCP (Model Context Protocol). Genie Code peut utiliser tous les serveurs MCP qui ont été ajoutés à votre espace de travail et que vous êtes autorisé à utiliser.
Note
Les serveurs MCP sont uniquement pris en charge en mode Agent de code Genie.
Qu’est-ce que MCP ?
MCP est une norme open source qui connecte des agents IA à des outils, des ressources, des invites et d’autres informations contextuelles. MCP fournit un moyen standardisé d’exposer des outils, des données et des flux de travail à Genie Code sans incorporer ce contexte directement dans des invites ou des instructions.
MCP est conçu pour les cas où un contexte important existe déjà, mais est difficile à accéder à partir d’un agent IA, comme Genie Code. MCP offre un moyen sécurisé d’accorder à Genie Code l’accès au contexte comme suit :
- Systèmes de documentation : Teams conserve souvent des runbooks ou des documents opérationnels dans des outils tels que Confluence. Au lieu de copier des sections dans des demandes, ce contenu peut être rendu disponible une fois par le biais d’un serveur MCP externe et référencé lorsqu’il est pertinent. Vos documents peuvent également être déjà dans Databricks en tant qu’index de recherche vectorielle, que Genie Code peut utiliser pour interroger des documents pertinents.
- Outils et services : les équipes de plateforme peuvent gérer des API ou des scripts pour l’installation, la validation ou le déploiement. MCP met ces fonctionnalités directement à la disposition de Genie Code.
- Sources de données : si vous avez déjà des données dans Databricks, vous pouvez connecter Le code Genie à un espace Génie pour vous aider à analyser les données à l’aide du langage naturel. Pour les données stockées en dehors de Databricks, vous pouvez accorder à Genie Code un accès sécurisé via des serveurs MCP externes.
- Applications personnalisées : vous pouvez également ajouter des fonctionnalités personnalisées hébergées via Databricks Apps. Cela vous permet de connecter Genie Code à des outils, workflows ou intégrations propriétaires créés spécifiquement pour vous ou votre organisation, tous gérés en toute sécurité dans votre espace de travail Databricks.
Dans ce cas, MCP remplace le collage manuel par une approche structurée et réutilisable, ce qui rend le contexte approprié disponible uniquement quand il est nécessaire.
Vous pouvez connecter Genie Code à tous les serveurs MCP de votre espace de travail que vous êtes autorisé à utiliser. Les administrateurs d’espace de travail contrôlent les serveurs disponibles, tandis que les utilisateurs peuvent choisir parmi ces sources approuvées si nécessaire.
Pour en savoir plus sur les serveurs MCP dans Databricks et sur la création de vos propres serveurs, consultez Le protocole MCP (Model Context Protocol) sur Databricks.
Se connecter à des sources de données tierces
Important
Cette fonctionnalité est en version bêta. Pour utiliser des connecteurs de source de données tiers, un administrateur d’espace de travail doit activer la préversion des connecteurs tiers pour les agents . Consultez les aperçus Manage Azure Databricks.
Genie Code fournit des connecteurs intégrés pour les sources de données d’entreprise courantes, notamment Google Drive et SharePoint.
La connexion à ces sources de données permet à Genie Code de rechercher vos documents lors de la réponse aux questions. Chaque utilisateur s’authentifie individuellement et les jetons OAuth ne sont pas partagés entre les utilisateurs.
Pour connecter une source de données tierce :
- Dans votre espace de travail, cliquez sur
Génie Code dans le coin supérieur droit pour ouvrir une conversation.
- Dans la barre d’invite, cliquez sur
Icône plus.
- À côté de la source de données à laquelle vous souhaitez vous connecter, cliquez sur Connecter.
- Effectuez les étapes de connexion.
Après vous être authentifié, Genie Code peut rechercher vos documents lors de la réponse aux questions. Les administrateurs de metastore et les propriétaires de connexions peuvent gérer ou révoquer des autorisations utilisateur sur la connexion. Consultez Partager la connexion du serveur MCP.
Note
Les outils de source de données ne se déclenchent pas toujours automatiquement. Si la recherche de documents ne démarre pas, essayez explicitement d'inviter Génie Code à utiliser l'outil, par exemple « utiliser Google Docs » ou « utiliser SharePoint ».
Pour connecter d’autres sources de données, ajoutez-les manuellement à Genie Code. Consultez Ajouter manuellement des serveurs MCP à Genie Code.
Limitations de Google Drive
- Lorsque vous autorisez Google Drive, vous pouvez voir un écran « application non vérifiée ». Cliquez sur Avancé et poursuivez le processus d’autorisation.
- La taille maximale du fichier est de 10 Mo.
- Seuls les fichiers Google Workspace natifs (Docs, Sheets, Slides) sont pris en charge. Les fichiers PDF, les images et d’autres formats binaires ne sont pas pris en charge.
- Des erreurs liées à l'expiration de la connexion ou du jeton peuvent survenir dans les résultats de l’agent. Authentifiez-vous à nouveau pour résoudre.
limitations de SharePoint
- La taille maximale du fichier est de 10 Mo.
- Les types de fichiers pris en charge incluent des documents Office (.docx, .xlsx, .pptx), ainsi que des formats texte courants tels que
.txt, ,.csv.json, ,.mdet d’autres. Les fichiers PDF, les images et d’autres formats binaires ne sont pas pris en charge.
Ajouter manuellement des serveurs MCP à Genie Code
Pour connecter Genie Code à un serveur MCP, ajoutez-le dans vos paramètres Génie Code :
- Ouvrez les paramètres de Génie Code. Dans le panneau Génie Code, cliquez sur
Paramètres.
- Sous Serveurs MCP, cliquez sur
Ajouter un serveur.
- Sélectionnez les serveurs MCP que vous souhaitez ajouter. Vous pouvez sélectionner des serveurs MCP gérés par Databricks ou des serveurs MCP externes :
-
Fonction catalogue Unity : sélectionnez le schéma de la fonction. Cela permet à Genie Code d’utiliser des fonctions pour exécuter des requêtes SQL prédéfinies.
- Pour obtenir de l’aide sur l’ajout d’un serveur MCP GitHub, consultez créer un serveur MCP GitHub.
- Recherche vectorielle : sélectionnez le schéma de l’index. Cela permet à Genie Code d’interroger l’index de recherche vectorielle pour rechercher des documents pertinents.
- Genie Space : Sélectionnez l’espace Génie. Le GÉNIE MCP appelle Genie en tant qu’outil, ce qui vous permet d’interroger l’espace Génie pour analyser les données à l’aide du langage naturel.
- Serveur MCP externe : sélectionnez la connexion de catalogue Unity à utiliser en tant que serveur MCP externe. Vous devez d’abord vous connecter à la connexion avant de pouvoir l’utiliser.
-
Serveur MCP personnalisé : sélectionnez l’application Databricks à utiliser comme serveur MCP personnalisé. Cela vous permet d’utiliser n’importe quel outil défini sur mesure. Les conditions suivantes s’appliquent :
- Votre application doit être déployée dans le même espace de travail que celui à partir duquel vous essayez de vous y connecter.
- Le serveur MCP doit être accessible à l’adresse
https://<server-url>/mcp. - Votre application doit être sans état. Par exemple, définissez
mcp_app = mcp_server.http_app(stateless_http=True). - Si vous rencontrez des erreurs CORS, vous devrez peut-être ajouter l’URL de votre espace de travail à la liste des origines autorisées de votre application. Par exemple, définissez
app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
-
Fonction catalogue Unity : sélectionnez le schéma de la fonction. Cela permet à Genie Code d’utiliser des fonctions pour exécuter des requêtes SQL prédéfinies.
- Cliquez sur Enregistrer.
Une fois qu’ils ont été ajoutés, les serveurs MCP sont immédiatement disponibles pour Genie Code. Vous pouvez commencer à les utiliser en mode Agent sans modifier vos invites ou instructions. Génie Code utilisera automatiquement ces serveurs lorsque cela est pertinent.
Actuellement, l’accès MCP est limité à 20 outils sur tous les serveurs. Vous pouvez choisir les outils et les serveurs à activer ou désactiver dans vos paramètres De Code Génie.