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

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

Genie Agentは、MCP (Model Context Protocol) ツールを使用して、外部ツールやソースからコンテキストをプルし、アクションを実行することができます。エージェント作成者は、Databricksが提供するコネクタ、またはUnity Gatewayに登録されている外部MCPサーバーを関連付けます。ユーザーは、エージェントモードでの会話中にこれらのツールを使用するようにエージェントに依頼できます。

注記

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

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

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

Genieエージェントは、次の2種類のMCPソースをサポートしています。

  • Databricksが提供するコネクタ :Databricksが一般的なアプリケーション向けに管理するコネクタ。次のコネクタを利用できます:

    • Google Drive : Google ドキュメント、スプレッドシート、スライドの検索と作成、作成したドキュメントの編集を行います。
    • Gmail : 検索、読み取り、およびEメールの下書き作成を行います。
    • Google Calendar :カレンダー イベントの検索と作成を行います。
    • Microsoft 365 : SharePoint、Teams、Outlook、カレンダーの検索、およびOutlookのEメールの下書き作成を行います。
    • Atlassian :JiraおよびConfluenceの検索と更新を行います。
    • Asana : タスク、プロジェクト、ポートフォリオ、ユーザー、チームを検索し、書き込みアクションが許可されている場合はタスクを作成または更新します。
    • Glean (ベータ):Gleanを使用して、組織の接続済みアプリ全体を検索します。
    • Slack :Slackのメッセージとチャンネルの検索、およびメッセージの送信を行います。
    • GitHub :リポジトリ、問題、およびプルリクエストの検索と更新を行います。
  • 外部MCPサーバー : 組織がUnity Gatewayに登録する、セルフホストまたはサードパーティのMCPサーバー。外部MCPサーバーを参照してください。

要件​

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

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

  • 使用しているリージョンでエージェントモードが利用可能であること。「Databricks指定サービス」をご覧ください。

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

  • アカウントのみのユーザーは、MCPツールを使用できません。アクセスエンタイトルメントを参照してください。

  • 各ユーザーは、接続されている各MCPツールまたはソースにアカウントを持っている必要があります。

  • コネクタをアタッチするには、エージェントの作成者にMCP上のEXECUTEに加えて、親カタログとスキーマ上のUSE CATALOGおよびUSE SCHEMAが必要です。作成者がランする権限を持たないコネクターは利用できません。MCPを共有するを参照してください。

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

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

  1. Genie Agentを開いてください。
  2. ソース タブを開き、 追加 をクリックします。
  3. 1つ以上のMCPサービスを選択してください。Databricks提供のコネクタ、またはUnity Gatewayに登録されている外部MCPサーバーを選択できます。

外部MCPサーバーへのユーザーの認証方法は、その資格情報によって異なります。

  • ユーザーごとの OAuth : エージェントがサーバーのツールを使用する前に、各ユーザーがサインインする必要があります。
  • 共有資格情報 : ユーザーはサインインしません。共有資格情報が機能しなくなった場合、エージェントはユーザーに、サーバーの所有者が資格情報を更新する必要があることを伝えます。

ツールを構成する​

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

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

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

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

  1. MCPコネクターがアタッチされているGenie Agentを開きます。

  2. エージェントモードがオンになっていることを確認してください。

  3. コネクタにサインインが必要な場合は、 ソース リストから、またはエージェントのプロンプトが表示されたときに認証してください。

    組織でサインインがブロックされている場合は、サードパーティアプリの追加設定をご覧ください。

  4. コネクターを使用するプロンプトを送信します。

エージェントモードAPIを介してMCPツールを使用することもできます。コネクタにサインインが必要な場合、APIレスポンスはユーザーにサインインするように指示します。

コネクタの管理者承認の取得​

ユーザーがサインインできるようになる前に、Slack、Google ワークスペース、Microsoft 365、または GitHub の管理者が Databricks アプリを承認または設定する必要がある場合があります。各プロバイダーのステップについては、サードパーティアプリの追加設定を参照してください。

制限事項​

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

  • MCPツールはエージェントモードでのみ実行されます。チャットモードではランしません。
  • Genie Agentは、Databricksが提供するコネクタと外部MCPサーバーの両方を含め、最大10個のMCP接続を持つことができます。
  • Service principalはMCPツールを使用できません。
  • 接続されたアプリケーションのコンプライアンスに関するガイダンスについては、外部プロバイダーの要件を参照してください。

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

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、OneDrive、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コネクタはパブリックリポジトリにのみアクセスできます。プライベートリポジトリにアクセスしたり、ファイルのcommitやissueおよびプルリクエストの作成などの変更を行ったりするには、リポジトリの所有者またはGitHub組織の管理者が追加のセットアップを行う必要があります。GitHubの書き込みアクセスとプライベートリポジトリのアクセスを有効にするを参照してください。
  • GitHub Enterprise Server (GitHub のセルフホスト版) はサポートされていません。

その他のリソース​

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