次の方法で共有

Genie Code を MCP サーバーに接続する

モデル コンテキスト プロトコル (MCP) を使用して Genie Code を外部ツールとデータ ソースに接続します。 Genie Code では、ワークスペースに追加され、使用するアクセス許可を持つ任意の MCP サーバーを使用できます。

注

MCP サーバーは Genie Code Agent モードでのみサポートされます。

MCP とは

MCP は、AI エージェントをツール、リソース、プロンプト、およびその他のコンテキスト情報に接続するopen source標準です。 MCP は、そのコンテキストをプロンプトや命令に直接埋め込まずに、Genie Code にツール、データ、ワークフローを公開する標準化された方法を提供します。

MCP は、重要なコンテキストが既に存在するが、Genie Code などの AI エージェントからアクセスするのが困難な場合に向けて設計されています。 MCP は、Genie Code に次のようなコンテキストへのアクセスを許可する安全な方法を提供します。

  • ドキュメント システム: Teams は、多くの場合、Confluence などのツールで Runbook や運用ドキュメントを保持します。 セクションをプロンプトにコピーする代わりに、そのコンテンツを外部 MCP サーバー経由で 1 回公開し、関連する場合に参照することができます。 ドキュメントは、ベクター検索インデックスとして Databricks に既にある場合もあります。このインデックスを使用して、Genie Code を使用して関連するドキュメントのクエリを実行できます。
  • ツールとサービス: プラットフォーム チームは、セットアップ、検証、またはデプロイ用の API またはスクリプトを維持できます。 MCP を使用すると、これらの機能を Genie Code で直接使用できます。
  • データ ソース: Databricks に既にデータがある場合は、Genie Code を Genie 空間に接続して、自然言語を使用してデータを分析できます。 Databricks の外部に格納されているデータの場合は、外部 MCP サーバー経由で Genie Code に安全なアクセス権を付与できます。
  • カスタム アプリ: Databricks Apps でホストされるカスタム機能を追加することもできます。 これにより、Genie Code を、自分または組織専用に構築された独自のツール、ワークフロー、または統合に接続でき、すべて Databricks ワークスペース内で安全に管理されます。

このような場合、MCP は手動コピー貼り付けを構造化された再利用可能なアプローチに置き換え、必要なときにのみ適切なコンテキストを使用できるようにします。

Genie Code は、使用するアクセス許可を持つワークスペース内の任意の MCP サーバーに接続できます。 ワークスペース管理者は使用可能なサーバーを制御しますが、ユーザーは必要に応じて承認されたソースから選択できます。

Databricks の MCP サーバーと独自のサーバーを作成する方法の詳細については、 Databricks のモデル コンテキスト プロトコル (MCP) に関するページを参照してください。

サード パーティのデータ ソースに接続する

Important

この機能は ベータ版です。 サード パーティのデータ ソース コネクタを使用するには、ワークスペース管理者が サード パーティ コネクタ for Agents プレビューを 有効にする必要があります。 Manage Azure Databricks プレビューを参照してください。

Genie Code には、Google Drive や SharePoint など、一般的なエンタープライズ データ ソース用の組み込みコネクタが用意されています。

これらのデータ ソースに接続すると、Genie Code は質問に答えるときにドキュメントを検索できます。 各ユーザーは個別に認証され、OAuth トークンはユーザー間で共有されません。

サード パーティのデータ ソースを接続するには:

  1. ワークスペースで、 スパークル genie コード アイコンをクリックします。 右上隅の Genie Code でチャットを開きます。
  2. プロンプト バーで、[新規] アイコン をクリックします。プラスアイコン。
  3. 接続するデータ ソースの横にある [ 接続] をクリックします。
  4. サインインする手順を完了します。

認証後、Genie Code は質問に答えるときにドキュメントを検索できます。 Metastore 管理者と接続所有者は、接続に対するユーザーのアクセス許可を管理または取り消すことができます。 MCP サーバー接続の共有を参照してください。

注

データ ソース ツールは、常に自動的にトリガーされるとは限りません。 ドキュメント検索が開始されない場合は、"Google Docs の使用" や "SharePointの使用" などのツールの使用を Genie Code に明示的に求めてみます。

他のデータ ソースを接続するには、それらを Genie Code に手動で追加します。 「Genie Code に MCP サーバーを手動で追加する」を参照してください。

Google ドライブの制限事項

  • 最大ファイル サイズは 10 MB です。
  • ネイティブの Google Workspace ファイル (Docs、スプレッドシート、スライド) のみがサポートされています。 PDF、画像、およびその他のバイナリ形式はサポートされていません。
  • 接続またはトークンの有効期限エラーがエージェントの出力に表示される場合があります。 解決するために再認証します。

SharePointの制限事項

  • 最大ファイル サイズは 10 MB です。
  • サポートされているファイルの種類には、Office ドキュメント (.docx、.xlsx、.pptx)、一般的なテキスト ベースの形式 ( .txt、 .csv、 .json、 .mdなど) があります。 PDF、画像、およびその他のバイナリ形式はサポートされていません。

Genie Code に MCP サーバーを手動で追加する

Genie Code を MCP サーバーに接続するには、Genie Code の設定に追加します。

  1. Genie Code の設定を開きます。 Genie Code パネルで、 歯車アイコン をクリックします。設定。
  2. [MCP サーバー] の [新規] アイコンをクリックします。サーバーを追加します。
  3. 追加する MCP サーバーを選択します。 Databricks マネージド MCP サーバーまたは外部 MCP サーバーを選択できます。
    • Unity カタログ関数: 関数のスキーマを選択します。 これにより、Genie Code は関数を使用して定義済みの SQL クエリを実行できます。
    • ベクター検索: インデックスのスキーマを選択します。 これにより、Genie Code はベクター検索インデックスに対してクエリを実行して、関連するドキュメントを検索できます。
    • Genie スペース: Genie スペースを選択します。 Genie MCP は Genie をツールとして呼び出し、Genie 空間にクエリを実行して自然言語を使用してデータを分析できるようにします。
    • 外部 MCP サーバー: 外部 MCP サーバーとして使用する Unity カタログ接続を選択します。 接続を使用するには、まず接続にログインする必要があります。
    • カスタム MCP サーバー: カスタム MCP サーバーとして使用する Databricks アプリ を選択します。 これにより、任意のカスタム定義ツールを使用できます。 次の要件が適用されます。
      • アプリは、接続先と同じワークスペースにデプロイする必要があります。
      • MCP サーバーは、 https://<server-url>/mcpでアクセスする必要があります。
      • アプリはステートレスである必要があります。 たとえば、 mcp_app = mcp_server.http_app(stateless_http=True)を設定します。
      • CORS エラーが発生した場合は、許可された配信元のアプリの一覧にワークスペースの URL を追加することが必要になる場合があります。 たとえば、 app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])を設定します。
  4. [保存] をクリックします。

追加された MCP サーバーは、Genie Code ですぐに使用できるようになります。 プロンプトや指示を変更することなく、エージェント モードで使用を開始できます。 Genie Code は、関連する場合にこれらのサーバーを自動的に利用します。

現在、MCP アクセスはすべてのサーバーで 20 個のツールに制限されています。 Genie Code の設定で有効または無効にするツールとサーバーを選択できます。

  • Last updated on