前の記事では、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 プレビューの管理 のアカウント側の手順です。
- アカウントコンソールに入る
- サイドバーの プレビュー を開く
- 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についての制約です。
