Microsoft Teamsの Databricks Genie アプリ

Microsoft Teamsの Databricks Genie アプリは Genie をMicrosoft Teamsに取り込むため、ユーザーは Microsoft Teams ワークスペースを離れることなく、データに関する質問をしたり、回答を得ることができます。 ユーザーは、直接メッセージでアプリとチャットしたり、Microsoft Teamsチャネルやグループ チャットで@Databricks Genieメンションしたりできます。 質問は、Genie One、または一貫性がありユースケースに特化した回答を提供するためにチャネル オーナーがピン留めした特定の Genie Agent によって回答されます。

Microsoft TeamsのDatabricks Genieアプリは、どちらの場合もGenie One APIに依存しています。Genie Agentがピン留めされると、Genie Oneはそのエージェントにのみ質問を送信します。 このアプリはGenieと同じモデルプロバイダーと信頼・安全保証を使用しています。 パートナーを利用する AI 機能の設定が有効および無効になっている場合に使用されるホスティング プロバイダーと、Databricks AI 支援機能の信頼と安全性に関する説明を参照してください。

このページでは、Microsoft Teamsで Databricks Genie アプリをダウンロード、設定、および使用する方法について説明します。

前提条件

Microsoft Teamsに Databricks Genie アプリをインストールする前に、次の手順を実行します。

• アカウント管理者は、アカウント コンソールで Databricks Genie Microsoft Teamsプレビューを有効にする必要があります。
• ユーザーがダイレクトメッセージでファイルをアップロードできるようにするには、ワークスペース管理者がGenie Oneファイルのアップロードプレビューを有効にし、各ユーザーのMicrosoft TeamsアカウントにOneDrive for Businessが設定されている必要があります。 詳細は、ファイルのアップロードを参照してください。
• ユーザーがダイレクトメッセージでPDFとして文書を保存できるようにするには、各ユーザーはOneDriveおよびMicrosoft TeamsのDatabricks Genieアプリのバージョン1.0.17以上が必要です。 「文書をPDFとして保存」をご覧ください。
• ワークスペースで IP アクセス リストが使用されている場合は、米国東部 2 リージョンの Azure Databricks コントロール プレーンの送信 IP を追加します。 送信 IP については、Azure Databricks のドキュメントを参照してください。

Microsoft Teamsに Databricks Genie アプリをインストールする

Microsoft 365管理者は、Microsoft マーケットプレースから databricks Genie アプリをMicrosoft Teamsにインストールします。

1. Microsoft マーケットプレースで、Databricks Genie を検索して見つけます。
2. アプリをインストールします。
3. インストール中にメッセージが表示されたら、アプリのアクセス許可を承認します。

必要な権限の一覧については、「MicrosoftのRequired app permissions s」をご覧ください。

インストール後、ユーザーはアプリの使用を開始できます。

Microsoft Teamsで Databricks Genie アプリを使用する

Databricks Genie アプリは、Microsoft Teams ワークスペース上の直接メッセージまたはチャネル会話を通じて、またはMicrosoft 365 CopilotからMicrosoft Teamsで使用できます。

ダイレクト メッセージ

Microsoft Teamsで Databricks Genie アプリに直接メッセージを送信するには:

1. Microsoft Teamsで、左側のサイドバーにある [アプリ] をクリックし、Microsoft Teamsで Databricks Genie アプリを開きます。

2. 質問を入力します。

3. サインインしていない場合、Microsoft TeamsのDatabricks Genieアプリがサインインを促します:

   1. [構成]をクリックします。
   2. ワークスペースのURLを指定してください。 ワークスペースのURLを見つけるには、 ワークスペースインスタンス名、URL、IDをご覧ください。
   3. Azure Databricksアカウントにログインするには「続ける」をクリックしてください。

4. 質問は最も適切な Genie エージェントにルーティングされ、ソースと推奨されるフォローアップ プロンプトを含む回答が返されます。

ダイレクトメッセージで新しい会話を始めるには、newchat を送信します。 これにより現在の会話コンテキストがクリアされ、次のメッセージが新しいジーニーの会話を始めることができます。 既存のMicrosoft Teamsメッセージは削除されません。

すべてのダイレクトメッセージ会話のためにワークスペースとGenieのスコープを設定するには、Microsoft TeamsのホームページでDatabricks Genieアプリを開き、設定を調整してください。

ファイルをアップロードする

ダイレクトメッセージでは、20 MiB以下のPDF、Word、またはCSVファイルを最大5つ添付でき、Genieはそれらを回答の際にコンテキストとして使います。 チャンネル、グループチャット、Microsoft 365 Copilotではファイルのアップロードは利用できません。

Microsoft Teamsはチャットで添付したファイルをOneDrive for Businessに保存するため、Microsoft TeamsアカウントでOneDrive for Businessを利用できなければファイルをアップロードできません。

ファイルをアップロードするには:

1. Microsoft TeamsのDatabricks Genieアプリとのダイレクトメッセージでは、メッセージに最大5つのファイルを添付できます。
2. オプションで、ファイルに関する質問を入力してください。
3. メッセージを送信します。

メッセージに質問が含まれている場合、Genieはファイルをアップロードし、それを使って質問に答えます。 何も確認せずにファイルを送信すると、Genie がそれらをアップロードし、準備が整ったことを通知します。 その後、ファイルについて質問することができます。

アップロードされたファイルは、その会話内で追加の質問があった場合に備えて、引き続き利用可能です。 newchat を送信した後、新しい会話で使うには、ファイルを再度添付してください。

5つを超えるファイルを添付すると、Genieは最初の5つをアップロードし、スキップしたファイルを一覧にします。 ファイルがアップロードできない場合、Genie はそのファイルと理由を表示します。 少なくとも1つのファイルがアップロードされていれば、Genieはあなたの質問に答えます。

Genie から「Azure Databricks がアップロードの承認を行えませんでした」という返信があった場合は、ワークスペース管理者に、ご利用のワークスペースで Genie One File Upload のプレビューが有効になっているか確認を以来してください。

PDFとして文書を保存する

Genieがダイレクトメッセージで文書を作成すると、Microsoft TeamsのDatabricks Genieアプリはその文書をファイルカードのPDF形式で提供します。 ジーニーに文書の作成を依頼する方法については、「 Genie Oneの文書」をご覧ください。

PDFをOneDriveに保存するには、ファイルカードのAllowをクリックしてください。 アプリはチャットでカードをPDFで置き換えます。 オファーを却下するには、「拒否」をクリックしてください。

PDFを保存するには、OneDriveと、Microsoft TeamsのDatabricks Genieアプリのバージョン1.0.17以上が必要です。 許可をクリックしても、お使いのアカウントで OneDrive が無効になっているため失敗する場合は、代わりに Genie One でドキュメントを開いてください。

• PDFは文書のタイトルにちなんで名付けられています。
• 回答に複数の文書が含まれている場合、アプリは最初の文書のみを提供します。
• オファーはアプリが投稿してから15分で切れます。 PDF配信がビジー状態であるか開始できない場合、カードでAllowをもう一度クリックするよう求められます。 キャンペーンの期限が切れる前にお手続きください。 オファーが切れた後にPDFを受け取るには、Genieに再度文書を作成してもらうよう依頼してください。
• 20 MiBを超えるPDFは保存できません。 代わりにGenie Oneでドキュメントを開いてください。

チャネル会話

Microsoft Teams内の Databricks Genie アプリをチャネルに追加できます。 configを使用すると、チャネル所有者はチャネルのすべてのメンバーの設定を構成でき、個々のユーザーは個人用設定を構成できます。 チャネル所有者の構成は、個人の構成をオーバーライドします。

チャネルの Microsoft Teams で Databricks Genie アプリを構成するには:

1. 目的のチャネルに「 @Databricks Genie」と入力します。

2. メッセージが表示されたら、Microsoft Teamsの Databricks Genie アプリをチャネルに追加します。

3. 「config」と入力します。

4. 接続済みのワークスペース、メッセージの表示範囲、Genie の対象（Genie One または特定の Genie Agent）を選択します。

   Genie Agent がピン留めされていない場合、チャンネルはデフォルトで Genie One になります。

5. 構成後、チャネル内のすべての @Databricks Genie メンションが、構成済みのエージェントとワークスペースにルーティングされます。

Visualizations

Genieの回答に可視化が含まれている場合、そのチャートは返信中に画像として表示されます。

メッセージの可視化が非公開に設定されている場合、非公開メッセージは請求したユーザーのみに見えるため、可視化は表示されません。

構成レベルとオーバーライド

チャネルで config を実行して、構成ウィンドウを開きます。 次の設定を構成できます。

• ワークスペースの選択: Microsoft Teamsの Databricks Genie アプリが接続して質問に答えるAzure Databricksワークスペース。
• メッセージの可視性: チャネル内の @Databricks Genie 応答がすべてのチャネル メンバーに表示されるか、または要求したユーザーにのみ表示されるか。 既定では、応答はパブリックです。
• ジーニースコープ:ジーニーワンまたは特定のジーニーエージェント。 両者ともGenie One APIを使用しています。特定のジーニーエージェントをピン留めると、Genie Oneはそのエージェントにだけ質問を送信し、一貫したユースケース特有の回答を得るよう指示します。

メッセージの表示設定は、3 つのレベルで設定できます。 レベルが高いほど、下位レベルがオーバーライドされます。

データ ルーティング

Genieはあなたの質問を処理し、ワークスペースの地域内の会話履歴を保存します。 Microsoft Teamsとワークスペース間のリクエストは、Azure Databricksコントロールプレーン内の中央のAzure Databricksサービスを通過します。 中央サービスは、ワークスペースの地域に関係なく、East US 2地域で動作します。 中央サービスはリクエストや応答の内容を永続化したりログに記録したりしません。 それはMicrosoft TeamsテナントとAzure Databricksワークスペース間のマッピングのみを保存します。

Microsoft Teamsはリクエストを受け取るために固定エンドポイントが必要なため、アプリは中央サービスを利用しています。

Microsoft Teamsで質問をすると:

1. Microsoft Teamsは質問を中央サービスに送信します。
2. 中央サービスはリクエストをAzure Databricksワークスペースに転送します。
3. Genieはリクエストを処理し、ワークスペース上で回答を生成します。
4. その答えは中央サービスを通じてMicrosoft Teamsに戻ってきます。

PDFとして文書を保存すると、アプリはワークスペースからPDFをダウンロードし、East US 2経由でOneDriveにアップロードします。 アプリはPDFを保存しません。

監査ログで使用状況を監視

アカウントやワークスペースの管理者は、監査ログシステムテーブル(system.access.audit)を使って、Microsoft TeamsからのGenieの使用を監視できます。 ユーザーがMicrosoft Teams Databricks Genieアプリを通じてメッセージを送信すると、Genie OneはgenieChatサービスの下でcreateGenieChatResponseイベントをログし、request_params.sourceフィールドはteamsを発信者として記録します。 これにより、Microsoft TeamsリクエストをAzure DatabricksウェブUI(webapp)やSlack(slack)などの他の連携からのリクエストと区別できます。

以下のサンプルクエリは、過去5日間のMicrosoft Teams発信Genieリクエストを返します。質問したユーザーと会話IDも含まれます。

SELECT
  event_time,
  user_identity.email AS user_email,
  request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
  AND action_name = 'createGenieChatResponse'
  AND request_params.source = 'teams'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

監査ログテーブルのスキーマやさらなるサンプルクエリについては、 監査ログシステムテーブル参照を参照してください。 Genie Oneチャットイベントの全リストについては、 Genie Oneのチャットイベントをご覧ください。

Microsoftで必須のアプリ権限

Microsoft TeamsにDatabricks Genieアプリをインストールすると、以下の権限が求められます。 Entra ID権限は、Microsoft 365管理者が組織に対して同意したテナント全体のMicrosoft Graph権限です。 リソース固有 権限は、アプリがインストールされているチャット、チャンネル、またはチームにのみ適用されるTeamsのリソース固有の同意(RSC)権限です。

これらの権限の詳細については、Microsoftのドキュメントにある「リソース固有の同意およびグラフ権限」をご覧ください。

Troubleshooting

ログイン時の "管理者の承認が必要" というメッセージ

Microsoft Entra テナントがAzure Databricks アプリケーションのユーザーの同意をブロックしているため、Azure Databricks ワークスペースにログインすると、次の "管理者の承認が必要です" というメッセージが表示されます。 管理者の同意が付与されていない場合、Microsoft Entra IDは、ワークスペースに直接アクセスできる場合でも、ログイン フローをブロックし続けます。

これを解決するには、適切な管理者ロールを持つMicrosoft Entra ユーザーが、Azure Databricksエンタープライズ アプリケーションにテナント全体の管理者の同意を付与する必要があります。

Microsoft Entra管理者に、次のリンクを参照するよう依頼します。 {TENANT_ID}をMicrosoft Entraテナント ID に置き換えます。

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

リンクが失敗した場合、管理者は手動で同意を付与できます。

1. Microsoft Entra 管理センターで、Entra ID>Enterprise apps>All applications に移動し、シングル サインオンに使用するAzure Databricksエンタープライズ アプリケーションを見つけます。 アプリケーションを識別するには、アプリケーション ID aaec40b0-c0ae-4211-a98b-6fc160abb71bを検索します。
2. Azure Databricks エンタープライズ アプリによって要求されたアクセス許可に対して管理者の同意を付与します。
   1. [ セキュリティ] で、[ アクセス許可] をクリックします。
   2. [ 管理者の同意を付与する] をクリックします。

詳細な手順については、Microsoftドキュメントを参照してください。

制限事項

• Microsoft Teamsで Databricks Genie アプリが使用するコンピューティング (SQL ウェアハウス) を指定することはできません。 Azure Databricksは、ユーザーがアクセスを許可されている SQL ウェアハウスを自動的に選択します。
• 特定のジーニーエージェントがジーニースコープとしてピン留めされると、Genie Oneはピン留めされたエージェントに届く前に質問を書き換えることがあります。
• フィードバック（高評価または低評価）は、特定のジーニー エージェントがピン留めされている場合でも、常に Genie One に送信されます。
• PrivateLink はサポートされていません。
• ファイルのアップロードはダイレクトメッセージでのみサポートされています。 チャンネル、グループチャット、Microsoft 365 Copilotでは、添付ファイルを含むメッセージにはGenieが応答しません。 代わりに、アップロードはダイレクトメッセージでのみ動作すると返答します。
• ファイルのアップロードでは、PDF、Word (.docx)、および 20 MiB 以下の CSV ファイルのみがサポートされており、1 つのメッセージにつき最大 5 ファイルまでアップロードできます。
• PDFとして文書を保存することはダイレクトメッセージでのみ可能です。 Genieはチャンネルやグループチャット、Microsoft 365 CopilotでPDFを提供していません。 Microsoft TeamsのOneDriveおよびDatabricks Genieアプリのバージョン1.0.17以上が必要です。 20 MiBを超えるPDFは保存できません。
• TeamsからAzure Databricksでアクションをトリガーすることはサポートされていません。

その他のリソース

• Genie One を使用する
• Genie One でのチャット
• SlackおよびMicrosoft Teams Genieアプリの送信先
• サポートについては、 Databricks ヘルプ センターを参照してください。