Cargando

La herramienta de búsqueda web

Lección 337 min
Cargando

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

Nuestro servidor pregunta sobre los últimos avances 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 obligatorios:

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 según los resultados iniciales, así que esto evita llamadas excesivas a la API.

Cómo funciona

Cuando incluyes el esquema de búsqueda web en tu lista de herramientas, Claude decidirá automáticamente cuándo buscar según tu pregunta. Por ejemplo, preguntar "¿Cuál es el mejor ejercicio para ganar músculo en las piernas?" podría activar una búsqueda de investigación actual sobre fitness.

La respuesta contiene varios tipos de bloques:

  • TextBlock: 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 de búsqueda individuales con títulos y URLs
  • CitationsWebSearchResultLocation: citas de texto específicas que respaldan las afirmaciones de Claude

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 autorizadas:

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

Esto garantiza que Claude solo busque en dominios confiables, como sitios gubernamentales de salud, en lugar de blogs de fitness aleatorios con información potencialmente poco fiable.

Renderizado de los resultados de búsqueda

La estructura de la respuesta está diseñada para un renderizado de interfaz de usuario enriquecido. Normalmente:

  • Muestras los bloques de texto como contenido regular
  • Muestras los resultados de búsqueda web como una lista de referencias en la parte superior
  • Renderizas las citas en línea con enlaces de vuelta al material de origen
  • Resaltas el texto citado para mostrar cómo Claude respalda sus afirmaciones

Esto crea una experiencia transparente en la que los usuarios pueden verificar las fuentes de Claude y entender cómo llegó a sus conclusiones. El sistema de citas ayuda a generar confianza al mostrar la evidencia detrás de las respuestas de Claude.