Plug-in Genie per Microsoft Copilot Cowork

Genie plug-in per Microsoft Copilot Cowork consente agli utenti di porre domande in linguaggio naturale sui dati di Azure Databricks direttamente da Copilot Cowork. Il plug-in si connette Copilot Cowork a Genie tramite il server MCP gestito genie fornito da Azure Databricks. Questa pagina è destinata agli amministratori dell'account di Azure Databricks e agli amministratori di Microsoft 365 che configurano l'integrazione. Descrive la configurazione della connessione OAuth, la creazione del pacchetto contenente il manifesto del plug-in e l'attivazione del plug-in in Copilot Cowork.

Prerequisiti

Prima di iniziare, verificare di disporre di quanto segue:

• Area di lavoro Azure Databricks con Genie abilitata.

• Accesso come amministratore dell'account di Azure Databricks.

• Accedere al portale per sviluppatori di Teams.

• Node.js installato, richiesto dall'interfaccia della riga di comando di Microsoft 365 Agents Toolkit (atk).

• Plugin Genie per Copilot: pacchetto di modelli di manifesto Cowork:

  Scarica il pacchetto del modello di manifesto

Passaggio 1: Creare la connessione all'app OAuth Azure Databricks

Nella console dell'account Azure Databricks creare una connessione app OAuth personalizzata. Per informazioni dettagliate, vedere Abilitare applicazioni OAuth personalizzate usando l'interfaccia utente di Azure Databricks. Usare i valori seguenti per Copilot Cowork:

• URL di reindirizzamento: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Ambiti di accesso: selezionare Tutte le API.
• Segreto del client: Genera un segreto del client. Dopo aver creato la connessione, copiare e archiviare in modo sicuro il segreto client e l'ID client. Non è possibile recuperare il segreto client in un secondo momento.

Passaggio 2: Creare la registrazione client OAuth nel portale per sviluppatori di Teams

Registrare un client OAuth nel portale per sviluppatori di Teams usando i dettagli di connessione del passaggio 1, in modo che Copilot Cowork possa eseguire l'autenticazione nell'area di lavoro Azure Databricks. Per altre informazioni, vedere la documentazione di Microsoft.

1. Nel portale per sviluppatori di Teams passare a Strumenti>registrazione client OAuth.
2. Fare clic su Nuova registrazione client OAuth e specificare quanto segue:
   • Nome registrazione: nome descrittivo, Databricks Geniead esempio .
   • URL di base: https://<workspace-hostname>, ad esempio . https://my-workspace.cloud.databricks.com
   • Limitare l'utilizzo in base all'organizzazione: l'organizzazione Microsoft 365.
   • Limitare l'utilizzo in base all'app: lasciare vuoto.
   • ID client: L'ID client della connessione a un'app OAuth di Azure Databricks che hai creato.
   • Segreto client: il segreto generato quando è stata creata una connessione all'app OAuth Azure Databricks.
   • Endpoint di autorizzazione: https://<workspace-hostname>/oidc/v1/authorize
   • Endpoint del token: https://<workspace-hostname>/oidc/v1/token
   • Aggiornare l'endpoint: https://<workspace-hostname>/oidc/v1/token
   • Ambito: genie
3. Fare clic su Salva, quindi copia l'ID di registrazione del client OAuth per riferimento futuro.

Passaggio 3: Configurare il manifesto

Aggiorna il manifest del modello con l'ID dell'app, l'hostname dell'area di lavoro e l'ID di registrazione OAuth.

1. Estrai il pacchetto del modello di manifesto da Prerequisiti, che include manifest.json, color.png e outline.png.
2. Aprire manifest.json e sostituire i segnaposto seguenti:
   • <YOUR_APP_ID>: Genera un nuovo GUID. Ad esempio, eseguire uuidgen nel terminale.
   • <YOUR_WORKSPACE_HOSTNAME>: nome host dell'area di lavoro Azure Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: ID di registrazione copiato dal passaggio 2.

Passaggio 4: Creare un pacchetto e installare

Crea un archivio ZIP con i file manifest e installa l'app con la atk CLI.

1. Comprimere i tre file insieme. Il file ZIP deve contenere tali file nella directory radice, non all'interno di una sottocartella:

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

2. Installare il pacchetto:

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

Passaggio 5: Abilitare il plug-in in Copilot Cowork

Connettersi al plug-in Genie in Copilot Cowork. Per altre informazioni sui plug-in in Copilot Cowork, vedere la documentazione Microsoft.

1. Aprire Microsoft Copilot Cowork.
2. Trova il plugin Databricks Genie nell'elenco dei plugin e attiva l'interruttore.
3. Fare clic su Connetti. Quando viene visualizzata la richiesta di accesso, eseguire l'autenticazione con le credenziali Azure Databricks.

Dopo l'accesso, è possibile porre domande Copilot Cowork sui dati Azure Databricks, ad esempio "Quanti ordini sono arrivati nella scorsa settimana?"