Connecter Genie One à des outils et sources externes

Connectez des sources de données externes à une conversation par chat dans Genie One pour effectuer des recherches dans les documents et les données de votre entreprise lors de la formulation de vos réponses. Chaque utilisateur s’authentifie individuellement. Les jetons OAuth ne sont pas partagés entre les utilisateurs.

Ces connexions utilisent des connecteurs MCP fournis par Databricks, de sorte qu'il n'y a aucun serveur à héberger ni aucune application OAuth à enregistrer. Databricks gouverne chaque connexion via Unity Catalog et Unity Gateway. La passerelle autorise chaque appel d'outil par rapport à vos autorisations Unity Catalog, applique des politiques intégrées et des exigences d'approbation, et consigne l'utilisation ainsi que les journaux d'audit dans les tables système. Voir Serveurs MCP externes.

Les connexions prises en charge incluent :

• 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.
• 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 Genie Agent au lieu de Genie One, consultez Connecter un agent Genie à des outils et sources externes.

Connectez une source de données externe

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

2. Sélectionnez une source de données.

   Pour connecter des sources de données supplémentaires, cliquez sur More connections au bas de la liste. Vous pouvez créer un service MCP personnalisé dans Unity Catalog. Voir External MCP servers.

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

La connexion a été ajoutée à votre conversation. Le chat peut désormais effectuer des recherches dans vos documents lors de la réponse aux questions. Voir Partager un MCP.

remarque

Les outils de source de données ne se Trigger pas toujours automatiquement. Si la recherche de documents ne start pas, essayez d'inciter explicitement le chat à utiliser l'outil, par exemple « utiliser Google Drive » ou « utiliser SharePoint. »

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 source de données externe, son fournisseur vous invite à consentir à un ensemble de champs d'application OAuth. Les périmètres définissent l'ensemble maximal d'actions qu'une connexion peut tenter d'effectuer en votre nom. Chaque utilisateur donne son consentement individuellement, et le contenu auquel une connexion peut accéder dépend toujours de la manière dont votre organisation configure la connexion et de vos propres autorisations dans l'application source.

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.

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, Teams, Outlook et Calendrier.
• 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.
• Par default, le connecteur Databricks GitHub MCP ne peut accéder qu'aux repositories publics. Pour donner au connecteur un accès en lecture à vos repository d'entreprise privés, un administrateur de l'organisation GitHub doit effectuer une configuration supplémentaire. Consultez repository privés GitHub.
• GitHub Enterprise Server (la version auto-hébergée de GitHub) n'est pas pris en charge.

Service MCP personnalisé

Créez le service MCP avant de l’ajouter à une conversation de chat. Si le service utilise l’OAuth par utilisateur, chaque utilisateur doit se connecter avant de l’utiliser. Voir External MCP servers.