Connecter un agent Genie Agent aux outils et sources MCP
Un agent Genie Agent peut utiliser des outils MCP (Model Context Protocol) pour extraire du contexte d'outils et de sources externes et effectuer des actions dans ceux-ci. Un auteur d’agent attache des connecteurs fournis par Databricks ou des serveurs MCP externes enregistrés dans Unity Gateway. Les utilisateurs peuvent ensuite demander à l’agent d’utiliser ces outils dans les conversations en mode agent.
Les Genie Agents s’appelaient auparavant des Genie space.
Fonctionnement des connecteurs MCP dans un Genie Agent
Les connecteurs MCP permettent à un Genie Agent de combiner son analyse SQL et de fichiers avec les applications externes que votre organisation utilise déjà. Par exemple, une seule conversation peut analyser une table de ventes, extraire le contexte associé de Google Drive et rédiger un e-mail de synthèse. Databricks régit chaque appel d’outil par le biais d’Unity Catalog et d’Unity Gateway. Consultez la section Govern an MCP.
Les agents Genie prennent en charge deux types de sources MCP :
-
Connecteurs fournis par Databricks : connecteurs que Databricks gère pour les applications courantes. Les connecteurs suivants sont disponibles :
- Google Drive : recherchez et créez des documents Google Docs, Sheets et Slides, et modifiez les documents Docs qu'il a créés.
- Google : search, read et draft e-mail.
- Google Calendar : recherchez et créez des événements de calendrier.
- Microsoft 365 : recherchez dans SharePoint, Teams, Outlook et le calendrier ; rédigez un e-mail Outlook.
- Atlassian : recherchez et mettez à jour des éléments dans Jira et Confluence.
- Asana : recherchez des tâches, des projets, des portefeuilles, des utilisateurs et des équipes, et créez ou mettez à jour des tâches lorsque les actions d'écriture sont autorisées.
- Glean (bêta) : recherchez dans les applications connectées de votre organisation à l'aide de Glean.
- Slack : recherchez des messages et des Canaux de distribution sur Slack, et envoyez des messages.
- GitHub : recherchez et mettez à jour des repositories, des problèmes et des demandes d'extraction.
-
Serveurs MCP externes : serveurs MCP auto-hébergés ou tiers que votre organisation enregistre dans Unity Gateway. Voir les serveurs MCP externes.
Conditions requises
Les exigences suivantes s'appliquent à l'agent et à ses utilisateurs :
-
Unity Catalog enabled in your workspace.
-
Le mode Agent est disponible dans votre région. Découvrez les services désignés Databricks.
-
Unity Gateway disponible dans votre région. Voir les régions prises en charge.
-
Les utilisateurs disposant uniquement d'un compte ne peuvent pas utiliser les outils MCP. Voir Droits d'accès.
-
Chaque utilisateur doit disposer d’un compte dans chaque outil ou source MCP connecté.
-
Pour attacher un connecteur, l’auteur de l’agent doit disposer de
EXECUTEsur son MCP, ainsi queUSE CATALOGetUSE SCHEMAsur le catalogue et le schéma parent. Les connecteurs que l’auteur n’est pas autorisé à exécuter ne sont pas disponibles. Consultez Partager un MCP.
Ajouter des connecteurs à un Genie Agent
Pour joindre des connecteurs à un Genie Agent :
- Ouvrez votre Genie Agent.
- Ouvrez le Sources tab, puis cliquez sur Ajouter .
- Sélectionnez un ou plusieurs services MCP. Vous pouvez choisir des connecteurs fournis par Databricks ou des serveurs MCP externes enregistrés dans Unity Gateway.
La manière dont les utilisateurs s’authentifient auprès d’un serveur MCP externe dépend de ses identifiants :
- OAuth par utilisateur : Chaque utilisateur doit se connecter avant que l’agent ne puisse utiliser les outils du serveur.
- Informations d'identification partagées : les utilisateurs ne se connectent pas. Si les informations d'identification partagées cessent de fonctionner, l'agent indique à l'utilisateur que le propriétaire du serveur doit les mettre à jour.
Configurer les outils
Après avoir rattaché un connecteur, configurez la manière dont l'agent l'utilise :
- Ajoutez une description claire qui explique comment et quand l'agent doit utiliser les outils du connecteur. Par exemple, vous pouvez instruire l'agent sur un format de titre de ticket requis ou lui demander de rechercher le profil d'un utilisateur au start de chaque conversation.
- Activez ou désactivez des outils individuels au sein d'un connecteur pour définir le périmètre des actions que l'agent peut effectuer.
Utiliser des outils MCP dans une conversation
Pour utiliser des outils MCP dans un Genie Agent :
-
Ouvrez un Genie Agent auquel des connecteurs MCP sont rattachés.
-
Assurez-vous que le mode Agent est activé.
-
Si un connecteur nécessite une connexion, authentifiez-vous à partir de la liste Sources ou lorsque l’agent vous y invite.
Si votre organisation bloque la connexion, consultez Configuration supplémentaire des applications tierces.
-
Envoyez une invite qui utilise le connecteur.
Vous pouvez également utiliser les outils MCP via les APIs du mode Agent. Si un connecteur nécessite une connexion, la réponse de l’API demande à l’utilisateur de se connecter.
Obtenir l’approbation de l’administrateur pour les connecteurs
Vos administrateurs Slack, Google Workspace, Microsoft 365 ou GitHub devront peut-être approuver ou configurer l’application Databricks pour que les utilisateurs puissent se connecter. Pour connaître les étapes à suivre pour chaque fournisseur, consultez la rubrique Configuration supplémentaire de l’application tierce.
Limitations
Les limitations suivantes s’appliquent :
- Les outils MCP s'exécutent uniquement en mode Agent. Ils ne s'exécutent pas en mode Chat.
- Un agent Genie Agent peut avoir jusqu'à 10 connexions MCP, incluant à la fois les connecteurs fournis par Databricks et les serveurs MCP externes.
- Les Service Principal ne peuvent pas utiliser les outils MCP.
- Pour obtenir des conseils de conformité concernant les applications connectées, consultez la page External provider requirements.
Les sections suivantes décrivent les limitations pour des connecteurs spécifiques.
Google Drive
- Lors de l’autorisation de Google Drive, vous pourriez voir un écran Application non vérifiée . Cliquez sur Advanced et poursuivez la procédure d'autorisation.
- La taille maximale du fichier est de 25 Mo.
- Seuls les fichiers Google Workspace natifs (Docs, Sheets, Slides) sont pris en charge. Les fichiers PDF, les images et les autres formats binaires ne sont pas pris en charge.
- Le connecteur peut créer des documents Google Docs, Sheets et Slides, et modifier les Google Docs qu'il a créés. Il ne peut pas modifier les documents créés en dehors du connecteur, ni modifier les Sheets ou Slides existants.
- La lecture d’un document très volumineux peut s’avérer lente.
L'utilisation et le transfert de données utilisateur brutes ou dérivées reçues des APIs Google Workspace doivent respecter la Politique relative aux données utilisateur des services API de Google, y compris les exigences d'utilisation limitée.
Gmail
- Le connecteur peut rechercher, lire et rédiger des e-mails, mais il ne peut pas envoyer d’e-mails ni modifier des messages existants.
- Le connecteur ne peut pas ajouter de fichiers Drive en tant pièces jointes Gmail natives. Par mesure de contournement, incluez des Link vers les fichiers dans le corps de l’e-mail.
Microsoft 365
- Inclut SharePoint, OneDrive, Teams, Outlook, le calendrier et les réunions en ligne.
- Le connecteur peut rédiger un e-mail Outlook, mais ne peut pas l'envoyer.
- La taille maximale du fichier est de 25 Mo pour les fichiers SharePoint.
- Les types de fichiers SharePoint pris en charge incluent les documents, feuilles de calcul et présentations SharePoint intégrés, ainsi que les formats textuels courants tels que
.txt,.csv,.json,.md, et d'autres. Les fichiers PDF, les images et les autres formats binaires ne sont pas pris en charge.
Glean (bêta)
- Glean effectue uniquement des recherches. Impossible de lire un document à partir d'un Link direct.
- Un administrateur du metastore doit d'abord configurer l'ID de tenant Glean avant que les utilisateurs non administrateurs ne puissent utiliser la connexion. L'administrateur peut saisir l'ID de tenant lors de la première connexion à Glean.
- Pour vous connecter à un serveur MCP Glean spécifique, un administrateur de metastore peut éventuellement définir le chemin du serveur MCP (par exemple,
/mcp/eng) lors de la configuration de la connexion. Laissez ce champ vide pour utiliser le chemin default (/mcp/default). Les utilisateurs non administrateurs ne peuvent pas spécifier ni modifier le chemin du serveur MCP Glean.
Slack
- The connector can't edit or delete a message after sending it.
GitHub
- Les écritures sont limitées au contenu des fichiers, aux problèmes et aux requêtes pull.
- By default, le connecteur MCP Databricks GitHub ne peut accéder qu’aux repository publics. Pour accéder aux repository privés, ou pour effectuer des modifications telles que le commit de fichiers ou la création d’issues et de pull requests, le propriétaire du repository ou un administrateur d’organisation GitHub doit effectuer une configuration supplémentaire. Voir Activer l’accès en écriture GitHub et l’accès aux repository privés.
- GitHub Enterprise Server (la version auto-hébergée de GitHub) n'est pas pris en charge.
Ressources supplémentaires
Consultez les ressources suivantes pour obtenir des informations connexes :