Genie-insticksprogram för Microsoft Copilot Cowork

Med Genie plugin för Microsoft Copilot Cowork kan användarna ställa frågor på naturligt språk om sina Azure Databricks data direkt från Copilot Cowork. Plugin-programmet ansluter Copilot Cowork till Genie via den Genie-hanterade MCP-servern som tillhandahålls av Azure Databricks. Den här sidan är avsedd för Azure Databricks kontoadministratörer och Microsoft 365 administratörer som konfigurerar integreringen. Den omfattar konfiguration av OAuth-anslutningen, paketering av plugin-manifestet och aktivering av plugin-programmet i Copilot Cowork.

Förutsättningar

Kontrollera att du har följande innan du börjar:

• En Azure Databricks arbetsyta med Genie aktiverat.

• Azure Databricks kontoadministratörsåtkomst.

• Åtkomst till Teams utvecklarportal.

• Node.js installerat, vilket Microsoft 365 Agents Toolkit CLI (atk) kräver.

• Genie-plugin för Copilot Coworks mallpaket för manifest:

  Ladda ned manifestmallspaketet

Steg 1: Skapa Azure Databricks OAuth-appanslutning

Skapa en anpassad OAuth-appanslutning i Azure Databricks-kontokonsolen. Mer information finns i Aktivera anpassade OAuth-program med hjälp av användargränssnittet för Azure Databricks. Använd följande värden för Copilot Cowork:

• Omdirigerings-URL:er: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Åtkomstomfattningar: Välj Alla API:er.
• Klienthemlighet: Generera en klienthemlighet. När du har skapat anslutningen kopierar du och lagrar klienthemligheten och klient-ID:t på ett säkert sätt. Du kan inte hämta klienthemligheten senare.

Steg 2: Skapa OAuth-klientregistreringen i Teams utvecklarportal

Registrera en OAuth-klient i Teams utvecklarportal med hjälp av anslutningsinformationen från steg 1, så Copilot Cowork kan autentisera till din Azure Databricks arbetsyta. Mer information finns i Microsoft-dokumentationen.

1. I Teams utvecklarportal går du till Verktyg>OAuth-klientregistrering.
2. Klicka på Ny OAuth-klientregistrering och ange följande:
   • Registreringsnamn: Ett beskrivande namn, till exempel Databricks Genie.
   • Bas-URL: https://<workspace-hostname>, till exempel https://my-workspace.cloud.databricks.com.
   • Begränsa användningen per organisation: Din Microsoft 365 organisation.
   • Begränsa användningen per app: Lämna tomt.
   • Klient-ID: Klient-ID när du skapade en Azure Databricks OAuth-appanslutning.
   • Klienthemlighet: Hemligheten som genererades när du skapade en Azure Databricks OAuth-appanslutning.
   • Auktoriseringsslutpunkt: https://<workspace-hostname>/oidc/v1/authorize
   • Tokenslutpunkt: https://<workspace-hostname>/oidc/v1/token
   • Uppdatera slutpunkt: https://<workspace-hostname>/oidc/v1/token
   • Omfång: genie
3. Klicka på Spara och kopiera sedan OAuth-klientregistrerings-ID:t för att referera till senare.

Steg 3: Konfigurera manifestet

Uppdatera mallmanifestet med ditt app-ID, arbetsytans värdnamn och OAuth-registrerings-ID.

1. Packa upp manifestmallpaketet från Förutsättningar, som innehåller manifest.json, color.png och outline.png.
2. Öppna manifest.json och ersätt följande platshållare:
   • <YOUR_APP_ID>: Generera ett nytt GUID. Kör till exempel uuidgen i terminalen.
   • <YOUR_WORKSPACE_HOSTNAME>: Värdnamnet för din Azure Databricks arbetsyta.
   • <YOUR_OAUTH_REGISTRATION_ID>: Registrerings-ID:t kopierades från steg 2.

Steg 4: Paketera och installera

Paketera manifestfilerna i en zip och installera appen med atk CLI.

1. Zippa ihop de tre filerna. Zip-filen måste innehålla dem i rotkatalogen, inte i en undermapp:

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

2. Installera paketet:

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

Steg 5: Aktivera plugin-programmet i Copilot Cowork

Anslut till Plugin-programmet Genie i Copilot Cowork. Mer information om plugin-program i Copilot Cowork finns i dokumentationen för Microsoft.

1. Öppna Microsoft Copilot Cowork.
2. Hitta plugin-programmet Databricks Genie i plugin-listan och aktivera växlingsknappen.
3. Klicka på Anslut. När inloggningsprompten visas autentiserar du med dina Azure Databricks autentiseringsuppgifter.

När du har loggat in kan du ställa frågor till Copilot Cowork om dina Azure Databricks data, till exempel "Hur många beställningar kom in förra veckan?"