Aller au contenu principal

Connecter Genie One à des applications externes avec MCP

Connectez Genie One à des applications telles que Gmail et Slack avec des connecteurs MCP. Genie One peut ensuite rechercher des informations en temps réel, comme le statut actuel d’un ticket Jira. Elle peut également agir, par exemple en rédigeant un e-mail, en publiant un message dans un canal de distribution Slack ou en mettant à jour un ticket. Les administrateurs contrôlent l'accès et les politiques de la plupart des connecteurs via Unity Gateway.

Chaque utilisateur s’authentifie individuellement, de sorte que Genie One fonctionne en respectant les autorisations de chaque utilisateur. Les jetons OAuth ne sont pas partagés entre les utilisateurs.

Types de connecteurs MCP​

Vous pouvez connecter Genie One aux types de serveurs MCP suivants :

Les connecteurs fournis par Databricks et les services MCP, y compris les serveurs installés depuis Marketplace, s'exécutent via Unity Gateway. Avant chaque appel d'outil, la passerelle vérifie que l'utilisateur dispose de EXECUTE sur le MCP, et elle enregistre l'utilisation et les journaux d'audit dans les tables système. Les administrateurs peuvent également limiter les outils disponibles et appliquer des politiques de service (bêta), par exemple pour bloquer les données sensibles ou pour exiger une approbation pour un appel d'outil.

Les exceptions sont Glean (Beta) et les connexions MCP héritées, qui sont des connexions Unity Catalog qui ne sont pas enregistrées en tant que services MCP. Elles ne passent pas par la passerelle, donc ces contrôles ne s’appliquent pas à elles. Voir Régir un MCP.

Connecteurs fournis par Databricks​

Les connecteurs pris en charge sont les suivants :

  • Google Drive : recherchez et créez des Google Docs, Sheets et Slides ; modifiez les documents Docs qu’il a créés.
  • Gmail : rechercher, lire et rédiger des e-mails.
  • 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 : recherche et mise à jour de Jira et Confluence.
  • Asana : Rechercher des tâches, projets, portfolios, utilisateurs et équipes, et créer ou mettre à jour des tâches lorsque des actions d’écriture sont autorisées.
  • Glean (Bêta) : effectuez des recherches dans les applications connectées de votre organisation à l'aide de Glean.
  • Slack : recherche de messages et de canal de distribution Slack, et envoi de messages.
  • GitHub : recherchez et mettez à jour des repository, des problèmes et des demandes d’extraction.
remarque

Pour utiliser ces connecteurs dans un agent Genie Agent au lieu de Genie One, voir Connecter un agent Genie Agent aux outils et sources MCP.

Connecter une application externe​

  1. Sur la page d'accueil de Genie One, cliquez sur l'icône plus Icône Plus. en bas à gauche de la barre de recherche.

  2. Cliquez sur Connecteurs , puis sélectionnez une application.

    Pour connecter des applications supplémentaires, cliquez sur Parcourir les connecteurs en bas de la liste. Pour ajouter un service MCP personnalisé, consultez Connecter un service MCP personnalisé.

  3. Cliquez sur Se connecter et suivez les étapes pour vous connecter.

    Si votre organisation bloque la connexion, voir Configuration supplémentaire de l’application tierce.

La connexion est ajoutée à votre conversation. Genie One peut désormais utiliser ses outils pour rechercher des informations et agir. Voir Partager un MCP.

remarque

Les outils de connecteur ne se Trigger peut-être pas toujours automatiquement. Si un outil ne s’exécute pas, essayez d’inviter explicitement le chat à l’utiliser, par exemple « utiliser Google Drive » ou « utiliser SharePoint ».

Connecter un service MCP personnalisé​

Vous pouvez connecter Genie One à n’importe quel serveur MCP enregistré en tant que service MCP dans Unity Catalog :

  • Enregistrer votre propre serveur : enregistrez un serveur MCP externe ou auto-hébergé. Voir Serveurs MCP externes.
  • Installer depuis Marketplace : installez un serveur MCP répertorié sur Databricks Marketplace. L’installation crée un service MCP dans le schéma Unity Catalog de votre choix. Voir Obtenir l'accès aux serveurs MCP externes.

Une fois le service MCP créé et que vous y avez accès, ajoutez-le à une conversation de chat depuis Parcourir les connecteurs . Voir Partager un MCP. Si le service utilise l’OAuth par utilisateur, chaque utilisateur doit se connecter avant de l’utiliser.

Reconnecter une application​

Si un administrateur approuve de nouvelles autorisations pour une application après que vous vous y êtes connecté, révoquez vos informations d’identification et connectez-vous à nouveau afin que votre connexion obtienne les nouvelles autorisations :

  1. Sur la page d'accueil de Genie One, cliquez sur l'icône plus Icône Plus. en bas à gauche de la barre de recherche.
  2. Cliquez sur Connecteurs , puis cliquez sur Parcourir les connecteurs .
  3. Cliquez sur l’application.
  4. Cliquez sur la flèche vers le bas Icône Chevron vers le bas. à côté de Connecté , puis cliquez sur Révoquer les informations d’identification .
  5. Cliquez sur Utiliser le connecteur et suivez les étapes pour vous connecter.

Une fois la connexion terminée, le bouton affiche à nouveau Connecté .

Actions d'écriture​

Certains outils MCP connectés peuvent effectuer des actions d'écriture dans l'application source, et pas seulement rechercher et lire des données. La capacité d'une connexion à écrire, et les actions qu'elle peut effectuer, dépendent de l'outil, des champs d'application OAuth auxquels vous consentez lors de la connexion et de vos propres autorisations dans l'application source.

Champs d'application d'OAuth​

Lorsque vous connectez une application externe, son fournisseur vous invite à donner votre consentement à un ensemble de scopes OAuth. Les scopes définissent l'ensemble maximal d'actions qu'une connexion peut tenter en votre nom. Chaque utilisateur donne son consentement individuellement. Les éléments auxquels une connexion peut accéder dépendent également de vos propres autorisations dans l'application source et des politiques que vos administrateurs Databricks définissent dans Unity Gateway.

Databricks gère les identifiants OAuth pour ces connexions. Pour obtenir la liste complète des périmètres demandés par chaque fournisseur OAuth géré et connaître l'objectif de chacun d'eux, consultez Fournisseurs OAuth gérés. L'ensemble exact des périmètres demandés pour une connexion apparaît sur l'écran de consentement du fournisseur lorsque vous vous connectez.

Pour obtenir des conseils sur la conformité des applications connectées, consultez Exigences relatives aux fournisseurs externes.

Contrôles d’administration​

Pour les connecteurs qui s’exécutent via Unity Gateway, les administrateurs contrôlent qui peut utiliser chaque connecteur et quels outils sont disponibles, et peuvent appliquer des politiques de service (Bêta) aux appels d’outils. Voir Gouverner un MCP.

Obtenir l’approbation de l’administrateur pour les connecteurs​

Vos administrateurs Slack, Google Workspace, Microsoft 365 ou GitHub peuvent avoir besoin d'approuver ou de configurer l'application Databricks avant que les utilisateurs puissent se connecter. Pour les étapes de chaque fournisseur, voir Configuration supplémentaire d'applications tierces.

Limitations​

Les connexions externes sont uniquement disponibles dans les régions où Unity Gateway est pris en charge.

Voir les régions prises en charge.

Tâches planifiées et authentification​

  • Le chat ne vous avertit pas lorsque l’authentification d’une connexion expire. Vous ne vous en apercevrez peut-être que lorsqu’un appel d’outil échouera ou que vous ouvrirez la liste des connexions. Réauthentifiez-vous pour résoudre le problème.
  • La modification des autorisations d’une connexion nécessite une réauthentification de chaque utilisateur. Les tâches planifiées qui utilisent la connexion échouent tant que l’utilisateur ne s’est pas réauthentifié.

Google Drive​

  • Lors de l’autorisation de Google Drive, vous risquez d’afficher un écran Application non vérifiée . Cliquez sur Avancé 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 Docs 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 des données utilisateur brutes ou dérivées reçues des API Google Workspace respecteront la politique relative aux données utilisateur des services 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 les 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, Calendar et les réunions en ligne.
  • Le connecteur peut rédiger un e-mail Outlook mais ne peut pas l’envoyer.
  • Maximum file size is 25 MB for SharePoint files.
  • Les types de fichiers SharePoint pris en charge incluent les documents SharePoint intégrés, les feuilles de calcul et les présentations, ainsi que les formats texte courants tels que .txt, .csv, .json, .md, et d'autres. Les PDF, les images et les autres formats binaires ne sont pas pris en charge.

Glean (bêta)​

  • Glean sert uniquement à la recherche. Il ne peut pas lire un document à partir d’un Link direct.
  • Un administrateur de metastore doit d'abord configurer l'ID du tenant Glean avant que les utilisateurs non administrateurs ne puissent utiliser la connexion. L'administrateur peut saisir l'ID du 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 par default (/mcp/default). Les utilisateurs non administrateurs ne peuvent pas spécifier ou modifier le chemin du serveur MCP Glean.

Slack​

  • Le connecteur ne peut pas modifier ni supprimer un message après l’avoir envoyé.

GitHub​

  • Les écritures se limitent 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 changements comme commit des fichiers ou créer des issues et des 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.