Microsoft TeamsのDatabricks Genieアプリ
プレビュー
この機能は パブリック プレビュー段階です。アカウント管理者は、アカウント コンソールの [プレビュー] ページからこの機能へのアクセスを管理できます。アカウントレベルのプレビューを管理するを参照してください。
Microsoft TeamsのDatabricks Genieアプリは、GenieをMicrosoft Teamsに導入することで、ユーザーがMicrosoft Teamsのワークスペースを離れることなくデータの質問をして回答を得られるようにします。ユーザーは、ダイレクトメッセージでアプリとチャットしたり、Microsoft Teamsのチャンネルまたはグループチャットで@Databricks Genieにメンションしたりできます。チャンネルオーナーは、一貫性のある、ユースケース固有の回答のために、特定のGenieエージェントをチャンネルにピン留めできます。それ以外の場合、質問はGenieを介してルーティングされます。
Microsoft TeamsのDatabricks Genieアプリは、Genie One APIに依存し、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 アプリでサインインを求められます。
- 質問は最も適切なGenieエージェントにルーティングされ、ソースと推奨される追加プロンプトを含む回答が返されます。
以降のすべてのダイレクトメッセージ会話のワークスペースとGenieエージェントスコープを設定するには、Microsoft TeamsのホームページでDatabricks Genieアプリを開いて設定を調整してください。
チャンネルでの会話
Microsoft TeamsでDatabricks Genieアプリをチャンネルに追加できます。config を使用すると、チャンネル所有者はチャンネルのすべてのメンバーに対する設定を構成でき、個々のユーザーは個人設定を構成できます。チャンネル所有者の設定は個人の設定を上書きします。
Microsoft Teamsのチャンネルで Databricks Genie アプリを設定するには:
-
目的のチャンネルに
@Databricks Genieと入力します。 -
プロンプトが表示された場合は、Databricks GenieアプリをMicrosoft Teamsのチャンネルに追加してください。
-
型
config。 -
接続されたワークスペース、メッセージの公開範囲、およびGenieエージェントのスコープ（Genie内の特定のスペースまたはチャット）を選択します。
Genie エージェントが構成されていない場合、チャネルはデフォルトで Genie のチャットになります。
-
構成後、チャンネル内のすべての
@Databricks Genieメンションは、構成されたエージェントとワークスペースにルーティングされます。
設定レベルとオーバーライド
チャンネル内で実行configを実行して、設定ウィンドウを開きます。 以下の設定項目は変更可能です。
- ワークスペース選択 ：Microsoft Teams 内の Databricks Genie アプリが、質問に回答するために接続する Databricks ワークスペース。
- メッセージの表示設定 ：
@Databricks Genieのチャンネルでの応答がすべてのチャンネルメンバーに表示されるか、または質問したユーザーのみに表示されるか。デフォルトで、応答は公開されています。ワークスペース管理者がメッセージの可視性をプライベートに設定した場合、そのワークスペースはダイレクトメッセージのみをサポートし、チャンネルやグループチャットはサポートされません。 - Genieエージェントスコープ ：特定のGenieエージェント、またはすべてのGenieエージェント。一貫性のある、ユースケース固有の回答のために、単一のスペースをピン留めします。
メッセージの公開設定は3段階で設定できます。上位レベルは下位レベルよりも優先されます。
レベル | 設定方法 | 適用対象 | 優先順位 |
|---|---|---|---|
ワークスペース | Databricks ワークスペース管理者は、ワークスペースのセキュリティ設定から、 コラボレーションプラットフォームへの接続を許可 および コラボレーションプラットフォームでの公開メッセージを許可 フィールドを使用して構成します。『コラボレーションプラットフォームでの公開メッセージを許可する』がオフの場合、チャンネルとグループのメッセージは機能せず、ダイレクトメッセージのみがサポートされます。 | Microsoft Teams ワークスペースのすべてのチャンネル | 最高設定 — チャンネルと個人設定を上書きします |
チャンネル | チャンネル所有者がチャンネルで | そのチャンネルのすべてのメンバー | 個人設定を上書きします |
個人的 | 個々のユーザーがチャンネルで | そのユーザー自身のチャンネルでの | チャンネル全体の設定が設定されていない場合に使用されます |
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ウェアハウスを自動的に選択します。
- PrivateLinkはサポートされていません。
- 以下の機能はサポートされていません。
- グラフの視覚化
- Databricksの通知をTeamsに送信する
- TeamsからDatabricksでアクションをトリガーする
その他のリソース
- Genie Oneを使用する
- Genie Oneでチャットする
- Genie Oneを使用する
- サポートについては、Databricks ヘルプセンターを参照してください。