Genieエージェントを外部のツールやソースに接続する

GenieエージェントはDatabricks提供のMCP（Model Context Protocol）コネクタを使用して、エージェントモードの会話中に外部ツールやソースからコンテキストを取得し、外部ツールやソースでアクションを実行できます。 エージェント作成者がコネクタを接続し、各ユーザーがそれらに対して個別に認証を行います。 すべてのツール呼び出しは、質問をしたユーザーの権限で実行されます。

Important

この機能は ベータ版です。 これを使うには、ワークスペース管理者がGenie AgentsのMCPツールをPreviewsページから有効にする必要があります。 Manage Azure Databricks プレビューを参照してください。

Note

Genie Agents は、以前は Genie Spaces として知られていました。

GenieエージェントにおけるMCPコネクタの仕組み

MCPコネクターにより、GenieエージェントのSQLおよびファイル分析機能を、組織が既に使用している外部アプリケーションと連携させることができます。 例えば、1回の会話で販売表を分析し、Googleドライブから関連するコンテキストを取得し、要約メールを作成できます。 Azure DatabricksはUnity CatalogとUnity Gatewayを通じてすべてのツール呼び出しを管理しています。 MCP を管理するを参照してください。

MCPツールは以下の2つのカテゴリーに分けられます。

  • 読み取り専用ツール (検索、フェッチ、リスト)は自動的に動作します。
  • 書き込みツール (例えば、メッセージ送信やメール作成)は、実行前にユーザーに承認を求めます。

Genieエージェントは、Databricksが提供する以下のMCPコネクタをサポートしています:

  • Googleドライブ:Googleドキュメント、スプレッド、スライドを検索して作成します。作成したドキュメントを編集します。
  • Gmail:メールを検索し、読んで、下書きします。
  • Googleカレンダー:カレンダーイベントを検索して作成できます。
  • Microsoft 365:SharePoint、Teams、Outlook、カレンダーを検索;Outlookメールを作成してください。
  • Atlassian:JiraとConfluenceを検索して更新してください。
  • Glean (ベータ):Gleanを使って組織内の接続アプリ全体を検索しましょう。
  • Slack:Slackのメッセージやチャンネルを検索し、メッセージを送信します。
  • GitHub:リポジトリ、イシュー、プルリクエストの検索と更新が可能です。

Requirements

エージェントとそのユーザーには、次の要件が適用されます。

  • エージェントのすべてのユーザーの ワークスペース アクセス 権と Databricks SQL アクセス 権の両方。 コンシューマー専用、Databricks SQL専用、およびアカウント専用のユーザーはMCPツールを使えません。 「アクセス権」を参照してください。
  • エージェントのユーザーごとに、接続された各外部システムに 1 つのアカウントを作成します。

Genieエージェントにコネクタを追加する

Genieエージェントにコネクタを接続するには:

  1. ジーニーエージェントを開いてください。
  2. [ ソース ] タブを開き、[ 追加] をクリックします。
  3. 1つ以上のMCPサービスを選択してください。

コネクタを接続するには、Unity Catalog 内のそのコネクタの MCP サービスに EXECUTE が必要であり、さらにその親カタログおよびスキーマに USE CATALOG と USE SCHEMA が必要です。 実行する権限がないコネクタは利用できません。 Databricksが提供するMCPを参照してください。

ツールの構成

コネクタを取り付けた後は、エージェントがそれをどのように使うかを設定します:

  • エージェントがコネクターのツールをどのように、いつ使うべきかを明確に説明した明確 な説明 を追加してください。 例えば、エージェントに必要なチケットタイトル形式を指示したり、会話の冒頭でユーザーのプロフィールを調べるよう指示したりできます。
  • コネクタ内の個別ツールを有効または無効にして、エージェントが取れるアクションを限定できます。

会話でMCPツールを使いましょう

GenieエージェントでMCPツールを使用するには:

  1. MCPコネクタが接続されたGenieエージェントを開いてください。
  2. チャット ボックスでエージェント モードを有効にします。
  3. 構成パネルから、コネクタへの認証を行ってください。 エージェントがあなたが承認していないコネクタを必要としている場合や、認証が期限切れの場合、エージェントはサインインを促します。
  4. コネクターを使うプロンプトを送信してください。 エージェントが書き込みツールを呼び出したら、単一のアクションを承認するには 一度だけ許可、そのツールを会話の残りの間承認するには このチャットでは常に許可、拒否するには 拒否 を選択してください。

コネクターが機能するかを確認するには、「Google Driveで第3四半期の販売プランを検索してください」といった質問をしてください。担当者は回答で使用した外部リソースを挙げます。

制限

次の制限事項が適用されます。

  • MCPツールはエージェントモードでのみ動作します。 チャットモードでは動作しません。
  • エージェント モードの API では、読み取り専用のツールのみが動作し、ユーザーはコネクタへの認証を行うことができません。 UI 上で認証と書き込みツールの承認を完了してください。
  • 接続アプリケーションに関するコンプライアンスガイダンスについては、 外部プロバイダー要件をご覧ください。

以下のセクションでは、特定のコネクタの制限について説明します。

Google ドライブ

  • Googleドライブを認証すると、 未確認のアプリ 画面が表示されることがあります。 [ 詳細設定 ] をクリックし、承認プロセスを続行します。
  • 最大ファイル サイズは 25 MB です。
  • ネイティブの Google Workspace ファイル (Docs、スプレッドシート、スライド) のみがサポートされています。 PDF、画像、およびその他のバイナリ形式はサポートされていません。
  • このコネクターはGoogleドキュメント、スプレッドシート、スライドを作成でき、作成したGoogleドキュメントの編集も可能です。 コネクター外で作成されたドキュメントや、既存のスシートやスライドの編集はできません。
  • 非常に大きな文書を読むのは遅くなることがあります。

Note

Google Workspace API から受信した生または派生ユーザー データの使用と転送は、制限付き使用要件を含む Google API サービスのユーザー データ ポリシーに準拠します。

Gmail

  • コネクターはメールの検索、閲覧、下書きはできますが、メール送信や既存メッセージの編集はできません。
  • コネクターはDriveファイルをネイティブのGmail添付ファイルとして追加できません。 回避策として、メール本文にファイルへのリンクを記載してください。

Microsoft 365

  • SharePoint、Teams、Outlook、予定表が含まれます。
  • コネクターはOutlookメールのドラフトはできますが、送信はできません。
  • SharePointファイルの最大ファイルサイズは25MBです。
  • サポートされているSharePointファイルの種類には、組み込みのSharePointドキュメント、スプレッドシート、プレゼンテーションのほか、.txt、.csv、.json、.mdなどの一般的なテキスト ベースの形式が含まれます。 PDF、画像、およびその他のバイナリ形式はサポートされていません。

Glean（ベータ）

  • Gleanは検索専用です。 直接リンクから文書を読み取ることができません。
  • メタストア管理者は、非管理者が接続を利用する前にまずGleanテナントIDを設定しなければなりません。 管理者は、最初に Glean に接続するときにテナント ID を入力できます。
  • 特定の Glean MCPサーバーに接続するには、メタストア管理者が接続設定時にMCPサーバーパス(例: /mcp/eng)を設定できます。 このフィールドは空欄のままにしてデフォルトのパス(/mcp/default)を使います。 管理者でないユーザーはGleanのMCPサーバーパスを指定または変更できません。

Slack

  • コネクタは送信後にメッセージを編集したり削除したりすることはできません。

GitHub

  • 書き込みはファイルの内容、イシュー、プルリクエストに限定されます。
  • 既定では、Databricks GitHub MCP コネクタはパブリック リポジトリにのみアクセスできます。 コネクタにプライベート エンタープライズ リポジトリへの読み取りアクセス権を付与するには、GitHub組織の管理者が追加のセットアップを完了する必要があります。 GitHubのプライベートリポジトリを参照してください。
  • GitHub Enterprise Server (GitHub のセルフホステッド バージョン) はサポートされていません。

その他のリソース

関連情報については、次のリソースを参照してください。

  • 最終更新: