Microsoft TeamsのDatabricks Genieアプリ
Microsoft Teams の Databricks Genie アプリは、Microsoft Teams に Genie を導入します。これにより、ユーザーは Microsoft Teams ワークスペースを離れることなく、データに関する質問をして回答を得ることができます。ユーザーはダイレクトメッセージでアプリとチャットしたり、Microsoft Teamsのチャンネルやグループチャットで@Databricks Genieにメンションしたりできます。質問はGenie One、またはダイレクトメッセージやチャンネルでピン留めされた特定のGenie Agentによって回答されます。これにより、一貫したユースケース固有の回答が得られます。
Genie Agentをピン留めすると、新しい会話は Agent モード に直接進み、 Agent モード API を介してそのエージェントに渡されます。それ以外の場合、Microsoft Teams の Databricks Genie アプリは Genie One API を使用します。このアプリは、Genie と同じモデル プロバイダーと信頼および安全の保証を使用します。「パートナー提供の AI 機能」設定が有効および無効な場合に使用されるホスティング プロバイダーについては「Hosting provider used when partner-powered AI features setting is enabled and disabled」および「Databricks AI assistive features trust and safety」をご覧ください。
このページでは、Microsoft Teams で Databricks Genie アプリをダウンロード、設定、および使用する方法について説明します。
Databricks エージェントは、不正確な応答を生成する可能性があります。エージェントの出力に基づいて行動する前に、確認してください。
前提条件
Microsoft Teams で Databricks Genie アプリをインストールする前に:
- ダイレクトメッセージでファイルをuploadするには、各ユーザーのMicrosoft TeamsアカウントにOneDrive for Businessが必要です。「ファイルのupload」を参照してください。
- ユーザーがダイレクトメッセージでドキュメントをPDFとして保存できるようにするには、各ユーザーはMicrosoft TeamsでOneDriveとDatabricks Genieアプリのバージョン1.0.17以降を必要とします。ドキュメントをPDFとして保存するを参照してください。
- ワークスペースでIPアクセスリストを使用している場合は、米国東部2リージョンのDatabricksコントロールプレーンの送信IPアドレスを追加してください。Azure Databricks ドキュメントのアウトバウンド IP を参照してください。
- ワークスペースでPrivate Linkを使用している場合は、アカウント管理者がアプリを許可するコンテキストベースのIngressルールを追加する必要があります。Private Linkワークスペースでの使用を参照してください。
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エージェントにルーティングされ、ソースと推奨される追加プロンプトを含む回答が返されます。
ダイレクトメッセージで新しい会話を開始するには、newchatを送信します。これにより、現在の会話コンテキストがクリアされ、次のメッセージで新しいGenieとの会話が開始されます。既存のMicrosoft Teamsのメッセージは削除されません。
以降のすべてのダイレクトメッセージ会話のワークスペースとGenieのスコープを設定するには、Microsoft TeamsのホームページでDatabricks Genieアプリを開き、設定を調整してください。
ダイレクトメッセージからタスクをスケジュールする
Microsoft TeamsのDatabricks Genieアプリとのダイレクトメッセージからスケジュールタスクを作成できます。以下のいずれかの方法を使用してください:
- Genieにスケジューリングを依頼してください。会話中いつでも、自然言語でリクエストを入力します。例: "Create a daily schedule that pulls the latest customer spend." (最新の顧客支出を取得するスケジュールを毎日作成してください)Genieは、時間やタイムゾーンなど、明確にするための質問をしてからタスクを作成することがあります。
- スケジューリングの提案をクリックします。Genie がスケジュールに基づいて回答をランすることを提案すると、Genie は この分析をスケジュールどおりに実行しますか? 回答の下にあるボタン。ボタンをクリックします。Genieはタスクに何をすべきか、いつ実行すべきかを尋ね、タスクを作成します。
タスクを実行すると、 Microsoft Teams の Databricks Genie アプリがダイレクトメッセージで結果を送信します。結果について会話を続けるには、 [フォローアップの質問] をクリックします。
ファイルをupload
ダイレクトメッセージでは、20 MiB以下のPDF、Word、またはCSVファイルを最大5つメッセージに添付でき、Genieは回答する際にこれらをコンテキストとして使用します。ファイルuploadは、チャンネル、グループチャット、Microsoft 365 Copilot、またはピン留めされたGenie Agentとの会話では利用できません。
Microsoft Teams でチャットに添付したファイルは OneDrive for Business に保存されるため、ファイルを upload するには Microsoft Teams アカウントに OneDrive for Business が必要です。
ファイルをuploadするには:
- Microsoft TeamsでDatabricks Genieアプリとダイレクトメッセージをやり取りする際、メッセージに最大5個のファイルを添付できます。
- オプションで、ファイルについて質問を入力します。
- メッセージを送信してください。
メッセージに質問が含まれている場合、Genieはファイルをuploadしてから、それらを使用して質問に回答します。質問を含めずにファイルを送信すると、Genieはファイルをuploadし、準備が完了したことを確認します。その後、ファイルについて質問できます。
uploadされたファイルは、現在の会話でフォローアップの質問に引き続き利用できます。newchat を送信した後、新しい会話で使用するためにファイルをもう一度添付してください。
5個を超えるファイルを添付すると、Genieは最初の5個をuploadし、スキップしたファイルを一覧表示します。ファイルをuploadできない場合、Genieはそのファイルを理由とともに一覧表示します。少なくとも1つのファイルがuploadされれば、Genieは質問に回答します。
GenieがDatabricksがuploadを許可できないと返信した場合は、Databricksを再接続して再試行してください。それでも失敗する場合は、ワークスペース管理者にファイル upload 権限を確認してもらってください。
ドキュメントをPDFとして保存する
Genieがダイレクトメッセージでドキュメントの下書きを作成すると、Microsoft TeamsのDatabricks Genieアプリは、ファイルカード上のPDFとしてドキュメントを提供します。Genieにドキュメントの下書き作成を依頼する方法については、「 Genie Oneのドキュメント」を参照してください。
PDFをOneDriveに保存するには、ファイルカードの 許可 をクリックしてください。アプリはチャット内のカードをPDFに置き換えます。オファーを辞退するには、 辞退 をクリックしてください。
PDFを保存するには、OneDriveとMicrosoft TeamsのDatabricks Genieアプリのバージョン1.0.17以降が必要です。 [許可] をクリックしてもOneDriveがお使いのアカウントで無効になっているために失敗した場合は、代わりにGenie Oneでドキュメントを開いてください。
- PDFにはドキュメントのタイトルが付けられます。
- 応答に複数のドキュメントが含まれている場合、アプリは最初のドキュメントのみを提供します。
- オファーは、アプリが投稿してから15分後に期限切れになります。PDFの配信が混雑しているか、起動できない場合、カードは 許可 をもう一度クリックするように要求します。オファーの期限が切れる前にそれを行ってください。オファーの有効期限が切れた後にPDFを取得するには、Genieにドキュメントを再度生成するよう依頼してください。
- 20 MiB を超える PDF は保存できません。代わりにGenie Oneでドキュメントを開いてください。
チャンネルでの会話
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メンションは、構成されたエージェントとワークスペースにルーティングされます。
可視化
Genie の応答にビジュアライゼーションが含まれている場合、チャートは返信内で画像として表示されます。
ツールのアクションを承認
Genieは、接続された外部ツールを使用して質問に回答したり、アクションを実行したりできます。ツール呼び出しに承認が必要な場合、Genieは返信に承認カードを表示します。「 許可 」をクリックしてGenieにツールをランさせるか、「 拒否 」をクリックしてツールを停止します。カードにスコープセレクターが含まれている場合は、承認を「 1回のみ 」、「 このチャットでは常に 」、または「 常に 」のいずれにするかを選択します。質問したユーザーのみが、リクエストの承認または拒否を行うことができます。
設定レベルとオーバーライド
チャンネル内で実行configを実行して、設定ウィンドウを開きます。 以下の設定項目は変更可能です。
- ワークスペース選択 :Microsoft Teams 内の Databricks Genie アプリが、質問に回答するために接続する Databricks ワークスペース。
- メッセージの可視性 : チャンネル内の
@Databricks Genie応答がすべてのチャンネル メンバーに表示されるか、質問したユーザーのみに表示されるか。 デフォルトでは、応答は公開されます。 - Genie スコープ : Genie One または特定の Genie Agent。新しいチャットは、エージェントモードのピン留めされたエージェントに直接送信され、その回答に対するフィードバックはそのエージェントに送信されます。ダイレクトメッセージでのピン留めは、Microsoft 365 Copilot にも適用されます。チャンネルまたはグループチャットでは、チャンネル全体のピン留め( チャンネル全体の設定として保存 )のみがチャットをエージェントにルーティングします。チャンネルでの個人設定は Genie One を使用します。
メッセージの公開設定は3段階で設定できます。上位レベルは下位レベルよりも優先されます。
レベル | 設定方法 | 適用対象 | 優先順位 |
|---|---|---|---|
ワークスペース | Databricksワークスペース管理者は、 許可されたコラボレーションプラットフォーム および コラボレーションプラットフォームでのパブリックメッセージを許可する 設定を使用して、ワークスペースセキュリティ設定から設定します。 コラボレーションプラットフォームでの公開メッセージを許可する がオフの場合、すべての応答は質問したユーザーのみに対してプライベートになります。 | Microsoft Teams ワークスペースのすべてのチャンネル | 最高値。チャンネルおよび個人の構成を上書きします |
チャンネル | チャンネル所有者がチャンネルで | そのチャンネルのすべてのメンバー | 個人設定を上書きします |
個人的 | 個々のユーザーがチャンネルで | そのユーザー自身のチャンネルでの | チャンネル全体の設定が設定されていない場合に使用されます |
ワークスペース管理設定
「設定」 > 「セキュリティ」 >「外部アクセス」で、ワークスペース管理者は、Microsoft TeamsのDatabricks Genieアプリがワークスペースに接続できるかどうか、およびその応答を公開できるかどうかを制御します:
- 許可されているコラボレーションプラットフォーム : どのコラボレーションプラットフォームがワークスペースに接続できるか。 すべて許可 (default)、 Slack のみ許可 、 Teams のみ許可 、または すべて拒否 を選択します。Microsoft Teams が許可されていない場合、ユーザーはそのアプリをワークスペースに接続できません。既に接続されているユーザーは、ワークスペースへの接続が許可されていないという非公開メッセージを受け取り、ワークスペースを変更するか、ワークスペース管理者に連絡するように求められます。
- コラボレーションプラットフォームでの公開メッセージを許可する : オンにすると、ユーザーとチャンネル所有者は、返信を公開にするか非公開にするかを選択できます。オフにすると、質問したユーザーのみが返信を表示できます。
これらの設定への変更が有効になるまで最大1時間かかる場合があります。
データルーティング
Genieはワークスペース内で質問を処理し、会話履歴をワークスペースのリージョンに保存します。Microsoft Teamsとワークスペース間のリクエストは、Databricksコントロールプレーン内の中央Databricksサービスを経由します。中央サービスは、ワークスペースのリージョンにかかわらず、East US 2リージョンで実行されます。中央サービスは、リクエストや回答の内容を永続化したり、ログに記録したりすることはありません。Microsoft TeamsテナントとDatabricksワークスペース間のマッピングのみを保存します。
Microsoft Teamsはリクエストを受信するために固定のEndpointを必要とするため、アプリは中央サービスを使用します。
Microsoft Teamsで質問する場合:
- Microsoft Teamsは、あなたの質問を中央サービスに送信します。
- 中央サービスは要求をDatabricksワークスペースに転送します。
- Genieはリクエストを処理し、ワークスペースで回答を生成します。
- 答えは中央サービスを通じてMicrosoft Teamsに返されます。
ドキュメントをPDFとして保存すると、アプリはワークスペースからPDFをdownloadし、米東部2地域を通じてOneDriveにuploadします。アプリはPDFを保存しません。
LLM 処理の場所
中央サービスは、Microsoft Teamsとワークスペース間のメッセージをルーティングします。ワークスペース内のGenieは大規模言語モデル(LLM)を呼び出すため、ワークスペースのGeoとクロスGeo処理の設定によって、LLMがコンテンツを処理する場所が決まります。たとえば、ワークスペースがEurope Geoにあり、クロスGeo処理が有効になっていない場合、LLMはヨーロッパでコンテンツを処理します。詳細については、Databricks指定サービスを参照してください。
Private Linkワークスペースでの使用
Microsoft TeamsのDatabricks Genieアプリは、フロントエンドPrivate Linkを使用するワークスペースで動作します。Microsoft Teamsは外部Private Link接続をサポートしていないため、アプリはPrivate Link経由で接続しません。その代わりに、アプリだけがワークスペースのGenie APIにアクセスできるようにするコンテキストベースのIngressルールを追加します。ルールはポリシーが他のトラフィックをどのように処理するかを変更するものではなく、各リクエストはリクエストしたユーザーの権限で実行されます。
これらのステップを完了するには、アカウント管理者である必要があります。公開アクセスを有効にする前にイングレスポリシーを作成して、ワークスペースが制限のないパブリックトラフィックを一切受け入れないようにしてください。
ステップ 1: アプリのイングレスポリシーを作成する
コンテキストベースのイングレスポリシーは、各リクエストのアイデンティティ、リクエストタイプ、ネットワークソースに基づいて、ワークスペースに到達可能なリクエストを制御します。コンテキストベースのイングレス制御を参照してください。
-
アカウントコンソールで、ワークスペースのワークスペースネットワークポリシーを開くか、作成します。「ネットワークポリシーへのアクセス」を参照してください。
-
Ingress tabの Public network access で、 Allow access from all public IPs がオフになっていることを確認します。パブリックリクエストは、許可ルールに一致しない限り拒否されます。
-
以下の設定で Allow ルールを追加します。
- アクセスタイプ : API ( Genie APIスコープ付き)。
- ID : すべてのユーザーとService Principal 、またはアプリを使用できるユーザーを制限する場合は 選択したID 。
- ソース : パートナープラットフォーム > Databricks チームアプリ 。コンテキストベースのIngressポリシーでパートナープラットフォームを許可するを参照してください。
-
ポリシーを保存して、ワークスペースにアタッチします。ワークスペースへのポリシーのアタッチを参照してください。変更が反映されるまで最大30分かかる場合があります。
ステップ2: ワークスペースでパブリックアクセスを有効にする
パブリックアクセスが無効になっている場合、アプリからのリクエストを含むすべてのパブリックリクエストは、イングレスポリシーが評価される前にブロックされます。パブリックアクセスを有効にしても、ワークスペースがすべてのパブリックトラフィックに公開されるわけではありません。ステップ1のイングレスポリシーは、引き続き各パブリックリクエストを評価し、許可ルールに一致するリクエストのみを許可します。既存のプライベートEndpointは変更されません。
ワークスペースのプライベートアクセス設定オブジェクトで、「 パブリックアクセス 」を「 Databricksのイングレスポリシーによって管理 」に設定します。設定を確認するには、アカウントコンソールで「 セキュリティ 」>「 プライベートアクセス設定 」をクリックします。「 パブリックアクセス 」列には、パブリックアクセスがオンの場合、「 Databricksのイングレスポリシーによって管理 」が表示されます。設定を変更するには、プライベートアクセス設定オブジェクトを更新するを参照してください。
この設定は、プライベートアクセス設定オブジェクトを使用するすべてのワークスペースに適用されます。これらの各ワークスペースに、パブリックアクセスを制限するイングレスポリシーがあることを確認してください。
セットアップの確認
ポリシーが有効になった後、ワークスペースが他のパブリックトラフィックをブロックし、アプリがワークスペースにアクセスできることを確認します。
- プライベートEndpointにルーティングするVPNまたは他のネットワークから切断して、ブラウザがパブリックインターネット経由で接続されるようにします。
- ワークスペースのURLを開きます。ポリシーの他の許可ルールでネットワークがカバーされていない限り、アクセスは拒否されます。
- Microsoft Teamsで
@Databricks Genieにメンションを付けて質問します。アプリは回答を返します。
拒否された要求を確認するには、system.access.inbound_network システムテーブルをクエリーします。ここには、Ingress ポリシーによって拒否されたインバウンド要求が記録されます。ステップ2からの拒否されたブラウザの要求がそこに表示されます。アプリがワークスペースにアクセスできない場合、どのルールがその要求を拒否したかを示すテーブルが表示されます。レコードは通常、1時間以内に利用可能になります。インバウンドネットワークアクセスイベントシステムテーブルのスキーマを参照してください。
監査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 のアクセス許可」を参照してください。
権限 | 説明 | Type |
|---|---|---|
| アクセス権を付与したデータへのアクセスを維持します。 | 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 Oneで開始された会話はGenie Oneのままです。新しい会話のみがピン留めされたエージェントに移動します。
- ファイルのuploadは、ピン留めされたGenie Agentがないダイレクトメッセージでのみサポートされます。チャンネル、グループチャット、Microsoft 365 Copilotでは、Genieは添付ファイルが含まれるメッセージには回答しません。代わりに、uploadはダイレクトメッセージでのみ機能すると返信します。ピン留めされたGenie Agentとの会話では、Genie Agentとの会話ではファイルのuploadはサポートされていないと返信します。
- ファイルのuploadでは、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は保存できません。
その他のリソース
- Genie One
- Genie Oneでチャットする
- SlackおよびMicrosoft TeamsのGenieアプリの宛先
- サポートについては、Databricks ヘルプセンターを参照してください。