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.
Un agent Genie peut utiliser des connecteurs MCP (Model Context Protocol) fournis par Databricks pour extraire du contexte et effectuer des actions dans des outils et sources externes lors d’une conversation en mode Agent . Un agent auteur attache les connecteurs, et chaque utilisateur s’authentifie séparément auprès de chacun d’eux. Chaque appel d’outil s’exécute avec les permissions de l’utilisateur qui pose la question.
Important
Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur d’espace de travail doit activer les outils MCP dans Genie Agents depuis la page des Aperçus . Consultez Gérer les préversions d’Azure Databricks.
Note
Les agents génie étaient anciennement appelés Génie Spaces.
Comment fonctionnent les connecteurs MCP dans un agent Genie
Les connecteurs MCP permettent à un agent Genie de combiner son analyse SQL et de fichiers avec les applications externes déjà utilisées par votre organisation. Par exemple, une seule conversation peut analyser un tableau de vente, extraire le contexte associé de Google Drive et rédiger un e-mail résumé. Azure Databricks gère chaque appel d’outil via Unity Catalog et Unity Gateway. Voir Gouverner un MCP.
Les outils MCP se divisent en deux catégories :
- Les outils en lecture seule (recherche, récupération et liste) s’exécutent automatiquement.
- Les outils d’écriture (par exemple, envoyer un message ou rédiger un e-mail) mettent en pause et demandent à l’utilisateur d’approuver l’action avant son exécution.
Les agents Genie prennent en charge les connecteurs MCP fournis par Databricks suivants :
- Google Drive : Recherchez et créez Google Docs, Sheets et Slides ; modifier les documents qu’il a créés.
- Gmail : recherchez, lisez et redécrivez les e-mails.
- Google Agenda : Recherchez et créez des événements dans le calendrier.
- Microsoft 365 : Recherchez SharePoint, Teams, Outlook et Calendrier ; rédigez un e-mail Outlook.
- Atlassian : Recherchez et mettez à jour Jira et Confluence.
- Glean (Bêta) : Recherchez dans les applications connectées de votre organisation à l’aide de Glean.
- Slack : Recherchez les messages et canaux Slack, et envoyez des messages.
- GitHub : Rechercher et mettre à jour les dépôts, les issues et les pull requests.
Requirements
Les conditions suivantes s’appliquent à l’agent et à ses utilisateurs :
- Catalogue Unity activé dans votre espace de travail.
- Mode agent disponible dans votre région. Consultez Services désignés Databricks.
- Unity Gateway disponible dans votre région. Consultez les régions prises en charge.
- L’accès à l’espace de travail et les droits d’accès Databricks SQL pour chaque utilisateur de l’agent. Les utilisateurs grand public uniquement, les utilisateurs Databricks SQL uniquement et les utilisateurs de compte uniquement ne peuvent pas utiliser les outils MCP. Consultez les droits d’accès.
- Un compte dans chaque système externe connecté pour chaque utilisateur pris en charge par l’agent.
Ajouter des connecteurs à un agent Genie
Pour attacher des connecteurs à un agent Genie :
- Ouvrez votre Genie Agent.
- Ouvrez l’onglet Sources , puis cliquez sur Ajouter.
- Sélectionnez un ou plusieurs services MCP.
Pour attacher un connecteur, il faut EXECUTE sur le service MCP du connecteur dans Unity Catalog, ainsi que de USE CATALOG et USE SCHEMA sur son catalogue parent et son schéma. Les connecteurs pour lesquels vous n’avez pas l’autorisation d’exécuter ne sont pas disponibles. Voir les MCP fournis par Databricks.
Configurer des outils
Après avoir connecté un connecteur, configurez comment l’agent l’utilise :
- Ajoutez une description claire expliquant comment et quand l’agent doit utiliser les outils du connecteur. Par exemple, vous pouvez indiquer à l’agent un format obligatoire de titre de ticket ou lui demander de consulter le profil d’un utilisateur au début de chaque conversation.
- Activez ou désactivez des outils individuels au sein d’un connecteur pour délimiter les actions que l’agent peut entreprendre.
Utilisez les outils MCP dans une conversation
Pour utiliser les outils MCP dans un Genie Agent :
- Ouvre un agent Genie qui a des connecteurs MCP attachés.
- Activez le mode Agent dans la zone de conversation.
- Authentifiez-vous auprès du connecteur depuis le volet Configurer. Si l’agent a besoin d’un connecteur que vous n’avez pas autorisé, ou si votre authentification a expiré, l’agent vous invite à vous connecter.
- Envoyez une invite qui utilise le connecteur. Lorsque l’agent appelle un outil d’écriture, choisissez Autoriser une fois pour approuver l’action unique, Toujours autoriser dans ce chat pour approuver cet outil pour le reste de la conversation, ou Refuser pour le refuser.
Pour confirmer qu’un connecteur fonctionne, posez une question qui l’exige, par exemple « Recherchez dans mon Google Drive le plan commercial du T3 ». L’agent cite la ressource externe utilisée dans sa réponse.
Limitations
Les limites suivantes s'appliquent :
- Les outils MCP fonctionnent uniquement en mode Agent. Ils ne fonctionnent pas en mode Chat.
- Via les API en mode Agent, seuls les outils de lecture fonctionnent, et les utilisateurs ne peuvent pas s’authentifier sur un connecteur. Terminez l’authentification et approuvez l’outil d’écriture dans l’interface utilisateur.
- Pour des conseils de conformité pour les applications connectées, voir Exigences fournisseurs externes.
Les sections suivantes décrivent les limitations pour des connecteurs spécifiques.
Google Drive
- Lorsque vous autorisez Google Drive, vous pouvez voir un écran Application non validée. Cliquez sur Avancé et poursuivez le processus 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 d’autres formats binaires ne sont pas pris en charge.
- Le connecteur peut créer Google Docs, Sheets et Slides, et modifier Google Docs qu’il a créés. Il ne peut pas modifier la documentation créée en dehors du connecteur, ni modifier les feuilles ou diapositives existantes.
- Lire un document très volumineux peut être lent.
Note
L’utilisation et le transfert de données utilisateur brutes ou dérivées reçues des API Google Workspace respecteront la stratégie de données utilisateur des services d’API 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 pièces jointes natives Gmail. Comme solution de contournement, incluez des liens vers les fichiers dans le corps de l’email.
Microsoft 365
- Inclut SharePoint, Teams, Outlook et Calendrier.
- Le connecteur peut rédiger un e-mail Outlook mais ne peut pas l'envoyer.
- La taille maximale des fichiers SharePoint est de 25 Mo.
- Les types de fichiers SharePoint pris en charge incluent des documents intégrés SharePoint, des feuilles de calcul et des présentations, 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.
Glean (Bêta)
- Glean est uniquement un moteur de recherche. Il ne peut pas lire un document depuis un lien direct.
- Un administrateur du metastore doit d’abord configurer l’ID du locataire Glean avant que les utilisateurs non administrateurs puissent utiliser la connexion. L’administrateur peut entrer l’ID de locataire lors de la première connexion à Glean.
- Pour se connecter à un serveur MCP spécifique de Glean, un administrateur du metastore peut optionnellement 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 par défaut (/mcp/default). Les utilisateurs non administrateurs ne peuvent pas spécifier ni modifier le chemin du serveur MCP de Glean.
Slack
- Le connecteur ne peut pas modifier ou supprimer un message après l’avoir envoyé.
GitHub
- L’écriture est limitée au contenu des fichiers, aux tickets et aux pull requests.
- Par défaut, le connecteur Databricks GitHub MCP ne peut accéder qu’aux référentiels publics. Pour permettre au connecteur d’accéder en lecture à vos référentiels d’entreprise privés, un administrateur d’organisation GitHub doit effectuer une configuration supplémentaire. Consultez Activer l’accès en écriture à GitHub et aux dépôts privés.
- GitHub Enterprise Server (la version auto-hébergée de GitHub) n’est pas prise en charge.
Ressources additionnelles
Pour plus d’informations, consultez les ressources suivantes :