Plug-in Genie pour Microsoft Copilot Cowork

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Le plug-in Genie pour Microsoft Copilot Cowork permet aux utilisateurs de poser des questions en langage naturel sur leurs données Databricks directement depuis Copilot Cowork. Le plug-in connecte Copilot Cowork à Genie via le serveur MCP géré par Genie fourni par Databricks. Cette page est destinée aux administrateurs de compte Databricks et aux administrateurs Microsoft 365 qui configurent l'intégration. Il couvre la configuration de la connexion OAuth, l'empaquetage du manifeste du plug-in et l'activation du plug-in dans Copilot Cowork.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un workspace Databricks avec Genie activé.

• Accès administrateur au compte Databricks.

• Accès au portail des développeurs Teams.

• Node.js installé, ce que l'interface CLI du kit d'outils d'agents Microsoft 365 (atk) requiert.

• Le package de template de manifeste du Plug-in Genie pour Copilot Cowork :

download le package de Template de manifeste.

Étape 1 : Créez la connexion de l'application OAuth Databricks

Dans votre console de compte Databricks, créez une connexion d'application OAuth personnalisée. Pour plus de détails, consultez Activer des applications OAuth personnalisées à l’aide de l’interface utilisateur Databricks. Utilisez les valeurs suivantes pour Copilot Cowork :

• URL de redirection : https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• **Périmètres d'accès** : Sélectionnez **Toutes les API**.
• Secret du client : Générez un secret client. Après avoir créé la connexion, copiez et stockez en toute sécurité le secret client et l' ID client . Vous ne pouvez pas récupérer le secret client ultérieurement.

Étape 2 : créez l'inscription du client OAuth dans le portail des développeurs Teams

Enregistrez un client OAuth dans le portail de développement Teams en utilisant les détails de connexion de l'étape 1, afin que Copilot Cowork puisse s'authentifier auprès de votre workspace Databricks. Pour plus d'informations, consultez la documentation Microsoft.

1. Dans le portail des développeurs Teams, accédez à Outils > Enregistrement du client OAuth .

2. Cliquez sur Nouvel enregistrement de client OAuth et fournissez les éléments suivants :

   • Nom d'enregistrement : un nom descriptif, par exemple, Databricks Genie.
   • URL de base : https://<workspace-hostname>, par exemple, https://my-workspace.cloud.databricks.com.
   • **Restreindre l'utilisation par organisation** : Votre organisation Microsoft 365.
   • Restreindre l'utilisation par application : Laisser ce champ vide.
   • ID client : L'ID client lorsque vous avez créé une connexion d'application OAuth Databricks.
   • Secret client : le secret généré lors de la création d'une connexion d'application OAuth Databricks.
   • Endpoint d'autorisation : https://<workspace-hostname>/oidc/v1/authorize
   • Endpoint de jeton : https://<workspace-hostname>/oidc/v1/token
   • Refresh de l'endpoint : https://<workspace-hostname>/oidc/v1/token
   • Périmètre : genie

3. Cliquez sur Enregistrer , puis copiez l' ID d'enregistrement de client OAuth pour référence ultérieure.

Étape 3 : Configurer le manifeste

Mettez à jour le manifeste du Template avec votre ID d'application, le Hostname du Workspace et l'ID d'enregistrement OAuth.

1. Décompressez le package de Template de manifeste à partir des Prérequis, qui inclut manifest.json, color.png et outline.png.
2. Ouvrez manifest.json et remplacez les espaces réservés suivants :
   • <YOUR_APP_ID>: Générez un nouveau GUID. Par exemple, exécutez uuidgen dans votre terminal.
   • <YOUR_WORKSPACE_HOSTNAME>: Votre Hostname de Workspace Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: L'ID d'enregistrement copié à l'étape 2.

Étape 4 : Package et installation

Packagez les fichiers manifeste dans un zip et installez l'application avec la CLI atk.

1. Compressez les trois fichiers ensemble. Le fichier zip doit les contenir dans le répertoire racine, et non dans un sous-dossier :

   Bash

   cd /path/to/your/package/folder
   zip package.zip manifest.json color.png outline.png

2. Installez le package :

   Bash

   atk install --file-path package.zip --scope Shared

Étape 5 : activer le plugin dans Copilot Cowork

Connectez-vous au plugin Genie dans Copilot Cowork. Pour en savoir plus sur les plugins dans Copilot Cowork, consultez la documentation Microsoft.

1. Ouvrez Microsoft Copilot Cowork.
2. Trouvez le plugin **Databricks Genie** dans la liste des plugins et activez le bouton bascule.
3. Cliquez sur **Connecter**. Lorsque l'invite de connexion apparaît, authentifiez-vous avec vos identifiants Databricks.

Après vous être connecté, vous pouvez poser des questions à Copilot Cowork sur vos données Databricks, par exemple : « Combien de commandes sont arrivées la semaine dernière ? »