メインコンテンツまでスキップ
に最終更新

Genie One MCPサーバー

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

Genie One MCPサーバーは、DatabricksのマネージドMCPサーバーであり、 Genie Oneでのチャットを活用して、 Model Context Protocol（MCP） 上でGenieを会話型ツールとして公開します。MCPクライアントまたはエージェントが自然言語の質問を送信すると、Genieがエンタープライズデータを検索し、SQLを記述して、Genieオントロジーに基づいた回答を、引用されたDatabricksソースへのディープLinkと共に返します。

MCP クライアントまたはエージェントを接続して、Genie の信頼できる知見に基づいてデータに関する質問を行えるようにします。MCP Apps をサポートするクライアントは、Genie の進捗状況、視覚化、結果をインラインで表示するインタラクティブな View をレンダリングできます。

Unity Catalogのアクセス許可は常に適用されるため、ユーザーとエージェントはアクセスを許可されたデータのみをクエリーできます。

注記

Genie One MCP サーバーは、Genie One でのチャットを使用してワークスペースデータ全体に関する質問に回答し、パス /api/2.0/mcp/genie で提供されます。これは、単一の Genie Agent に対してクエリーを実行する /api/2.0/mcp/genie/{genie_space_id} のエージェントごとの Genie サーバーとは異なります。エージェントごとのサーバーについては、Databricks マネージド MCP サーバーを参照してください。

Genie One MCP サーバーを有効にする​

Genie One MCP サーバーには、 マネージド MCP サーバー のワークスペースプレビューが必要です。ワークスペース管理者は、次のように有効にします。

  1. ワークスペース管理者として、Databricksワークスペースの上部バーにあるユーザー名をクリックします。
  2. メニューから「 プレビュー 」を選択します。
  3. マネージドMCP サーバー を検索して有効にします。

プレビューの管理の詳細については、「Databricks プレビューの管理」を参照してください。

Endpointと認証​

Genie One MCP サーバーは、以下の URL で利用可能です。

https://<workspace-hostname>/api/2.0/mcp/genie

Genie One MCP サーバーへの接続は、他の Databricks マネージド MCP サーバーへの接続と同様です。リクエストはワークスペースに対して認証されている必要があります。ユーザーの代理認証 (on-behalf-of user authentication) で接続する場合は、genie OAuth スコープを含めてください。セットアップ手順については「OAuth 認証を使用したクライアントの接続」を、Cursor や Claude Desktop などのクライアントを接続するには「MCP を AI アシスタントおよびコーディングエージェントに接続する」を参照してください。

利用可能なツール​

Genie One MCPサーバーは、以下のツールを公開します。実際には、エージェントは genie_ask (またはMCP Appsクライアント上の view_ask) を呼び出して質問を行います。エージェントは、回答を作成する過程で、残りのツールをユーザーの代わりに管理します。

ツール

説明

genie_ask

Genieに自然言語でデータに関する質問をして、回答を起動します。conversation_id、response_id、およびstatusを返します。以前の会話を続けるには、conversation_idを渡します。

genie_poll_response

進行中または完了した応答の最新状態を取得します。これには、進捗ステップ、最終的な回答、および Databricks ソースへのディープLinkが含まれます。

genie_get_query_result

Genieがランしたクエリーについて、列スキーマと行を含む完全なSQL結果を取得します。

genie_cancel_response

実行中の Genie ターンのキャンセルをリクエストします。

view_ask

Genie に質問して、インタラクティブなビューを開きます。MCP Apps クライアントに対して genie_ask の代わりとして提供され、利用可能な場合はこちらが推奨されます。

ツール

説明

genie_ask

Genieに自然言語でデータに関する質問をして、回答を起動します。conversation_id、response_id、およびstatusを返します。以前の会話を続けるには、conversation_idを渡します。

genie_poll_response

進行中または完了した応答の最新状態を取得します。これには、進捗ステップ、最終的な回答、および Databricks ソースへのディープLinkが含まれます。

genie_get_query_result

Genieがランしたクエリーについて、列スキーマと行を含む完全なSQL結果を取得します。

genie_cancel_response

実行中の Genie ターンのキャンセルをリクエストします。

view_ask

Genie に質問して、インタラクティブなビューを開きます。MCP Apps クライアントに対して genie_ask の代わりとして提供され、利用可能な場合はこちらが推奨されます。

質問を入力​

Genie はデータを検索して SQL をランするエージェントをランするため、回答は非同期になります。あなた（またはエージェント）が質問を伴って genie_ask を呼び出すと、エージェントがその後のやり取りを自動的に管理します。一般的なフローは次のようになります。

  1. genie_ask 応答を起動し、conversation_id および response_id を status: in_progress とともに返します。Genieはバックグラウンドで動作し続けます。
  2. エージェントは応答が完了するまで genie_poll_response をポーリングし、その過程で progress_steps と narration_instruction を表示して状況を通知します。
  3. status が completed (または incomplete / failed) の場合、エージェントはレンダリングされた回答を返します。これには、完全な会話への Explore in Databricks ディープLinkと、Genie が生成した視覚化が含まれます。 [[ ## completed ##]]

同じ会話を続けるために、フォローアップの質問では以前の conversation_id を再利用します。

MCPアプリ​

Genie One MCPサーバーは、サーバーがプレーンテキストの代わりにインタラクティブなビューを返せるようにする拡張機能である MCP App を提供します。MCPアプリをサポートするクライアントでは、サーバーはインタラクティブな View を返します。これは、テキストのみの返信ではなく、会話の進行に合わせてGenieの進捗状況、可視化、最終的な回答を表示するクライアント埋め込み型のパネルです。

Claude Desktop 内で棒グラフ、サマリーメトリクス、および Genie Ontology の引用を表示する Genie One MCP アプリ。

Claude Desktop 内で棒グラフ、サマリーメトリクス、および Genie Ontology の引用を表示する Genie One MCP アプリ。

追加のセットアップは不要です。MCPアプリをサポートするクライアントは、自動的にインタラクティブなビューを取得します。テキスト結果の受信を継続しないクライアント。

考慮事項​

  • 権限 : Unity Catalog の権限はすべてのリクエストで適用されるため、結果はユーザーがアクセスできる範囲に限定されます。
  • 構成 : サーバーは、Databricks 内の Genie One 構成を尊重します。そこで Genie の動作を調整および構成します。Chat in Genie One を参照してください。
  • ポーリング間隔 : 前の genie_poll_response 呼び出しが完了するのを待ってから、再度ポーリングします。
  • 結果サイズ ：モデルのコンテキストウィンドウを保護するため、genie_ask および genie_poll_response は切り捨てられたクエリー結果を返します。エージェントが完全な結果を必要とする場合、genie_get_query_result を呼び出して完全なスキーマと行を取得できます。非常に大きな結果には依然としてサイズ制限が適用されます。制限を超えた場合、応答は切り捨てられます。
  • 価格 : Genie One MCPサーバーは Genie Oneでのチャットを使用します。Genieの価格を参照してください。

Genie One MCPサーバーへの接続​

Genie One MCPサーバーは、DatabricksのマネージドMCPサーバーの1つです。CursorやClaude Desktopなどの外部クライアントを接続する場合、またはサーバーを呼び出すエージェントを構築する場合は、AIアシスタントおよびコーディングエージェントへのMCPの接続を参照してください。

MCPサーバーとそのEndpoint URLを表示するには、ワークスペースに移動し、 エージェント > MCP を選択します。

このページの見出し