Important
この機能は パブリック プレビュー段階です。 アカウント管理者は、アカウント コンソール の [プレビュー ] ページからこの機能へのアクセスを管理できます。 アカウント レベルのプレビューの管理を参照してください。
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 アプリをダウンロード、設定、および使用する方法について説明します。
Important
Azure Databricks エージェントは、不正確な応答を生成する場合があります。 エージェントの出力に対して動作する前に確認します。
前提条件
Microsoft Teamsに Databricks Genie アプリをインストールする前に、次の手順を実行します。
- アカウント管理者は、アカウント コンソールで Databricks Genie Microsoft Teamsプレビューを有効にする必要があります。
- ワークスペースで IP アクセス リストが使用されている場合は、米国東部 2 リージョンの Azure Databricks コントロール プレーンの送信 IP を追加します。 送信 IP については、Azure Databricks のドキュメントを参照してください。
Microsoft Teamsに Databricks Genie アプリをインストールする
Microsoft 365管理者は、Microsoft マーケットプレースから databricks Genie アプリをMicrosoft Teamsにインストールします。
- Microsoft マーケットプレースで、Databricks Genie を検索して見つけます。
- アプリをインストールします。
- インストール中にメッセージが表示されたら、アプリのアクセス許可を承認します。
必要な権限の一覧については、「MicrosoftのRequired app permissions s」をご覧ください。
インストール後、ユーザーはアプリの使用を開始できます。
Microsoft Teamsで Databricks Genie アプリを使用する
Databricks Genie アプリは、Microsoft Teams ワークスペース上の直接メッセージまたはチャネル会話を通じて、またはMicrosoft 365 CopilotからMicrosoft Teamsで使用できます。
ダイレクト メッセージ
Microsoft Teamsで Databricks Genie アプリに直接メッセージを送信するには:
- Microsoft Teamsで、左側のサイドバーにある [アプリ] をクリックし、Microsoft Teamsで Databricks Genie アプリを開きます。
- 質問を入力します。 サインインしていない場合は、Microsoft Teamsの Databricks Genie アプリでサインインするように求められます。
- 質問は最も適切な Genie エージェントにルーティングされ、ソースと推奨されるフォローアップ プロンプトを含む回答が返されます。
すべてのダイレクトメッセージ会話のためにワークスペースとGenieのスコープを設定するには、Microsoft TeamsのホームページでDatabricks Genieアプリを開き、設定を調整してください。
チャネル会話
Microsoft Teams内の Databricks Genie アプリをチャネルに追加できます。
configを使用すると、チャネル所有者はチャネルのすべてのメンバーの設定を構成でき、個々のユーザーは個人用設定を構成できます。 チャネル所有者の構成は、個人の構成をオーバーライドします。
チャネルの Microsoft Teams で Databricks Genie アプリを構成するには:
目的のチャネルに「
@Databricks Genie」と入力します。メッセージが表示されたら、Microsoft Teamsの Databricks Genie アプリをチャネルに追加します。
「
config」と入力します。接続済みのワークスペース、メッセージの表示範囲、Genie の対象（Genie One または特定の Genie Agent）を選択します。
Genie Agent がピン留めされていない場合、チャンネルはデフォルトで Genie One になります。
構成後、チャネル内のすべての
@Databricks Genieメンションが、構成済みのエージェントとワークスペースにルーティングされます。
構成レベルとオーバーライド
チャネルで config を実行して、構成ウィンドウを開きます。 次の設定を構成できます。
- ワークスペースの選択: Microsoft Teamsの Databricks Genie アプリが接続して質問に答えるAzure Databricksワークスペース。
-
メッセージの可視性: チャネル内の
@Databricks Genie応答がすべてのチャネル メンバーに表示されるか、または要求したユーザーにのみ表示されるか。 既定では、応答はパブリックです。 ワークスペース管理者がメッセージの可視性をプライベートに設定した場合、ワークスペースは直接メッセージのみをサポートし、チャネルやグループ チャットはサポートしません。 - ジーニースコープ:ジーニーワンまたは特定のジーニーエージェント。 両者ともGenie One APIを使用しています。特定のジーニーエージェントをピン留めると、Genie Oneはそのエージェントにだけ質問を送信し、一貫したユースケース特有の回答を得るよう指示します。
メッセージの表示設定は、3 つのレベルで設定できます。 レベルが高いほど、下位レベルがオーバーライドされます。
| Level | 設定方法 | 適用対象 | 優先順位 |
|---|---|---|---|
| ワークスペース | Azure Databricksワークスペース管理者は、[コラボレーション プラットフォームへの接続を許可する] フィールドと [コラボレーション プラットフォームでパブリック メッセージを許可する] フィールドを使用して、ワークスペースのセキュリティ設定から構成します。 [コラボレーション プラットフォームでパブリック メッセージを許可する] がオフの場合、チャネル メッセージとグループ メッセージは機能せず、直接メッセージのみがサポートされます。 | Microsoft Teams ワークスペース内のすべてのチャネル | 最高 — チャネル設定と個人設定より優先されます |
| チャネル | チャネル所有者がチャネルにconfigを送信し、[チャネル全体の設定として保存] を選択する |
そのチャネルのすべてのメンバー | 個人用構成をオーバーライドします |
| 個人用 | 個々のユーザーがチャネルで config を送信する |
チャネル内でのそのユーザー本人による @Databricks Genie メンション |
チャネル全体の構成が設定されていない場合に使用されます |
Microsoftで必須のアプリ権限
Microsoft TeamsにDatabricks Genieアプリをインストールすると、以下の権限が求められます。 Entra ID権限は、Microsoft 365管理者が組織に対して同意したテナント全体のMicrosoft Graph権限です。 リソース固有 権限は、アプリがインストールされているチャット、チャンネル、またはチームにのみ適用されるTeamsのリソース固有の同意(RSC)権限です。
これらの権限の詳細については、Microsoftのドキュメントにある「リソース固有の同意およびグラフ権限」をご覧ください。
Note
User.ReadBasic.All許可はもはや使用されていません。 アプリは代わりに委任権限を使用しています。 Azure Databricksが必須権限から削除し終えるまでは、インストール時にリクエストされる可能性があります。 求められたら承認してください。
| 許可 | Description | タイプ |
|---|---|---|
offline_access |
許可したデータへのアクセスを維持してください。 | Entra ID |
User.Read |
サインインしてユーザープロフィールを読みます。 | Entra ID |
User.ReadBasic.All |
すべてのユーザーの基本プロファイルを読み取る。 | Entra ID |
ChatMessage.Read.Chat |
このチャットのメッセージを読んでください。 | リソース固有 |
ChatMessage.Send.Chat |
このチャットにメッセージを送ってください。 | リソース固有 |
TeamsActivity.Send.Chat |
このチャットのユーザーのチームワークアクティビティフィードに新しい通知を作成しましょう。 | リソース固有 |
TeamsActivity.Send.User |
このユーザーにアクティビティフィードの通知を送信してください。 | リソース固有 |
ChannelMember.Read.Group |
チームのチャンネルメンバーを読みましょう。 | リソース固有 |
ChannelMessage.Read.Group |
このチームのチャネル メッセージを読む。 | リソース固有 |
ChannelSettings.Read.Group |
このチームのチャンネル名、説明、設定を読んでください。 | リソース固有 |
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
リンクが失敗した場合、管理者は手動で同意を付与できます。
-
Microsoft Entra 管理センターで、Entra ID>Enterprise apps>All applications に移動し、シングル サインオンに使用するAzure Databricksエンタープライズ アプリケーションを見つけます。 アプリケーションを識別するには、アプリケーション ID
aaec40b0-c0ae-4211-a98b-6fc160abb71bを検索します。 - Azure Databricks エンタープライズ アプリによって要求されたアクセス許可に対して管理者の同意を付与します。
- [ セキュリティ] で、[ アクセス許可] をクリックします。
- [ 管理者の同意を付与する] をクリックします。
詳細な手順については、Microsoftドキュメントを参照してください。
制限事項
- Microsoft Teamsで Databricks Genie アプリが使用するコンピューティング (SQL ウェアハウス) を指定することはできません。 Azure Databricksは、ユーザーがアクセスを許可されている SQL ウェアハウスを自動的に選択します。
- 特定のジーニーエージェントがジーニースコープとしてピン留めされると、Genie Oneはピン留めされたエージェントに届く前に質問を書き換えることがあります。
- フィードバック（高評価または低評価）は、特定のジーニー エージェントがピン留めされている場合でも、常に Genie One に送信されます。
- PrivateLink はサポートされていません。
- 次の機能はサポートされていません。
- グラフの視覚化
- Teams へのAzure Databricks通知の送信
- Teams から Azure Databricks のアクションをトリガーする
その他のリソース
- Genie One を使用する
- Genie One でのチャット
- Genie One を使用する
- サポートについては、 Databricks ヘルプ センターを参照してください。