Azure Databricks 中的 Web 搜索

本页介绍 Azure Databricks 的网络搜索功能，并说明如何利用来自网络的实时信息来支持和增强模型的响应。 通过 模型上下文协议 （MCP），可使用 Web 搜索来访问 Anthropic 模型。

小窍门

Genie Code （代理模式）可以为你执行此操作。 请尝试以下示例提示：

Query the databricks-gemini-2-5-pro model using the OpenAI client with the google_search parameter enabled, ask a question about a current event, and print the response.

Web 搜索允许基础模型在响应生成期间从互联网检索最新信息。 启用 Web 搜索后，模型可以搜索 Web 以查找相关信息并将其合并到响应中。 这对于任何需要通过实时信息来提升响应的问题，如当前事件或最近数据，非常有用。

使用 Web 搜索 MCP 服务器（例如来自 Azure Databricks 市场的 You.com）为人类模型启用 Web 搜索。

带 MCP 的 Anthropic 模型

Anthropic的本机 Web 搜索工具无法通过Azure Databricks基础模型 API 使用。 相反，可以使用 模型上下文协议（MCP） 和搜索提供程序（如 You.com）将 Web 搜索添加到人类模型。

设置 You.com MCP 服务器

  1. 在您的 Azure Databricks 工作区中，导航至 市场 > 智能体 > MCP 服务器。
  2. 搜索 You.com 并单击“ 安装”。
  3. 配置连接：
  • 连接名称：输入名称（例如 youcom_web_search， ）。
  • 持有者令牌：输入 You.com API 密钥。
  1. 单击“安装”。
  2. 在 下，向相应用户或组授予 > 权限。

安装后，MCP 服务器作为 AI Playground、代理和其他 MCP 兼容的客户端中的工具提供。 连接的代理终结点 URL 为：

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

与 Claude Code 一起使用

如果将 Claude Code 与 Azure Databricks 基础模型 API 配合使用，请添加 You.com MCP 服务器以启用 Web 搜索：

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>"
      }
    }
  }
}

支持的模型

Anthropic 模型（通过 MCP）

支持工具使用的所有人类基础模型都支持通过 MCP 进行 Web 搜索。

  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-opus-4-7
  • databricks-claude-opus-4-6
  • databricks-claude-opus-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4

数据隐私与保存

当你通过 Azure Databricks Foundation Model API 启用网页搜索时，搜索会运行在 Azure Databricks 托管的基础模型端点上。 无论你的应用调用哪个模型，搜索查询和结果都会由托管模型处理。 这些请求适用与模范服务相同的数据保护和保留条款：

  • Azure Databricks 不使用发送给模型服务的输入或其输出来训练模型。 参见 模型服务数据保护。
  • 任何用于滥用检测的临时存储都会与你的工作区保持在同一区域，并且有时间限制。 参见数据保留。

模型会根据你的提示词生成搜索查询，并将其发送给外部搜索提供商以获取结果。 将到达网页搜索的提示内容视为离开 Azure Databricks 给搜索提供者的数据，并相应地范围应用发送的内容。

局限性

  • Web 搜索仅适用于按令牌付费的基础模型终结点。 预配的吞吐量终结点不支持 Web 搜索。
  • Web 搜索不适用于启用了 HIPAA/BAA 符合性的工作区，因为 Web 搜索查询将发送到不符合 HIPAA 的外部搜索服务。
  • Web 搜索结果取决于模型构建搜索查询和合成结果的能力。 响应质量可能有所不同。

其他资源

  • Last updated on