Búsqueda web en Azure Databricks

En esta página se describe la búsqueda web en Azure Databricks y cómo usarla para basar las respuestas del modelo con información en tiempo real de la web. La búsqueda web está disponible para modelos antrópicos a través del Protocolo de contexto de modelo (MCP).

Tip

Genie Code (modo agente) puede hacerlo automáticamente. Pruebe esta indicación de ejemplo:

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.

La búsqueda web permite que los modelos de base recuperen información actualizada de la Internet durante la generación de respuestas. Cuando la búsqueda web está habilitada, el modelo puede buscar la web para encontrar información relevante e incorporarla en su respuesta. Esto resulta útil para preguntas sobre eventos actuales, datos recientes o cualquier tema en el que la información en tiempo real mejore la respuesta.

Habilite la búsqueda web de modelos antrópicos mediante un servidor MCP de búsqueda web, como You.com desde Azure Databricks Marketplace.

Modelos antrópicos con MCP

La herramienta de búsqueda web nativa de Anthropic no está disponible a través de las API de Azure Databricks Foundation Model. En su lugar, puede agregar búsqueda web a modelos antrópicos mediante el Protocolo de contexto de modelo (MCP) con un proveedor de búsqueda como You.com.

Configuración del servidor MCP de You.com

  1. Vaya a Marketplace > Agents > MCP Servers en el área de trabajo de Azure Databricks.
  2. Busque You.com y haga clic en Instalar.
  3. Configure la conexión:
  • Nombre de conexión: escriba un nombre (por ejemplo, youcom_web_search).
  • Token de portador: escriba la clave de API de You.com.
  1. Haga clic en Instalar.
  2. Conceda privilegios USE CONNECTION a los usuarios o grupos adecuados en Conexiones > de catálogo > [su conexión] > Permisos.

Después de la instalación, el servidor MCP está disponible como una herramienta en AI Playground, agentes y otros clientes compatibles con MCP. La dirección URL del punto de conexión de proxy para la conexión es:

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

Uso con Claude Code

Si usa Claude Code con Azure Databricks Foundation Model API, agregue el servidor MCP de You.com para habilitar la búsqueda 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>"

Compruebe que el servidor se agregó con claude mcp list.

Como alternativa, agregue el servidor directamente a ~/.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>"
      }
    }
  }
}

Modelos compatibles

Modelos antrópicos (a través de MCP)

La búsqueda web a través de MCP se admite en todos los modelos de base antrópica que admiten el uso de la herramienta.

  • 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

Privacidad y retención de datos

Cuando activas la búsqueda web a través de las APIs de Azure Databricks Foundation Model, la búsqueda se ejecuta en un endpoint de foundation model alojado en Azure Databricks. La consulta de búsqueda y los resultados son procesados por el modelo alojado independientemente del modelo al que llame tu aplicación. Los mismos términos de protección y retención de datos que rigen el Model Serving se aplican a estas solicitudes:

  • Azure Databricks no utiliza entradas enviadas a Model Serving, ni salidas de éste para entrenar modelos. Consulta Protección de datos de Servicio de Modelos.
  • Cualquier almacenamiento temporal para detectar abusos se mantiene en la misma región que tu espacio de trabajo y tiene un límite de tiempo. Consulta Retención de datos.

El modelo formula consultas de búsqueda a partir de tu prompt y las envía a un proveedor externo de búsqueda para obtener resultados. Trata el contenido por prompt que llega a la búsqueda web como datos que salen de Azure Databricks para el proveedor de búsqueda, y define lo que envía tu aplicación en consecuencia.

Limitaciones

  • La búsqueda web solo está disponible en los puntos de conexión del modelo de base de pago por token. Los puntos de conexión de ancho de banda aprovisionado no admiten la búsqueda web.
  • La búsqueda web no está disponible para las áreas de trabajo con el cumplimiento de HIPAA/BAA habilitada porque las consultas de búsqueda web se envían a servicios de búsqueda externos que no son compatibles con HIPAA.
  • Los resultados de la búsqueda web dependen de la capacidad del modelo de formular consultas de búsqueda y sintetizar resultados. La calidad de la respuesta puede variar.

Recursos adicionales

  • Last updated on