Microsoft Copilot Cowork 用の Genie プラグイン

重要

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

Genie Microsoft Copilot 用プラグイン Cowork を使用すると、ユーザーは、Copilot Cowork から直接、Azure Databricks データに関する自然言語の質問を行うことができます。 プラグインは、Azure Databricksによって提供される Genie マネージド MCP サーバーを介して、Cowork Copilot Genie に接続します。 このページは、Azure Databricks アカウント管理者とMicrosoft 365管理者が統合を設定するためのページです。 OAuth 接続の構成、プラグイン マニフェストのパッケージ化、Copilot Cowork でのプラグインの有効化について説明します。

前提条件

作業を開始する前に、次の準備ができていることを確認します。

手順 1: Azure Databricks OAuth アプリ接続を作成する

Azure Databricks アカウント コンソールで、カスタム OAuth アプリ接続を作成します。 詳細については、「Azure Databricks UI を使用してカスタム OAuth アプリケーションを有効にする」を参照してください。 Copilot Cowork には次の値を使用します。

  • リダイレクト URL: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  • アクセス スコープ: すべての API を選択します。
  • クライアント シークレット: クライアント シークレットを生成します。 接続を作成したら、クライアント シークレットとクライアント ID をコピーして安全に格納 します。 後でクライアント シークレットを取得することはできません。

手順 2: Teams 開発者ポータルで OAuth クライアント登録を作成する

手順 1 の接続情報を使用して Teams 開発者ポータルで OAuth クライアントを登録し、Copilot Cowork が Azure Databricks ワークスペースで認証を行えるようにします。 詳細については、 Microsoft のドキュメントを参照してください。

  1. Teams 開発者ポータルで、[ ツール>OAuth クライアントの登録] に移動します。
  2. [ 新しい OAuth クライアントの登録 ] をクリックし、次の情報を入力します。
    • 登録名: わかりやすい名前 (例: Databricks Genie)。
    • ベース URL: https://<workspace-hostname> (たとえば、 https://my-workspace.cloud.databricks.com)。
    • 組織による使用制限: お客様の Microsoft 365 組織。
    • アプリ別の使用を制限する: 空白のままにします。
    • クライアント ID: Azure Databricks OAuth アプリ接続を作成したときのクライアント ID。
    • クライアント シークレット: Azure Databricks OAuth アプリ接続を作成したときに生成されるシークレット。
    • 承認エンドポイント: https://<workspace-hostname>/oidc/v1/authorize
    • トークン エンドポイント: https://<workspace-hostname>/oidc/v1/token
    • エンドポイントを更新します。 https://<workspace-hostname>/oidc/v1/token
    • スコープ: genie
  3. [保存] をクリックし、後で参照する OAuth クライアント登録 ID をコピーします。

手順 3: マニフェストを構成する

テンプレート マニフェストを、アプリ ID、ワークスペースのホスト名、OAuth 登録 ID で更新します。

  1. Prerequisites から、manifest.json、color.png、outline.png を含むマニフェスト テンプレート パッケージを解凍します。
  2. manifest.jsonを開き、次のプレースホルダーを置き換えます。
    • <YOUR_APP_ID>: 新しい GUID を生成します。 たとえば、ターミナルで uuidgen を実行します。
    • <YOUR_WORKSPACE_HOSTNAME>: Azure Databricks ワークスペースのホスト名。
    • <YOUR_OAUTH_REGISTRATION_ID>: 手順 2. からコピーした登録 ID。

手順 4: パッケージ化してインストールする

マニフェスト ファイルを zip にパッケージ化し、 atk CLI を使用してアプリをインストールします。

  1. 3 つのファイルをまとめて圧縮します。 zip は、サブフォルダー内ではなくルート ディレクトリに含まれている必要があります。

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

  2. パッケージをインストールしてください。

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

手順 5: Copilot Cowork でプラグインを有効にする

Copilot Cowork の Genie プラグインに接続します。 Copilot Cowork のプラグインの詳細については、Microsoftドキュメントを参照してください。

  1. Microsoft Copilot Cowork を開きます。
  2. プラグインの一覧で Databricks Genie プラグインを見つけて、トグルをオンにします。
  3. [接続] をクリックします。 サインイン プロンプトが表示されたら、Azure Databricks資格情報で認証します。

サインインした後、Azure Databricks データに関する Copilot Cowork の質問を行うことができます 。たとえば、"先週の注文数" などです。

  • Last updated on