Búsqueda web con modelos Claude de Anthropic

La búsqueda web es una función que permite que un modelo de Claude aumente su conocimiento con datos en tiempo real de la Web. Los modelos de Claude usan un proveedor de búsqueda externo para la función de búsqueda web. La capacidad de búsqueda web es particularmente potente para las aplicaciones de RAG (generación mejorada por recuperación) en las que necesitas citar fuentes con precisión.

La función de búsqueda web es adecuada para los siguientes casos de uso:

  • Recuperar la documentación técnica más reciente: Los desarrolladores de software pueden preguntarle a Claude sobre la documentación de la API o las especificaciones técnicas más recientes, y Claude puede recuperar y sintetizar información directamente de la documentación de origen.
  • Recopilar información empresarial y de mercado: Los analistas empresariales pueden recopilar datos actuales del mercado, información de la empresa o noticias del sector para respaldar sus procesos de toma de decisiones.
  • Asistir en la investigación: Los trabajadores del conocimiento pueden usar Claude como un asistente de investigación que puede encontrar, sintetizar y explicar información de varias fuentes web, a la vez que mantiene citas precisas.
  • Asistencia a los clientes: Las aplicaciones de atención al cliente pueden acceder a información actualizada sobre los productos, los precios o la documentación de asistencia de los sitios web de la empresa.

Modelos compatibles

Gemini Enterprise Agent Platform admite la búsqueda web para los siguientes modelos de Claude de Anthropic:

Controla el acceso a la búsqueda web

La función de búsqueda web requiere acceso público a Internet. De forma predeterminada, la búsqueda web está inhabilitada por la restricción de la política de la organización constraints/vertexai.allowedPartnerModelFeatures. Para habilitar la búsqueda web, debes configurar esta restricción para permitirla de forma explícita.

Además, puedes configurar la restricción de la política de la organización constraints/vertexai.allowedModels para restringir el acceso a los modelos de Claude.

Para garantizar el acceso continuo a la búsqueda web para estas versiones específicas del modelo después de junio de 2026, configura la política de la organización constraints/vertexai.allowedPartnerModelFeatures para permitir la búsqueda web antes de fines de junio de 2026.

Para obtener instrucciones detalladas sobre cómo configurar las restricciones de las políticas de la organización, consulta Controla el acceso a los modelos de Model Garden.

Habilita la búsqueda web proporcionando una nueva definición de herramienta de Anthropic (web_search) en la solicitud a la API.

Por ejemplo, en el siguiente fragmento de código, se usa la búsqueda web para recuperar información meteorológica en tiempo real:

response = await client.messages.create(
    model="claude-4-sonnet-latest",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "What is the weather in San Francisco?"
    }],
    tools=[{
        "type": "web_search",
        "name": "web_search",
        "max_uses": 5
    }]
)

También puedes usar campos opcionales para especificar dominios permitidos y bloqueados. Por ejemplo:

tools=[{
  ...
  # Only one of allowed_domains and blocked_domains can be provided.
  # allowed_domains excludes everything except the specified domains
    "allowed_domains": ["example.com", "example.org"],

  # blocked_domains includes everything except the specified domains
  # Use the `NOT site:` search operator
    "blocked_domains": ["example.net"],
}]

Para obtener más información sobre los campos opcionales, consulta la documentación de la herramienta de búsqueda web de Claude.

Cuando el modelo determina que se requiere la búsqueda web, la API invoca la herramienta de búsqueda web hasta que no se requieran más llamadas a la herramienta. La respuesta incluye detalles sobre las búsquedas intermedias, con los resultados encriptados.

El siguiente fragmento de código es un ejemplo de una respuesta con búsqueda web:

{
  ...
  "role": "assistant",
  "content": [
    // Initial output from the model
    {
      "type": "text",
      "text": "I need to search the web to answer this question about the weather in San Francisco."
    },
    {
      "type": "server_tool_use",
      "id": "srvtoolu_9a90a390a",
      "name": "web_search",
      "input": {
        "query": "What is the weather in San Francisco?",
      }
    },
    // API sees an `</antml:function_calls>` stop sequence here, sees that
    // the tool use is for a server-side tool, and then runs that
    // tool. If there is a mix of client and server-side, the API would
    // need to return to the client and let it pass back client tool results
    // before continuing with server tools.
    {
      "type": "web_search_tool_result",
      // "name": "web_search", use this to determine what types of blocks are inside `content`
      "tool_use_id": "srvtoolu_9a90a390a",
      "content": [
        {
          "type": "web_search_result",
          "uri": "https://weather.com",
          "title": "National and Local Weather",
          "encrypted_content": "eyJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
        {
          "type": "web_search_result",
          "uri": "https://accuweather.com",
          "title": "San Francisco, CA Hourly Weather",
          "encrypted_content": "yaJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
      ],
    },
    // Server starts a new sampling run with the above content appended (unencrypted)
    // to the original request. Everything below is completion content from the
    // second sampling run.
    {
      "type": "text",
      "text": "The current weather in San Francisco, CA is 65 degrees Fahrenheit and partly cloudy."
    }
  ],
  // Server output is no longer 1-to-1 with a single sampling run. From the
  // user's perspective, there is just one "Message" with a single id
  "id": "msg_a930390d3",
  "usage": {
    "input_tokens": 3029,
    "output_tokens": 6039,
    "server_tool_use": {
      "web_search_requests": 2
    }
  },
  "stop_reason": "end_turn"
}

Transmisión con búsqueda web

Con la transmisión habilitada, el modelo devuelve eventos de búsqueda como parte de la transmisión. Por ejemplo:

// Claude's decision to search

event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_search"}}

// Search query streamed
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"query\":\"latest quantum computing breakthroughs 2025\"}"}}

// Pause while search executes

// Search results streamed
event: content_block_start
data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_search_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": [{"type": "web_search_result", "title": "Quantum Computing Breakthroughs in 2025", "url": "https://example.com"}]}}

El uso se mide y se incluye en los mensajes de message_delta, que incluyen un recuento acumulativo de elementos de web_search. Por ejemplo:

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":10682,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":510,"server_tool_use":{"web_search_requests":1}}}

La función de búsqueda web para Claude 4.0 y modelos más recientes es una función opcional de los modelos Claude de Anthropic. Puedes habilitarla proporcionando la herramienta de búsqueda web en las solicitudes. Cuando activas esta función, le indicas a Gemini Enterprise Agent Platform que habilite los modelos de Claude para que envíen consultas de búsqueda derivadas de tu solicitud a un proveedor de servicios de búsqueda externo seleccionado por Anthropic. Google no se hace responsable de las prácticas de procesamiento de datos de este proveedor externo. Una vez que se transmiten las búsquedas, el manejo de esos datos se rige por las condiciones del servicio y la política de privacidad del tercero, no por las de Google.

Activar la función de búsqueda web tiene implicaciones directas en tu postura de seguridad y administración de datos. Los compromisos adicionales de Gemini Enterprise Agent Platform, como las claves de encriptación administradas por el cliente (CMEK) y la residencia de datos, no se aplican a los datos mientras los procesa el proveedor de búsqueda externo. Si tu proyecto de consumidor está en un perímetro de VPC-SC, Vertex AI rechazará las solicitudes con el siguiente mensaje de error:

{
  "error": {
    "code": 400,
    "message": "The requested model does not serve requests restricted by VPCSC",
    "status": "FAILED_PRECONDITION"
  }
}

Esta función solo está disponible para Claude 4.0 y los modelos posteriores. No está disponible para los modelos de Claude más antiguos en Gemini Enterprise Agent Platform. La lista de servicios de búsqueda de terceros a los que puede llamar la función de búsqueda web de Anthropic si se usa la función de búsqueda web:

Precios

La búsqueda web tiene un precio como complemento del uso de la API de mensajes estándar, según el volumen de solicitudes web. Debido a las llamadas de muestreo adicionales, también se cobrará a los usuarios por los tokens de entrada adicionales.

Para obtener más información, consulta Precios.