メインコンテンツまでスキップ

Genie Agentを外部ツールおよびソースに接続する

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

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者が [プレビュー] ページから Genie Agentへの外部ツールの接続 を有効にする必要があります。Databricksのプレビューの管理を参照してください。

注記

Genieエージェントは、以前はGenie Spaceと呼ばれていました。

Genie AgentにおけるMCPコネクターの仕組み​

MCPコネクタを使用すると、Genie AgentはそのSQLおよびファイル分析を、組織がすでに使用している外部アプリケーションと組み合わせることができます。たとえば、1回の会話で売上テーブルを分析し、Googleドライブから関連するコンテキストを取得し、Eメールの要約の下書きを作成することができます。Databricksは、Unity CatalogおよびUnity Gatewayを介してすべてのツール呼び出しをガバナンスします。MCPのガバナンスを参照してください。

MCPツールは、次の2つのカテゴリに分類されます。

  • 読み取り専用ツール (検索、取得、一覧表示) は自動的に実行されます。
  • 書き込みツール (たとえば、メッセージの送信やEメールのドラフト作成など)は、実行される前に停止して、ユーザーにアクションの承認を求めます。

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

  • Google Drive : Google ドキュメント、スプレッドシート、スライドの検索と作成、作成したドキュメントの編集を行います。
  • Gmail : 検索、読み取り、およびEメールの下書き作成を行います。
  • Google Calendar :カレンダー イベントの検索と作成を行います。
  • Microsoft 365 : SharePoint、Teams、Outlook、カレンダーの検索、およびOutlookのEメールの下書き作成を行います。
  • Atlassian :JiraおよびConfluenceの検索と更新を行います。
  • Glean (ベータ):Gleanを使用して、組織の接続済みアプリ全体を検索します。
  • Slack :Slackのメッセージとチャンネルの検索、およびメッセージの送信を行います。
  • GitHub :リポジトリ、問題、およびプルリクエストの検索と更新を行います。

要件​

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

  • ワークスペースでUnity Catalogが有効になっていること。

  • 使用しているリージョンでエージェントモードが利用可能であること。リージョンの可用性を参照してください。

  • お使いのリージョンでUnity Gatewayが利用可能です。サポートされているリージョンについては、「サポートされているリージョン」を参照してください。

  • エージェントのすべてのユーザーに対する、 ワークスペースアクセス および Databricks SQLアクセス の両方の権利。コンシューマーのみのユーザー、Databricks SQLのみのユーザー、およびアカウントのみのユーザーは、MCPツールを使用できません。See アクセス権限.

  • エージェントのすべてのユーザーに対応する、接続された外部システムごとのアカウント。

コネクターをGenie Agentに追加する​

Genie Agentにコネクターをアタッチするには:

  1. Genie Agentを開いてください。
  2. ソース タブを開き、 追加 をクリックします。
  3. 1つまたは複数の MCP サービスを選択します。

コネクタをアタッチするには、Unity Catalog 内のコネクタの MCP サービスに対する EXECUTE と、その親カタログおよびスキーマに対する USE CATALOG および USE SCHEMA が必要です。ラン権限のないコネクタは使用できません。「Databricks 提供の MCP」を参照してください。

ツールを構成する​

コネクタをアタッチした後に、エージェントによるコネクタの使用方法を構成します。

  • エージェントがコネクタのツールを使用する方法とタイミングを説明するわかりやすい 説明 を追加します。たとえば、必要なチケットタイトルの形式をエージェントに指示したり、各会話の開始時にユーザーのプロフィールを調べるように指示したりできます。
  • コネクタ内の個々のツールを有効または無効にして、エージェントが実行できるアクションの範囲を絞り込みます。

会話でMCPツールを使用する​

Genie Agent で MCP ツールを使用するには:

  1. MCPコネクターがアタッチされているGenie Agentを開きます。
  2. チャットボックスでエージェントモードを有効にします。
  3. [Configure] パネルからコネクタに対して認証を行います。エージェントが承認していないコネクタを必要としている場合、または認証の有効期限が切れている場合、エージェントはサインインを求めます。
  4. コネクターを使用するプロンプトを送信します。エージェントが書き込みツールを呼び出したら、1回のアクションを承認するには「 1回だけ許可 」を、会話の残りの期間そのツールを承認するには「 このチャットで常に許可 」を、拒否するには「 拒否 」を選択します。

コネクターが機能することを確認するには、「GoogleドライブでQ3の販売計画を検索して。」など、コネクターを必要とする質問をします。エージェントは応答の中で使用した外部リソースを引用します。

制限事項​

次の制限が適用されます:

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

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

Google Drive​

  • Google Drive の承認を行っているときに、 [確認されていないアプリ] 画面が表示されることがあります。 [詳細設定] をクリックし、承認プロセスを続行します。
  • 最大ファイルサイズは25MBです。
  • ネイティブの Google ワークスペース ファイル(Docs、Sheets、Slides)のみがサポートされています。PDF、画像、およびその他のバイナリ形式はサポートされていません。
  • このコネクタでは、Google Docs、Sheets、Slidesの作成、および作成したGoogle Docsの編集を行うことができます。コネクタの外で作成されたDocsの編集や、既存のSheetsまたはSlidesの編集はできません。
  • 非常に大きなドキュメントの読み取りには時間がかかる場合があります。
注記

Google ワークスペース APIs から受け取った未処理または派生的なユーザーデータの使用および転送は、制限付き使用要件を含め、Google API サービス ユーザー データ ポリシーに準拠します。

Gmail​

  • このコネクターはEメールの検索、読み取り、下書きの作成ができますが、Eメールの送信や既存のメッセージの編集はできません。
  • コネクタは、DriveファイルをネイティブのGmail添付ファイルとして追加できません。回避策として、Eメールの本文にファイルへのLinkを含めてください。

Microsoft 365​

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

Glean (Beta)​

  • Glean は検索専用です。直接Linkからのドキュメントの読み取りはできません。
  • 非管理者ユーザーが接続を使用できるようにするには、まずメタストア管理者がGleanテナントIDを設定する必要があります。管理者は、Gleanへの初回接続時にテナントIDを入力できます。
  • 特定の Glean MCP server に接続するには、接続のセットアップ時にメタストア管理者がオプションで MCP サーバーのパス (例: /mcp/eng) を設定できます。default のパス (/mcp/default) を使用するには、このフィールドを空白のままにします。非管理者ユーザーは、Glean MCPサーバーのパスを指定または変更できません。

Slack​

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

GitHub​

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

その他のリソース​

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