Aller au contenu principal
Dernière mise à jour le

Connect a Genie Agent to external tools and sources

Un Genie Agent 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 auteur d’agent joint les connecteurs et chaque utilisateur s’authentifie auprès d’eux individuellement. Chaque appel d’outil s’exécute avec les autorisations de l’utilisateur qui pose la question.

info

Bêta

Cette fonctionnalité est en version bêta. Pour l’utiliser, l’administrateur d’un workspace doit activer l’option Connect external tools in Genie Agents depuis la page Previews . Consultez Gérer les aperçus Databricks.

remarque

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 outils MCP se répartissent en deux catégories :

  • Les outils en lecture seule (recherche, récupération et listage) s’exécutent automatiquement.
  • Les outils d'écriture (par exemple, envoyer un message ou rédiger un e-mail) s'interrompent et demandent à l'utilisateur d'approuver l'action avant son exécution.

Les Genie Agents prennent en charge les connecteurs MCP fournis par Databricks suivants :

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

Conditions requises​

Les exigences suivantes s'appliquent à l'agent et à ses utilisateurs :

  • Unity Catalog enabled in your workspace.

  • Agent mode available in your region. See Regional availability.

  • Unity Gateway disponible dans votre région. Voir les régions prises en charge.

  • Les droits Workspace access et Databricks SQL access pour chaque utilisateur de l'agent. Les utilisateurs exclusifs au rôle de consommateur (Consumer-only), exclusifs à Databricks SQL et exclusifs au compte ne peuvent pas utiliser les outils MCP. Voir Access entitlements.

  • Un compte dans chaque système externe connecté pour chaque utilisateur de l'agent.

Ajouter des connecteurs à un Genie Agent​

Pour joindre des connecteurs à un Genie Agent :

  1. Ouvrez votre Genie Agent.
  2. Ouvrez le Sources tab, puis cliquez sur Ajouter .
  3. Sélectionnez un ou plusieurs services MCP.

Pour attacher un connecteur, vous avez besoin de EXECUTE sur le service MCP du connecteur dans Unity Catalog, ainsi que de USE CATALOG et USE SCHEMA sur son catalogue et son schéma parents. Les connecteurs que vous n’avez pas l’autorisation d’exécuter ne sont pas disponibles. Consultez MCP fournis par Databricks.

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 :

  1. Ouvrez un Genie Agent auquel des connecteurs MCP sont rattachés.
  2. Activez le mode agent dans la zone de discussion.
  3. Authentifiez-vous auprès du connecteur depuis le panneau 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.
  4. 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 Rejeter pour le refuser.

Pour confirmer qu'un connecteur fonctionne, posez une question qui le nécessite, par exemple « Search my Google Drive for the Q3 Ventes plan. » L'agent cite la ressource externe qu'il a utilisée dans sa réponse.

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.
  • Via les APIs du mode Agent, seuls les outils de lecture fonctionnent et les utilisateurs ne peuvent pas s’authentifier auprès d’un connecteur. Complétez l’authentification et l’approbation de l’outil d’écriture dans l’interface utilisateur.
  • 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.
remarque

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, Teams, Outlook et le calendrier.
  • 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.
  • Par default, le connecteur MCP Databricks GitHub ne peut accéder qu'aux repository publics. Pour accorder au connecteur un accès en lecture à vos repositories d'entreprise privés, un administrateur d'organisation GitHub doit effectuer une configuration supplémentaire. Consultez la section repository privés GitHub.
  • 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 :

Sur cette page