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 アプリをダウンロード、設定、および使用する方法について説明します。
Databricks エージェントは、不正確な応答を生成する可能性があります。エージェントの出力に基づいて行動する前に、確認してください。
前提条件
Microsoft Teams で Databricks Genie アプリをインストールする前に:
- アカウント管理者は、アカウント コンソールで Databricks Genie for Microsoft Teams プレビューを有効にする必要があります。
- ワークスペースでIPアクセスリストを使用している場合は、米国東部2リージョンのDatabricksコントロールプレーンの送信IPアドレスを追加してください。Azure Databricks ドキュメントのアウトバウンド IP を参照してください。
Microsoft Teams に Databricks Genie アプリをインストールしてください
Microsoft 365 管理者は、Microsoft Marketplace から Microsoft Teams に Databricks Genie アプリをインストールします。
- Microsoft Marketplace で、**Databricks Genie** を検索して見つけてください。
- アプリをインストールしてください。
- インストール時に求められた場合は、アプリの権限を承認してください。
必要な権限の一覧については、Microsoftでの必要なアプリ権限を参照してください。
インストール後、ユーザーはアプリの使用を開始できます。
Microsoft TeamsでDatabricks Genieアプリを使用する
Microsoft Teams のダイレクトメッセージやチャンネル会話、または Microsoft Teams ワークスペースで、あるいは Microsoft 365 Copilot から Databricks Genie アプリをご利用いただけます。
ダイレクトメッセージ
Microsoft TeamsでDatabricks Genieアプリに直接メッセージを送るには：
-
MicrosoftTeamsで、左側のサイドバーにある**Apps**をクリックし、Databricks Genie アプリを開きます。
-
質問を入力してください。
-
サインインしていない場合、Microsoft Teams の Databricks Genie アプリでサインインを求められます：
- [構成] をクリックします。
- ワークスペースURL を指定します。ワークスペースURLを確認するには、「ワークスペースインスタンス名、URL、およびID」を参照してください。
- [続行] をクリックして、Databricksアカウントにログインします。
-
質問は最も適切なGenieエージェントにルーティングされ、ソースと推奨される追加プロンプトを含む回答が返されます。
以降のすべてのダイレクトメッセージ会話のワークスペースとGenieのスコープを設定するには、Microsoft TeamsのホームページでDatabricks Genieアプリを開き、設定を調整してください。
チャンネルでの会話
Microsoft TeamsでDatabricks Genieアプリをチャンネルに追加できます。config を使用すると、チャンネル所有者はチャンネルのすべてのメンバーに対する設定を構成でき、個々のユーザーは個人設定を構成できます。チャンネル所有者の設定は個人の設定を上書きします。
Microsoft Teamsのチャンネルで Databricks Genie アプリを設定するには:
-
目的のチャンネルに
@Databricks Genieと入力します。 -
プロンプトが表示された場合は、Databricks GenieアプリをMicrosoft Teamsのチャンネルに追加してください。
-
型
config。 -
接続されたワークスペース、メッセージの可視性、およびGenieスコープ（Genie Oneまたは特定のGenie Agent）を選択します。
ピン留めされた Genie Agent がない場合、チャンネルはデフォルトで Genie One になります。
-
構成後、チャンネル内のすべての
@Databricks Genieメンションは、構成されたエージェントとワークスペースにルーティングされます。
設定レベルとオーバーライド
チャンネル内で実行configを実行して、設定ウィンドウを開きます。 以下の設定項目は変更可能です。
- ワークスペース選択 ：Microsoft Teams 内の Databricks Genie アプリが、質問に回答するために接続する Databricks ワークスペース。
- メッセージの表示設定 ：
@Databricks Genieのチャンネルでの応答がすべてのチャンネルメンバーに表示されるか、または質問したユーザーのみに表示されるか。デフォルトで、応答は公開されています。ワークスペース管理者がメッセージの可視性をプライベートに設定した場合、そのワークスペースはダイレクトメッセージのみをサポートし、チャンネルやグループチャットはサポートされません。 - Genie スコープ : Genie One または特定の Genie Agent。どちらも Genie One API を使用します。特定の Genie Agent をピン留めすると、Genie One はそのエージェントのみに質問を送信するようになり、一貫性のあるユースケース固有の回答が得られます。
メッセージの公開設定は3段階で設定できます。上位レベルは下位レベルよりも優先されます。
レベル | 設定方法 | 適用対象 | 優先順位 |
|---|---|---|---|
ワークスペース | Databricks ワークスペース管理者は、ワークスペースのセキュリティ設定から、 Allow connection to collaboration platforms （コラボレーションプラットフォームへの接続を許可）および Allow public messages in collaboration platforms （コラボレーションプラットフォームでの公開メッセージを許可）フィールドを使用して構成を行います。 Allow public messages in collaboration platforms がオフの場合、チャンネルおよびグループメッセージは機能せず、ダイレクトメッセージのみがサポートされます。 | Microsoft Teams ワークスペースのすべてのチャンネル | 最高値。チャンネルおよび個人の構成を上書きします |
チャンネル | チャンネル所有者がチャンネルで | そのチャンネルのすべてのメンバー | 個人設定を上書きします |
個人的 | 個々のユーザーがチャンネルで | そのユーザー自身のチャンネルでの | チャンネル全体の設定が設定されていない場合に使用されます |
監査Logsを使用した使用状況の監視
アカウント管理者およびワークスペース管理者は、監査ログシステムテーブル (system.access.audit) を使用して、Microsoft TeamsからのGenieの使用状況を監視できます。ユーザーがMicrosoft TeamsのDatabricks Genieアプリを通じてメッセージを送信すると、Genie Oneは genieChat サービスの下で createGenieChatResponse イベントを記録し、request_params.source フィールドに発生元として teams が記録されます。これにより、Microsoft Teamsからのリクエストを、Databricks Web 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 ドキュメントの「リソース固有の同意」および「Graph のアクセス許可」を参照してください。
User.ReadBasic.All 権限は使用されなくなりました。アプリは代わりに委任された権限を使用するようになりました。Databricksが必須権限としての削除を完了するまで、インストール中にその権限が要求される場合があります。プロンプトが表示されたら、リクエストを承認してください。
権限 | 説明 | Type |
|---|---|---|
| アクセス権を付与したデータへのアクセスを維持します。 | Entra ID |
| サインインして、ユーザープロフィールを読み取ります。 | Entra ID |
| すべてのユーザーの基本プロファイルを読み取ります。 | Entra ID |
| このチャット内のメッセージを読み取ります。 | リソース固有 |
| このチャットにメッセージを送信します。 | リソース固有 |
| このチャットのユーザーのチームワークアクティビティフィードに新しい通知を作成します。 | リソース固有 |
| このユーザーにアクティビティフィードの通知を送信します。 | リソース固有 |
| チームのチャンネルのメンバーを読み取ります。 | リソース固有 |
| このチームのチャンネルメッセージを読み取ります。 | リソース固有 |
| このチームのチャンネル名、説明、および設定を読み取ります。 | リソース固有 |
トラブルシューティング
ログイン時の「管理者の承認が必要です」というメッセージ
Databricks ワークスペースにLog inすると、Microsoft Entra テナントが Databricks アプリケーションに対するユーザーの同意をブロックしているため、次の「管理者の承認が必要です」というメッセージが表示されます。管理者の同意が付与されていない場合、直接ワークスペースにアクセスできる場合でも、Microsoft Entra ID は引き続きログインフローをブロックします。
これを解決するには、適切な管理者ロールを持つMicrosoft Entraユーザーが、Databricksエンタープライズアプリケーションにテナント全体の管理者同意を付与する必要があります。
Microsoft Entra管理者に、以下のLinkにアクセスするよう依頼してください。{TENANT_ID}をMicrosoft EntraテナントIDに置き換えてください。
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b
リンクが機能しない場合、管理者は手動で同意を与えることができます。
- Microsoft Entra 管理センター で、[**Entra ID**] > [**Enterprise apps**] > [**All applications**] に移動し、Single Sign Onに使用されるDatabricks エンタープライズ アプリケーションを見つけます。アプリケーションを識別するには、アプリケーション ID
aaec40b0-c0ae-4211-a98b-6fc160abb71bを検索します。 - Databricks エンタープライズ アプリケーションによって要求された権限に管理者の同意を付与します：
- 「**セキュリティ**」で、[**アクセス許可**]をクリックします。
- 管理者権限の付与 をクリックしてください。
詳細な手順については、Microsoftドキュメントを参照してください。
制限事項
- Microsoft TeamsのDatabricks Genieアプリが使用するコンピュート（SQLウェアハウス）を指定できません。Databricks は、ユーザーがアクセスを許可されている SQLウェアハウスを自動的に選択します。
- 特定のGenie AgentがGenieスコープとしてピン留めされている場合、Genie Oneは質問がピン留めされたエージェントに到達する前に、その質問を書き換えることがあります。
- フィードバック（「役に立つ」または「役に立たない」）は、特定の Genie Agent がピン留めされている場合でも、常に Genie One に送信されます。
- PrivateLinkはサポートされていません。
- 以下の機能はサポートされていません。
- グラフの視覚化
- Databricksの通知をTeamsに送信する
- TeamsからDatabricksでアクションをトリガーする
その他のリソース
- Genie Oneを使用する
- Genie Oneでチャットする
- Genie Oneを使用する
- サポートについては、Databricks ヘルプセンターを参照してください。