メインコンテンツまでスキップ
に最終更新

Microsoft Copilot Cowork 向け Genie プラグイン

備考

ベータ版

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

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

前提条件​

始める前に、次の項目が揃っていることを確認します。

ステップ1: Databricks OAuthアプリ接続を作成する​

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

  • リダイレクトURL ： https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  • Access スコープ: すべてのAPIs を選択してください。
  • クライアントのシークレット ：クライアントシークレットを生成します。接続を作成したら、クライアントシークレットと**クライアントID**をコピーして安全に保存します。クライアントのシークレットは後で取得できません。

ステップ 2: Teams Developer Portal で OAuth クライアント登録を作成する​

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

  1. Teams 開発者ポータルで、**「ツール」**> **「OAuth クライアント登録」** に移動します。

  2. 「 新しいOAuthクライアントの登録 」をクリックして、以下を入力してください。

    • 登録名 ：わかりやすい名前（例：Databricks Genie）。
    • **ベースURL**:https://<workspace-hostname> https://my-workspace.cloud.databricks.com(例:)。
    • 組織別に使用を制限 ：お客様のMicrosoft 365組織。
    • [アプリによる使用制限] は空白のままにします。
    • クライアントID ：Databricks OAuthアプリ接続の作成時に使用したクライアントIDです。
    • **クライアントシークレット**は、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: manifestを構成する​

アプリID、ワークスペースホスト名、およびOAuth登録IDを使用して、テンプレートマニフェストを更新してください。

  1. 前提条件からマニフェストテンプレートパッケージを解凍します。これにはmanifest.json、color.png、およびoutline.pngが含まれています。
  2. manifest.json を開き、次のプレースホルダーを置き換えます。
    • <YOUR_APP_ID>新しいGUIDを生成するたとえば、ターミナルでuuidgenを実行します。
    • <YOUR_WORKSPACE_HOSTNAME>：お使いのDatabricksワークスペースのホスト名。
    • <YOUR_OAUTH_REGISTRATION_ID>：ステップ2でコピーした登録IDです。

ステップ4：パッケージ化してインストールする​

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

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

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

  2. パッケージをインストールします：

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

ステップ 5: Copilot Cowork でプラグインを有効にする​

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

  1. Microsoft Copilot コーワークを開く。
  2. プラグインリストから Databricks Genie プラグインを見つけ、トグルをオンにします。
  3. 「 接続 」をクリックします。サインインプロンプトが表示されたら、Databricks の資格情報で認証してください。

サインイン後、Copilot CoworkにDatabricksデータについて質問できます。例えば、「先週、注文はいくつありましたか？」

このページの見出し