- Claude Opus 4.1 (
claude-opus-4-1-20250805) - Claude Opus 4 (
claude-opus-4-20250514) - Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) - Claude Sonnet 4 (
claude-sonnet-4-20250514) - Claude Sonnet 3.7 (deprecado) (
claude-3-7-sonnet-20250219) - Claude 3.5 Haiku (
claude-3-5-haiku-20241022)
Beneficios clave
- Citas naturales - Logra la misma calidad de citas que la búsqueda web para cualquier contenido
- Integración flexible - Úsalo en devoluciones de herramientas para RAG dinámico o como contenido de nivel superior para datos pre-obtenidos
- Atribución de fuente adecuada - Cada resultado incluye información de fuente y título para una atribución clara
- Sin necesidad de soluciones alternativas de documentos - Elimina la necesidad de soluciones alternativas basadas en documentos
- Formato de cita consistente - Coincide con la calidad y formato de cita de la funcionalidad de búsqueda web de Claude
Cómo funciona
Los resultados de búsqueda se pueden proporcionar de dos formas:- Desde llamadas de herramientas - Tus herramientas personalizadas devuelven resultados de búsqueda, habilitando aplicaciones RAG dinámicas
- Como contenido de nivel superior - Proporcionas resultados de búsqueda directamente en mensajes de usuario para contenido pre-obtenido o almacenado en caché
Esquema de resultado de búsqueda
Los resultados de búsqueda utilizan la siguiente estructura:Campos requeridos
| Campo | Tipo | Descripción |
|---|---|---|
type | string | Debe ser "search_result" |
source | string | La URL de fuente o identificador del contenido |
title | string | Un título descriptivo para el resultado de búsqueda |
content | array | Un array de bloques de texto que contienen el contenido real |
Campos opcionales
| Campo | Tipo | Descripción |
|---|---|---|
citations | object | Configuración de citas con campo booleano enabled |
cache_control | object | Configuración de control de caché (p. ej., {"type": "ephemeral"}) |
content debe ser un bloque de texto con:
type: Debe ser"text"text: El contenido de texto real (string no vacío)
Método 1: Resultados de búsqueda desde llamadas de herramientas
El caso de uso más poderoso es devolver resultados de búsqueda desde tus herramientas personalizadas. Esto habilita aplicaciones RAG dinámicas donde las herramientas obtienen y devuelven contenido relevante con citas automáticas.Ejemplo: Herramienta de base de conocimientos
Método 2: Resultados de búsqueda como contenido de nivel superior
También puedes proporcionar resultados de búsqueda directamente en mensajes de usuario. Esto es útil para:- Contenido pre-obtenido de tu infraestructura de búsqueda
- Resultados de búsqueda almacenados en caché de consultas anteriores
- Contenido de servicios de búsqueda externos
- Pruebas y desarrollo
Ejemplo: Resultados de búsqueda directos
Respuesta de Claude con citas
Independientemente de cómo se proporcionen los resultados de búsqueda, Claude incluye automáticamente citas cuando utiliza información de ellos:Campos de cita
Cada cita incluye:| Campo | Tipo | Descripción |
|---|---|---|
type | string | Siempre "search_result_location" para citas de resultados de búsqueda |
source | string | La fuente del resultado de búsqueda original |
title | string o null | El título del resultado de búsqueda original |
cited_text | string | El texto exacto siendo citado |
search_result_index | integer | Índice del resultado de búsqueda (basado en 0) |
start_block_index | integer | Posición inicial en el array de contenido |
end_block_index | integer | Posición final en el array de contenido |
search_result_index se refiere al índice del bloque de contenido del resultado de búsqueda (basado en 0), independientemente de cómo se proporcionaron los resultados de búsqueda (llamada de herramienta o contenido de nivel superior).
Múltiples bloques de contenido
Los resultados de búsqueda pueden contener múltiples bloques de texto en el arraycontent:
start_block_index y end_block_index.
Uso avanzado
Combinando ambos métodos
Puedes usar tanto resultados de búsqueda basados en herramientas como de nivel superior en la misma conversación:Combinando con otros tipos de contenido
Ambos métodos admiten mezclar resultados de búsqueda con otro contenido:Control de caché
Agrega control de caché para mejor rendimiento:Control de citas
Por defecto, las citas están deshabilitadas para resultados de búsqueda. Puedes habilitar citas estableciendo explícitamente la configuracióncitations:
citations.enabled se establece en true, Claude incluirá referencias de citas cuando use información del resultado de búsqueda. Esto habilita:
- Citas naturales para tus aplicaciones RAG personalizadas
- Atribución de fuente cuando se interfaciona con bases de conocimiento propietarias
- Citas de calidad de búsqueda web para cualquier herramienta personalizada que devuelva resultados de búsqueda
citations se omite, las citas están deshabilitadas por defecto.
Las citas son todo o nada: o todos los resultados de búsqueda en una solicitud deben tener citas habilitadas, o todos deben tenerlas deshabilitadas. Mezclar resultados de búsqueda con diferentes configuraciones de citas resultará en un error. Si necesitas deshabilitar citas para algunas fuentes, debes deshabilitarlas para todos los resultados de búsqueda en esa solicitud.
Mejores prácticas
Para búsqueda basada en herramientas (Método 1)
- Contenido dinámico: Úsalo para búsquedas en tiempo real y aplicaciones RAG dinámicas
- Manejo de errores: Devuelve mensajes apropiados cuando las búsquedas fallan
- Límites de resultados: Devuelve solo los resultados más relevantes para evitar desbordamiento de contexto
Para búsqueda de nivel superior (Método 2)
- Contenido pre-obtenido: Úsalo cuando ya tienes resultados de búsqueda
- Procesamiento por lotes: Ideal para procesar múltiples resultados de búsqueda a la vez
- Pruebas: Excelente para probar el comportamiento de citas con contenido conocido
Mejores prácticas generales
-
Estructura los resultados efectivamente
- Usa URLs de fuente claras y permanentes
- Proporciona títulos descriptivos
- Divide el contenido largo en bloques de texto lógicos
-
Mantén consistencia
- Usa formatos de fuente consistentes en tu aplicación
- Asegúrate de que los títulos reflejen con precisión el contenido
- Mantén el formato consistente
-
Maneja errores elegantemente
Limitaciones
- Los bloques de contenido de resultados de búsqueda están disponibles en Claude API y en Vertex AI de Google Cloud
- Solo se admite contenido de texto dentro de resultados de búsqueda (sin imágenes u otros medios)
- El array
contentdebe contener al menos un bloque de texto