Búsqueda híbrida
Un solo buscador que entiende tanto «SKU-88213» como «chaqueta ligera para correr»: los términos exactos conservan su precisión, las descripciones vagas se comparan por significado y ambas clasificaciones se funden en una lista. Pague solo por uso, sin suscripción.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
La búsqueda por palabra clave pura no capta las paráfrasis; la búsqueda semántica pura a veces no prioriza un número de parte exacto o un código de producto que debería reconocer al instante.
El compromiso que ninguno de los dos enfoques resuelve solo
La búsqueda por palabra clave es precisa con términos exactos —un SKU, un número de modelo, una cita legal— pero ciega ante la paráfrasis. La búsqueda semántica entiende la paráfrasis pero ocasionalmente ubica un concepto vagamente relacionado por encima de un documento que contiene el término literal que el usuario escribió, sobre todo si ese término es poco frecuente.
Ninguna debilidad es fatal por sí sola, pero un cuadro de búsqueda que solo hace una de las dos cosas tendrá un desempeño inferior en una parte real de las consultas, y casi nunca sabe de antemano qué tipo de consulta le harán.
Dónde la búsqueda híbrida supera a los dos métodos por separado
El comercio electrónico es el caso más claro: un comprador puede escribir un número de modelo exacto en un momento y 'zapatos impermeables para caminata' al siguiente, y ambos deben funcionar bien desde el mismo cuadro de búsqueda. La documentación, los tickets de soporte y la búsqueda empresarial sobre contenido mixto se benefician igual, porque las consultas reales mezclan términos exactos y descripciones sueltas y casi nunca anuncian de antemano cuál de las dos son.
Qué puede hacer con ella
Cuadro de búsqueda de comercio electrónico
La búsqueda de una tienda responde bien tanto a 'SKU-88213' como a 'chaqueta ligera para correr', desde el mismo campo de entrada y sin lógica separada para cada estilo de consulta.
Búsqueda en documentación técnica
Un portal para desarrolladores encuentra nombres exactos de funciones y códigos de error, además de problemas descritos de forma libre como 'por qué mi solicitud da timeout'.
Deduplicación de tickets de soporte
Una mesa de ayuda encuentra tickets previos que mencionan el mismo código de producto o describen el mismo problema con otras palabras, reduciendo el trabajo de investigación duplicado.
Búsqueda empresarial sobre contenido mixto
Una herramienta de búsqueda corporativa ordena correctamente números de contrato, identificadores de póliza y preguntas en lenguaje natural dentro del mismo índice, sin mantener dos sistemas de búsqueda separados.
Preguntas frecuentes
¿Qué es la búsqueda híbrida y en qué se diferencia de la búsqueda semántica sola?
La búsqueda híbrida combina coincidencia por palabra clave con ranking basado en significado en un solo conjunto de resultados fusionado, capturando tanto términos exactos como consultas parafraseadas que la búsqueda semántica pura a veces puede ubicar más abajo de lo debido.
¿La búsqueda híbrida es gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuándo debería usar búsqueda híbrida en vez de búsqueda semántica pura?
Úsela siempre que las consultas puedan incluir términos exactos como SKU, códigos o nombres junto con descripciones en lenguaje natural, que es el caso de la mayoría de los cuadros de búsqueda reales.
¿La búsqueda híbrida cuesta más que la búsqueda semántica sola?
No, el precio es la misma tarifa base más el cargo por consulta; ejecutar ambas señales en una sola llamada está incluido, no se factura como dos operaciones separadas.
¿Encuentra un código de producto exacto como SKU-88213?
Sí. Los términos exactos, como un código de producto, un número de modelo o una cita legal, reciben la precisión de la búsqueda por palabras clave, mientras que las frases vagas se resuelven por significado.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/search/hybrid \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"SKU-88213 chaqueta impermeable"}'const res = await fetch("https://api.kit.forhosting.com/search/hybrid", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "SKU-88213 chaqueta impermeable"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/hybrid",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"query": "SKU-88213 chaqueta impermeable"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/hybrid", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"query":"SKU-88213 chaqueta impermeable"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"query":"SKU-88213 chaqueta impermeable"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/hybrid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"query": "SKU-88213 chaqueta impermeable"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.hybrid",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_chunks | 10000 |
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Este endpoint ejecuta ambas en la misma llamada y fusiona los dos rankings en un solo conjunto de resultados, así una consulta obtiene precisión en términos exactos y comprensión conceptual a la vez.
Qué hace realmente la fusión
Un documento que puntúa bien en ambas señales sube al primer lugar; uno que solo puntúa bien en una igual aparece, solo más abajo, en vez de desaparecer como pasaría en un sistema de un solo método. Envía por POST una consulta y su conjunto de candidatos a /search/hybrid, y la tarea ejecuta en paralelo una coincidencia por palabras clave y otra por significado, y combina ambos rankings en un solo puntaje fusionado por documento, en lugar de obligarle a elegir un ganador o hacer dos llamadas separadas y fusionar los resultados por su cuenta.
Una idea consolidada en la recuperación de información
Combinar señales léxicas y vectoriales no es nuevo; los ingenieros de búsqueda usan técnicas de fusión de rankings desde hace años para mezclar listas de resultados puntuadas por separado en un solo orden que supera a cualquiera de las dos. Lo que cambió es que el ranking por significado antes requería infraestructura especializada que pocos equipos podían justificar construir, mientras la búsqueda por palabra clave lleva décadas siendo un commodity; este endpoint empaqueta la fusión de ambas en una sola llamada para que no opere dos sistemas y una las salidas usted mismo.
Precio y entrega
La facturación es una tarifa plana por solicitud más un cargo por consulta, la misma estructura sin importar si la consulta se inclina hacia palabras clave o es totalmente conceptual, sin cargo aparte por ejecutar ambas señales. La llamada es asíncrona: recibe un task_id de inmediato y el resultado fusionado llega mediante webhook firmado o un enlace firmado válido por 24 horas; las tareas fallidas reintentan hasta tres veces y nunca se cobran si siguen sin completarse.
Preguntas técnicas
¿Necesito configurar el peso entre las señales de palabra clave y vectoriales?
No, envía la consulta y los candidatos al endpoint y este se encarga de la fusión; no hay infraestructura aparte ni paso de ajuste requerido de su lado.
¿Cómo recibo los resultados?
El endpoint devuelve un task_id de inmediato y los resultados fusionados y ordenados llegan mediante webhook firmado o un enlace firmado válido por 24 horas.
¿La búsqueda híbrida soporta catálogos de productos o conjuntos de documentos grandes?
Sí, envía cada consulta como su propia solicitud asíncrona contra su conjunto de candidatos sin límite artificial en el volumen de solicitudes, facturado a la tarifa estándar por solicitud y por consulta.
¿Qué pasa si falla una solicitud de búsqueda híbrida?
La tarea reintenta automáticamente hasta tres veces, devuelve un error claro si sigue sin completarse, y una solicitud fallida nunca se cobra.