Plugin Genie pour Microsoft Copilot Cowork

Le plug-in Genie pour Microsoft Copilot Cowork permet aux utilisateurs de poser directement depuis Copilot Cowork des questions en langage naturel sur leurs données Azure Databricks. Le plug-in connecte Copilot Collègue à Genie via le serveur MCP géré par Genie fourni par Azure Databricks. Cette page concerne Azure Databricks administrateurs de compte et Microsoft 365 administrateurs 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 Collègue.

Prerequisites

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

• Un espace de travail Azure Databricks avec Genie activé.

• Accès d’administrateur de compte Azure Databricks.

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

• Node.js installé, requis par l’outil en ligne de commande Microsoft 365 Agents Toolkit (atk).

• Le package de modèles de manifeste du plug-in Genie pour Copilot Cowork :

  Télécharger le package de modèle de manifeste

Étape 1 : Créer la connexion d’application OAuth Azure Databricks

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

• URL de redirection : https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Étendues d’accès : sélectionnez toutes les API.
• Clé secrète client : générer une clé secrète client. Après avoir créé la connexion, copiez et stockez en toute sécurité la clé secrète client et l’ID client. Vous ne pouvez pas récupérer le secret client ultérieurement.

Étape 2 : Créer l’inscription du client OAuth dans le portail des développeurs Teams

Inscrivez un client OAuth dans le portail des développeurs Teams à l’aide des détails de connexion de l’étape 1, afin que Copilot Collègue puisse s’authentifier auprès de votre espace de travail Azure Databricks. Pour plus d’informations, consultez la documentation Microsoft.

1. Dans le portail des développeurs Teams, accédez à Outils>d’inscription du client OAuth.
2. Cliquez sur Nouvelle inscription du client OAuth et fournissez les éléments suivants :
   • Nom de l’inscription : 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 : laissez vide.
   • ID client : ID client lorsque vous avez créé une connexion d’application OAuth Azure Databricks.
   • Clé secrète client : secret généré lors de la création d’une connexion d’application OAuth Azure Databricks.
   • Point de terminaison d’autorisation : https://<workspace-hostname>/oidc/v1/authorize
   • Point de terminaison de jeton : https://<workspace-hostname>/oidc/v1/token
   • Actualiser le point de terminaison : https://<workspace-hostname>/oidc/v1/token
   • Étendue : genie
3. Cliquez sur Enregistrer, puis copiezl’ID d’inscription du client OAuth pour référencer ultérieurement.

Étape 3 : Configurer le manifeste

Mettez à jour le manifeste du modèle avec votre ID d’application, le nom d’hôte de l’espace de travail et l’ID d’inscription OAuth.

1. Décompressez le paquet de modèle de manifeste depuis Prérequis, qui comprend manifest.json, color.png et outline.png.
2. Ouvrez manifest.json et remplacez les espaces réservés suivants :
   • <YOUR_APP_ID>: Générer un nouveau GUID. Par exemple, exécutez uuidgen dans votre terminal.
   • <YOUR_WORKSPACE_HOSTNAME>: Nom d’hôte de votre espace de travail Azure Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: L’ID d’inscription copiée de l’étape 2.

Étape 4 : Empaqueter et installer

Empaqueter les fichiers manifestes dans un fichier zip et installer l’application avec l’interface atk CLI.

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

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

2. Installez le package :

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

Étape 5 : Activer le plug-in dans Copilot Collègue

Connectez le plugin Genie dans Copilot Cowork. Pour plus d’informations sur les plug-ins dans Copilot Collègue, consultez la documentation Microsoft.

1. Ouvrez Microsoft Copilot Cowork.
2. Recherchez le plug-in Databricks Genie dans la liste des plug-ins et activez l’interrupteur.
3. Cliquez sur Se connecter. Lorsque l’invite de connexion s’affiche, authentifiez-vous avec vos informations d’identification Azure Databricks.

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