Cargando

La herramienta de búsqueda web

Lección 317 min

Nota importante: Tu organización debe habilitar la herramienta de búsqueda web en la consola de configuración antes de usarla. Puedes encontrar esta opción aquí: https://platform.claude.com/settings/capabilities

Cargando

Claude incluye una herramienta de búsqueda web integrada que le permite buscar en internet información actual o especializada para responder preguntas de los usuarios. A diferencia de otras herramientas donde necesitas proporcionar la implementación, Claude gestiona todo el proceso de búsqueda automáticamente: solo necesitas proporcionar un esquema simple para habilitarla.

Nuestro servidor pregunta sobre los últimos desarrollos en computación cuántica, luego Claude busca en la web y responde a partir de tres resultados.

Configuración de la herramienta de búsqueda web

Para usar la herramienta de búsqueda web, creas un objeto de esquema con estos campos requeridos:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search", 
    "max_uses": 5
}

El campo max_uses limita cuántas búsquedas puede realizar Claude. Claude podría hacer búsquedas de seguimiento basadas en los resultados iniciales, por lo que esto evita llamadas excesivas a la API. Una sola búsqueda devuelve múltiples resultados, pero Claude puede decidir que son necesarias búsquedas adicionales.

Cómo funciona la respuesta

Cuando Claude usa la herramienta de búsqueda web, la respuesta contiene varios tipos de bloques:

  • Bloques de texto - La explicación de Claude sobre lo que está haciendo
  • ServerToolUseBlock - Muestra la consulta de búsqueda exacta que usó Claude
  • WebSearchToolResultBlock - Contiene los resultados de la búsqueda
  • WebSearchResultBlock - Resultados individuales de búsqueda con títulos y URLs
  • Bloques de citas - Texto que respalda las afirmaciones de Claude

Bloques de respuesta con la consulta de Claude "best exercises building leg muscle strength scientific research" y un resultado de nih.gov.

La estructura de la respuesta te permite ver exactamente qué buscó Claude y qué fuentes encontró. Las citas incluyen el texto específico que Claude usó para respaldar sus respuestas, junto con las URLs de origen.

Restricción de dominios de búsqueda

Puedes limitar las búsquedas a dominios específicos usando el campo allowed_domains. Esto es particularmente útil cuando quieres fuentes confiables y autorizadas:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5,
    "allowed_domains": ["nih.gov"]
}

Por ejemplo, al preguntar sobre consejos médicos o de ejercicio, restringir a dominios como PubMed (nih.gov) garantiza que obtengas información basada en evidencia en lugar de contenido aleatorio de blogs.

Página de inicio de PubMed con un cuadro de búsqueda y una nota que indica que comprende más de 38 millones de citas de literatura biomédica.

Renderizado de resultados de búsqueda

Los diferentes tipos de bloques en la respuesta están diseñados para un renderizado de interfaz específico:

  • Renderiza los bloques de texto como contenido regular
  • Muestra los resultados de búsqueda web como una lista de fuentes en la parte superior
  • Muestra las citas en línea con el texto, incluyendo el dominio de origen, el título de la página, la URL y el texto citado

Seis tarjetas de origen de nih.gov en la parte superior, luego un párrafo de Introducción que termina en una cita en línea de ncbi.nlm.nih.gov.

Esta estructura ayuda a los usuarios a entender cómo Claude llegó a sus respuestas y proporciona transparencia sobre las fuentes que se están utilizando. El formato de las citas deja claro qué información específica proviene de qué fuentes, generando confianza en las respuestas de la IA.

Uso práctico

La herramienta de búsqueda web funciona mejor para:

  • Eventos actuales y desarrollos recientes
  • Información especializada que no está en los datos de entrenamiento de Claude
  • Verificación de hechos y búsqueda de fuentes autorizadas
  • Tareas de investigación que requieren información actualizada

Simplemente incluye el esquema en tu array de herramientas al hacer llamadas a la API, y Claude decidirá automáticamente cuándo una búsqueda web ayudaría a responder la pregunta del usuario.