0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

PR: データブリックス・ジャパン株式会社
MLflowで実践するLLMOps

Databricksカスタムエージェントから公開Web検索を利用する

0
Last updated at Posted at 2026-11-14

前の記事では、GenieのWeb検索 を書きました。業務ユーザーがチャットから公開情報を足す話です。

自分でエージェントを組む側には、別の入り口があります。Unity GatewayのMCP system.ai.web_search です。コーディングエージェントやPythonエージェントから、公開Webをツールとして呼べます。

Marketplaceで検索サーバーを立てたり、APIキーを別途持ったりしなくてよいのがポイントです。

Genie OneのWeb検索との違い

Genie One / Genie Code system.ai.web_search
誰向け 業務ユーザーのチャット、開発中のGenie Code カスタムエージェント、コーディングエージェント
スイッチ ワークスペースのプレビュー Web search in Genie Code and Genie One アカウントのプレビュー Unity Gatewayベータ
呼び出し方 チャットが必要なら検索する MCPツール web_search を明示的につなぐ
ガバナンス Genieの画面と権限 Unity Catalogのセキュアオブジェクト。GRANTやポリシーの対象
Consumer accessのみ Genie Oneのチャットは使える 使えない

何ができるか

Databricks提供のMCP のひとつで、公開Webを検索し、出典つきの要約を返します。

現場では次のような使い方です。

  • 社内データはGenie One MCPやSQLで取り、最新の公開仕様だけWeb検索する
  • Anthropic系のモデルでエージェントを組む。Foundation Model APIにはAnthropicのネイティブWeb検索がないので、MCP側で足す
  • CursorやClaude Codeから、実装中のライブラリの最新ドキュメントを引く

サービス側が使うモデルはDatabricksが管理します。呼び出す側がモデルを選ぶ必要はありません。ツールが受け取るのは自然言語の query だけです。

できないこと・注意すること

  • Consumer accessだけのユーザーは呼べません。Genie Oneチャットとは逆です。
  • HIPAA / BAA のワークスペースでは使えません。検索クエリがHIPAA非対応の外部検索に出るためです。

  • ワークスペースのネットワーク制御で インターネット送信を止めている と使えません。
  • 対応は サポートされている米国リージョン、またはクロスGeo処理が許可されたワークスペース です。日本リージョンは後者です。クロスGeoのトグルの向きは前の記事と同じです。
  • 検索の質は、クエリの作り方と要約に依存します。必ず当たる検索ではありません。

Gemini / OpenAIの ネイティブWeb検索(google_search や Responses APIの web_search)や、MarketplaceのYou.comは別経路です。この記事では system.ai.web_search に絞ります。

設定方法

1. Unity Gatewayベータをオンにする

system.ai.web_search(および system.ai.dbsql、system.ai.sandbox)を使うには、アカウント管理者がアカウントコンソールのプレビューで Unity Gatewayベータ を有効にします。Databricks プレビューの管理 のアカウント側の手順です。

  1. アカウントコンソールに入る
  2. サイドバーの プレビュー を開く
  3. Unity Gatewayベータをオンにする

ワークスペースの Web search in Genie Code and Genie One とは別トグルです。Genie One用をオンにしても、こちらは有効になりません。

2. 権限を確認する

呼び出し側に次が必要です。アカウントユーザーには既定で付いています。

  • system.ai.web_search に対する EXECUTE
  • カタログ system の USE CATALOG
  • スキーマ system.ai の USE SCHEMA

アプリやサービスプリンシパルから呼ぶときは、既定に頼らずGRANTを確認してください。アプリをMCPツールに接続する も同じ権限モデルです。

見えるかどうかは、次で確認できます。

databricks ai-gateway list-mcp-services --parent schemas/system.ai

3. MCPのURL

どの system.ai MCPも、次の形です。

https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.web_search

ホスト名はブラウザのワークスペースURLから、https:// とパスを除いたものです。クライアントによっては末尾に ?o=<workspace-id> が必要です。

つなぎ方

コーディングエージェント(ug)

ツールとスキルを追加する のとおり、Unity Gateway CLIで足します。

ug mcp add --names system.ai.web_search

対話で選ぶなら ug mcp add だけでもよいです。追加したら、エージェントに「公開されている最新のリリースノートをWeb検索して要約して」と頼んで、ツール呼び出しが出るか見ます。

接続の確認と削除は ug mcp list / ug mcp remove です。外しても、ワークスペース側のMCP自体は残ります。

Pythonエージェント

PythonエージェントからMCPツールを呼ぶ の手順です。先にツール一覧が出ることを確認してから、エージェントに組み込みます。

from databricks.sdk import WorkspaceClient
from databricks_mcp import DatabricksMCPClient

workspace_client = WorkspaceClient()
mcp_client = DatabricksMCPClient(
    server_url="https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.web_search",
    workspace_client=workspace_client,
)

for tool in mcp_client.list_tools():
    print(tool.name, tool.description, tool.inputSchema, sep="\n")

ツール名は web_search、引数は自然言語の query です。動作確認だけなら、そのまま呼べます。

result = mcp_client.call_tool("web_search", {"query": "Databricks Genie One web search release notes"})
print(result)

LangGraphやOpenAI Agents SDKへの載せ方は、同じドキュメントのステップ3です。モデルはツール呼び出しができるエンドポイントであればよく、検索そのものはMCP側が担当します。

現場での使い分け

  • 業務ユーザーがチャットで公開情報も見たい
    →Genie OneのWeb検索。Consumer accessでもチャット自体は使える。

  • 自前のエージェントやIDEから、公開Webをツールとして足したい
    → system.ai.web_search。Unity Gatewayで誰が呼べるかを管理できる。

  • 検索プロバイダーを自分で選びたい / 既存のYou.com契約がある
    →Marketplaceの外部MCP。キーと USE CONNECTION が別途必要。

日本リージョンでデータ所在地をGeo内に閉じる方針なら、現時点ではこのMCPも対象外になりやすいかもしれません。オンにする判断は、Genie OneのWeb検索と同じくクロスGeoについての制約です。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?