Azure Databricksでの Web 検索

このページでは、Azure Databricks 上の Web からのリアルタイム情報で応答を根拠付ける方法を説明しています。 MCP互換クライアントやエージェントをウェブ検索ツールに接続するために、 Model Context Protocol(MCP) を備えたウェブ検索サーバーを使用します。

Tip

Genie Code はユーザーの代わりにこれを実行できます。 次のプロンプトの例を試してください。

Query the system.ai.gemini-3-1-pro model using the OpenAI client with the google_search parameter enabled, ask a question about a current event, and print the response.

Web 検索を使用すると、基盤モデルは、応答の生成中にインターネットから up-to-date 情報を取得できます。 Web 検索が有効になっている場合、モデルは Web を検索して関連情報を検索し、応答に組み込むことができます。 これは、現在のイベント、最近のデータ、またはリアルタイム情報によって応答が向上するトピックに関する質問に役立ちます。

Azure Databricks Marketplaceの You.com などのウェブ検索MCPサーバーを使用して、MCP互換クライアントやエージェントのウェブ検索を有効にしてください。

MCPを通じたウェブ検索

MCP互換のクライアントやエージェントは、モデルプロバイダーとは独立してウェブ検索ツールを呼び出すことができます。 クライアントやエージェントを MCPを使ってウェブ検索MCPサービスやサーバーに接続してください。

Anthropic のネイティブ Web 検索ツールは、Azure Databricks Foundation Model API では使用できません。 MCPを使って、Anthropicモデルを使用するエージェントにウェブ検索ツールを提供します。

You.com MCP サーバーを設定する

You.com はMCP互換クライアントやエージェント向けのサードパーティ製の代替手段です。

  1. Azure Databricks ワークスペースの Marketplace > Agents > MCP Servers に移動します。
  2. You.com を検索し、[インストール] をクリックします。
  3. 接続を構成します。
  • 接続名: 名前を入力します (例: youcom_web_search)。
  • ベアラー トークン: You.com API キーを入力します。
  1. [インストール] をクリックします。
  2. 適切なユーザーまたはグループに USE CONNECTION 権限を付与するには、カタログ > 接続 > [your connection] > のアクセス許可セクションを利用してください。

セットアップ後、MCP サーバーは、AI Playground、エージェント、およびその他の MCP 互換クライアントのツールとして使用できます。 接続のプロキシ エンドポイント URL は次のとおりです。

https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>

Claudeコードで You.com を使う

Claude CodeおよびAzure Databricks Foundation Model APIで You.com を使用するには、You.com MCPサーバーを追加してください:

claude mcp add youcom-search \
  --transport http \
  --url "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>" \
  --header "Authorization: Bearer <your-databricks-pat>"

claude mcp listを使用してサーバーが追加されたことを確認します。

または、 ~/.claude.jsonにサーバーを直接追加します。

{
  "mcpServers": {
    "youcom-search": {
      "type": "http",
      "url": "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>",
      "headers": {
        "Authorization": "Bearer <your-databricks-pat>"
      }
    }
  }
}

サポートされているモデル

MCPのウェブ検索には、MCPツールを呼び出せるクライアントまたはエージェントが必要です。 特定のモデルプロバイダーに限定されるわけではありません。 エージェント統合については、「PythonエージェントでMCPツールを使う」をご覧ください。

データのプライバシーと保持

Azure Databricks Foundation Model APIsでウェブ検索を有効にすると、検索はAzure Databricksがホストする基盤モデルエンドポイント上で実行されます。 検索クエリと結果は、アプリケーションが呼び出すモデルに関わらずホストモデルによって処理されます。 モデルサービングを規定するデータ保護および保持条件は、これらのリクエストにも適用されます。

  • Azure Databricks では、Model Serving に送信された入力や、そこからの出力をモデルのトレーニングに使用しません。 詳細は 「モデル・サービングデータ保護」を参照してください。
  • 乱用検出用の一時的なストレージはワークスペースと同じ領域に保管され、時間制限があります。 データ 保持についても参照してください。

モデルはプロンプトから検索クエリを生成し、外部の検索プロバイダーに送信して結果を取得します。 ウェブ検索に届くプロンプトコンテンツは、検索プロバイダーにAzure Databricksから送るデータとして扱い、アプリケーションがそれに応じて送信する範囲を適用してください。

制限事項

  • WEB 検索クエリは HIPAA に準拠していない外部検索サービスに送信されるため、HIPAA/BAA 準拠が有効になっているワークスペースでは Web 検索を使用できません。
  • Web 検索結果は、検索クエリを作成して結果を合成するモデルの機能によって異なります。 応答の品質は異なる場合があります。

その他のリソース

  • 最終更新: