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

Genie One MCPサーバー

備考

ベータ版

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

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

任意の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のプレビューを管理するを参照してください。

エンドポイントと認証​

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

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

Genie One MCPサーバーに接続することは、他のDatabricksマネージドMCPサーバーに接続するのと同様です。リクエストはワークスペースに対して認証される必要があります。ユーザーに代わる認証で接続する際、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ソースへのディープリンクが含まれます。

genie_get_query_result

Genieが実行したクエリの完全なSQL結果（列スキーマと行）を取得します。

genie_cancel_response

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

view_ask

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

質問する​

Genieはデータを検索しSQLを実行するエージェントを実行するため、回答は非同期です。genie_askに質問して呼び出すと、エージェントが残りのやり取りを自動的に管理します。一般的なフローは次のとおりです:

  1. genie_ask 応答を開始し、status: in_progressとともにconversation_idとresponse_idを返します。Genieはバックグラウンドで動作を続けます。
  2. 応答が完了するまで、エージェントはgenie_poll_responseをポーリングし、その過程でprogress_stepsとnarration_instructionを表示して、情報を提供し続けます。
  3. statusがcompleted （またはincomplete /failed ）の場合、エージェントはレンダリングされた回答を返します。これには、完全な会話への「 Databricks で探索 」ディープリンクと、Genie が生成したすべての視覚化が含まれます。

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

MCPアプリ​

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

Genie One MCPアプリは、Claude Desktop内で棒グラフ、概要メトリクス、Genie Ontologyの引用を表示します。

Genie One MCPアプリは、Claude Desktop内で棒グラフ、概要メトリクス、Genie Ontologyの引用を表示します。

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

考慮事項​

  • 権限： Unity Catalogの権限はすべてのリクエストで適用されるため、結果はユーザーがアクセスできる範囲に限定されます。
  • 構成 ：サーバーは、DatabricksでのGenie Oneの構成を尊重します。そこでGenieの動作を調整および構成します。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などの外部クライアントを接続する場合、またはサーバーを呼び出すエージェントを構築する場合は、MCPをAIアシスタントとコーディングエージェントに接続するを参照してください。

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

このページの見出し