Genie-Plugin für Microsoft Copilot Cowork

Mit dem Genie-Plug-In für Microsoft Copilot Cowork können Benutzer direkt in Copilot Cowork Fragen in natürlicher Sprache zu ihren Azure-Databricks-Daten stellen. Das Plug-In verbindet Copilot Cowork mit Genie über den von Azure Databricks bereitgestellten Genie Managed MCP-Server. Diese Seite richtet sich an Azure Databricks Kontoadministratoren und Microsoft 365 Administratoren, die die Integration einrichten. Es umfasst die Konfiguration der OAuth-Verbindung, das Verpacken des Plug-In-Manifests und das Aktivieren des Plug-Ins in Copilot Cowork.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Folgendes vorhanden ist:

• Ein Azure Databricks-Arbeitsbereich mit aktiviertem Genie.

• Azure Databricks Kontoadministratorzugriff.

• Zugriff auf das Teams-Entwicklerportal.

• Node.js installiert, die die Microsoft 365 Agents Toolkit CLI (atk) erfordert.

• Das Genie Plugin für Copilot Cowork-Manifestvorlagenpaket:

  Herunterladen des Manifestvorlagenpakets

Schritt 1: Erstellen der Azure Databricks OAuth-App-Verbindung

Erstellen Sie in Ihrer Azure Databricks Kontokonsole eine benutzerdefinierte OAuth-App-Verbindung. Weitere Informationen finden Sie unter Aktivieren von benutzerdefinierten OAuth-Anwendungen mithilfe der Azure Databricks-Benutzeroberfläche. Verwenden Sie die folgenden Werte für Copilot Cowork:

• Umleitungs-URLs: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Zugriffsbereiche: Wählen Sie alle APIs aus.
• Geheimer Clientschlüssel: Generieren eines geheimen Clientschlüssels. Nachdem Sie die Verbindung erstellt haben, kopieren Und speichern Sie den geheimen Clientschlüssel und die Client-ID sicher. Sie können den geheimen Clientschlüssel nicht später abrufen.

Schritt 2: Erstellen der OAuth-Clientregistrierung im Teams-Entwicklerportal

Registrieren Sie einen OAuth-Client im Teams-Entwicklerportal mithilfe der Verbindungsdetails aus Schritt 1, damit Copilot Cowork sich bei Ihrem Azure Databricks Arbeitsbereich authentifizieren kann. Weitere Informationen finden Sie in der Microsoft-Dokumentation.

1. Navigieren Sie im Teams-Entwicklerportal zu Tools>OAuth-Clientregistrierung.
2. Klicken Sie auf "Neue OAuth-Clientregistrierung" , und geben Sie Folgendes an:
   • Registrierungsname: Ein beschreibender Name, Databricks Geniez. B. .
   • Basis-URL: https://<workspace-hostname>, z. B. https://my-workspace.cloud.databricks.com.
   • Einschränken der Nutzung nach Organisation: Ihre Microsoft 365 Organisation.
   • Verwendung nach App einschränken: Leer lassen.
   • Client-ID: Die Client-ID, wenn Sie eine Azure Databricks OAuth-App-Verbindung erstellt haben.
   • Geheimer Clientschlüssel: Der geheime Schlüssel, der beim Erstellen einer Azure Databricks OAuth-App-Verbindung generiert wurde.
   • Autorisierungsendpunkt: https://<workspace-hostname>/oidc/v1/authorize
   • Tokenendpunkt: https://<workspace-hostname>/oidc/v1/token
   • Endpunkt aktualisieren: https://<workspace-hostname>/oidc/v1/token
   • Bereich: genie
3. Klicken Sie auf "Speichern", und kopieren Sie dann die OAuth-Clientregistrierungs-ID , um später darauf zu verweisen.

Schritt 3: Konfigurieren des Manifests

Aktualisieren Sie das Vorlagenmanifest mit Ihrer App-ID, dem Arbeitsbereichs-Hostnamen und der OAuth-Registrierungs-ID.

1. Entpacken Sie das Manifestvorlagenpaket aus Prerequisites, das manifest.json, color.png und outline.png enthält.
2. Öffnen Sie manifest.json und ersetzen Sie die folgenden Platzhalter:
   • <YOUR_APP_ID>: Generieren Sie eine neue GUID. Führen Sie z. B. in Ihrem Terminal aus uuidgen .
   • <YOUR_WORKSPACE_HOSTNAME>: Der Hostname Ihres Azure Databricks-Arbeitsbereichs.
   • <YOUR_OAUTH_REGISTRATION_ID>: Die Registrierungs-ID, die aus Schritt 2 kopiert wurde.

Schritt 4: Packen und Installieren

Packen Sie die Manifestdateien in eine ZIP-Datei, und installieren Sie die App mit der atk CLI.

1. Komprimieren Sie die drei Dateien zu einer ZIP-Datei. Die ZIP-Datei muss sie im Stammverzeichnis enthalten, nicht innerhalb eines Unterordners:

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

2. Installiere das Paket:

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

Schritt 5: Aktivieren des Plug-Ins in Copilot Cowork

Verbinden Sie sich mit dem Genie-Plug-In in Copilot Cowork. Weitere Informationen zu Plug-Ins in Copilot Cowork finden Sie in der Microsoft Dokumentation.

1. Öffnen Sie Microsoft Copilot Cowork.
2. Suchen Sie das Databricks Genie Plug-In in der Plug-In-Liste, und aktivieren Sie den Umschalter.
3. Klicken Sie auf Verbinden. Wenn die Anmeldeaufforderung angezeigt wird, authentifizieren Sie sich mit Ihren Azure Databricks Anmeldeinformationen.

Nachdem Sie sich angemeldet haben, können Sie Copilot Cowork Fragen zu Ihren Azure-Databricks-Daten stellen, z. B. „Wie viele Bestellungen sind letzte Woche eingegangen?“