Genie-plug-in voor Microsoft Copilot Cowork

Met de Genie invoegtoepassing voor Microsoft Copilot Cowork kunnen gebruikers vragen in natuurlijke taal stellen over hun Azure Databricks gegevens rechtstreeks vanuit Copilot Cowork. De invoegtoepassing verbindt Copilot Cowork met Genie via de door Azure Databricks beheerde MCP-server. Deze pagina is bedoeld voor Azure Databricks accountbeheerders en Microsoft 365 beheerders die de integratie instellen. Het omvat het configureren van de OAuth-verbinding, het verpakken van het manifest van de invoegtoepassing en het inschakelen van de invoegtoepassing in Copilot Cowork.

Prerequisites

Voordat u begint, controleert u of u het volgende hebt:

• Een Azure Databricks werkruimte waarvoor Genie is ingeschakeld.

• Azure Databricks-accountbeheerdersrechten.

• Toegang tot de Ontwikkelaarsportal van Teams.

• Node.js geïnstalleerd, waarvoor de Microsoft 365 Agents Toolkit CLI (atk) is vereist.

• De Genie-invoegtoepassing voor het manifestsjabloonpakket van Copilot Cowork:

  Het manifestsjabloonpakket downloaden

Stap 1: de verbinding met de Azure Databricks OAuth-app maken

Maak in uw Azure Databricks-accountconsole een aangepaste OAuth-app-verbinding. Zie Aangepaste OAuth-toepassingen inschakelen met behulp van de Azure Databricks-gebruikersinterface voor meer informatie. Gebruik de volgende waarden voor Copilot Cowork:

• Omleidings-URL's: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Toegangsbereiken: Alle API's selecteren.
• Clientgeheim: genereer een clientgeheim. Nadat u de verbinding hebt gemaakt, kopieert en slaat u het clientgeheim en de client-id veilig op. U kunt het clientgeheim later niet ophalen.

Stap 2: De OAuth-clientregistratie maken in de Teams Developer-portal

Registreer een OAuth-client in de Ontwikkelaarsportal van Teams met behulp van de verbindingsgegevens uit stap 1, zodat Copilot Cowork kan worden geverifieerd bij uw Azure Databricks werkruimte. Zie de Microsoft-documentatie voor meer informatie.

1. Ga in de Ontwikkelaarsportal van Teams naar Tools>OAuth-clientregistratie.
2. Klik op Nieuwe OAuth-clientregistratie en geef het volgende op:
   • Registratienaam: een beschrijvende naam, bijvoorbeeld Databricks Genie.
   • Basis-URL: https://<workspace-hostname>bijvoorbeeld https://my-workspace.cloud.databricks.com.
   • Gebruik beperken per organisatie: uw Microsoft 365 organisatie.
   • Gebruik beperken per app: Laat leeg.
   • Client-id: de client-id bij het maken van een Azure Databricks OAuth-app-verbinding.
   • Clientgeheim: het geheim dat is gegenereerd toen u een Azure Databricks OAuth-app-verbinding hebt gemaakt.
   • Autorisatie-eindpunt: https://<workspace-hostname>/oidc/v1/authorize
   • Tokeneindpunt: https://<workspace-hostname>/oidc/v1/token
   • Eindpunt vernieuwen: https://<workspace-hostname>/oidc/v1/token
   • Bereik: genie
3. Klik op Opslaan en kopieer de registratie-id van de OAuth-client om later te verwijzen.

Stap 3: Het manifest configureren

Werk het sjabloonmanifest bij met uw app-id, hostnaam van werkruimte en OAuth-registratie-id.

1. Pak het pakket met manifestsjablonen uit Vereisten uit, dat manifest.json, color.png en outline.png bevat.
2. Open manifest.json en vervang de volgende tijdelijke aanduidingen:
   • <YOUR_APP_ID>: Genereer een nieuwe GUID. Voer bijvoorbeeld uit uuidgen in uw terminal.
   • <YOUR_WORKSPACE_HOSTNAME>: de hostnaam van uw Azure Databricks werkruimte.
   • <YOUR_OAUTH_REGISTRATION_ID>: de registratie-id die is gekopieerd uit stap 2.

Stap 4: Verpakken en installeren

Pak de manifestbestanden in een zip-bestand en installeer de app met de atk CLI.

1. Zip de drie bestanden samen. De zip moet deze in de hoofdmap bevatten, niet in een submap:

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

2. Installeer het pakket:

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

Stap 5: De invoegtoepassing inschakelen in Copilot Cowork

Maak verbinding met de Genie-invoegtoepassing in Copilot Cowork. Zie de Microsoft-documentatie voor meer informatie over invoegtoepassingen in Copilot Cowork.

1. Open Microsoft Copilot Cowork.
2. Zoek de Databricks Genie-invoegtoepassing in de lijst met invoegtoepassingen en schakel de wisselknop in.
3. Klik op Verbinding maken. Wanneer de aanmeldingsprompt wordt weergegeven, moet u zich verifiëren met uw Azure Databricks referenties.

Nadat u zich hebt aangemeld, kunt u Copilot Cowork vragen stellen over uw Azure Databricks-gegevens, bijvoorbeeld: 'Hoeveel bestellingen zijn er vorige week binnengekomen?'