Reescribir consultas
Casi nadie escribe la consulta que realmente encontraría lo que busca, escribe la versión vaga que tiene en mente en ese momento. Este endpoint toma esa pregunta imprecisa y la reescribe en una forma más clara y buscable antes de que llegue a cualquier paso de búsqueda o recuperació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 brecha entre lo que la gente escribe y lo que quiere decir
Un visitante escribe 'por qué está lento' en un buscador, queriendo decir algo mucho más específico, el tiempo de carga de una página, la latencia de una base de datos, una función particular que va lenta, pero el índice de búsqueda no tiene forma de adivinar cuál. rag.query_rewrite se coloca justo frente a esa brecha: toma la pregunta poco definida y produce una versión con el contexto faltante completado o la ambigüedad reducida, para que lo que busque o recupere después tenga algo válido con qué emparejar.
Cómo se ve la solicitud
Envíe POST a /rag/query-rewrite con la pregunta original, y la tarea corre de forma asíncrona: recibe un task_id de inmediato, y la consulta reescrita llega después mediante una llamada de webhook firmada o un enlace firmado válido por 24 horas. La salida es una versión más clara y buscable de la misma pregunta, construida para alimentar directamente un índice de búsqueda o un paso de recuperación, no para que la lea una persona.
La expansión de consultas no es una idea nueva, pero sigue sin resolverse por defecto
Los investigadores de recuperación de información llevan décadas trabajando en el desajuste de vocabulario, el hecho de que las palabras de quien busca y las de un documento rara vez coinciden exactamente aunque signifiquen lo mismo, mediante técnicas como agregar sinónimos o términos relacionados antes de ejecutar la consulta. La mayoría de los buscadores todavía no incorporan nada de eso: ejecutan tal cual la cadena que el usuario escribió, razón por la cual tantas búsquedas no devuelven nada útil al primer intento. Reescribir la consulta antes de buscar ataca el desajuste en su origen, en vez de esperar que el índice lo compense.
Dónde encaja dentro de un flujo de recuperación
Este endpoint es un paso de preprocesamiento, no una respuesta final; está pensado para correr antes de una llamada de búsqueda, una respuesta con generación aumentada por recuperación, o cualquier sistema que necesite una consulta bien formada para funcionar bien. Como se cobra por solicitud más por consulta y corre de forma asíncrona, encaja sin fricción delante de un flujo más grande: un buscador reescribe la consulta primero y luego pasa la versión reescrita al sistema de búsqueda o recuperación que hace el emparejamiento real, todo sin una persona en el medio.
Qué mejora realmente al limpiar las consultas
Un sistema de recuperación bien construido puede seguir devolviendo resultados débiles si recibe un fragmento vago de tres palabras; entréguele una consulta clara y desambiguada y la misma lógica devuelve resultados notablemente más relevantes. Los equipos que agregan este paso delante de una búsqueda o un flujo RAG existente suelen corregir la calidad de la búsqueda sin tocar el sistema en sí, porque la corrección ocurre un paso antes, en la pregunta, no en el índice.
Qué puede hacer con ella
Limpieza de consultas en la búsqueda de un sitio
Un sitio de comercio electrónico reescribe una búsqueda vaga de producto como 'chaqueta abrigada barata' en una consulta más clara antes de ejecutarla contra el índice del catálogo.
Preprocesamiento para un flujo RAG
Una herramienta de soporte reescribe la pregunta poco específica de un visitante antes de pasarla a un paso de recuperación, mejorando qué pasajes se recuperan.
Limpieza de consultas en un asistente de voz
Una interfaz de voz reescribe una pregunta hablada y formulada de manera informal en una consulta de búsqueda bien formada antes de compararla con una base de conocimiento.
Resolución de contexto en un chat de varios turnos
Una aplicación de chat reescribe una pregunta de seguimiento breve como '¿y la otra?' en una consulta autocontenida y buscable usando el contexto previo.
Preguntas frecuentes
¿Cómo funciona la API para reescribir consultas?
Envíe por POST la pregunta original a /rag/query-rewrite, y reciba la versión reescrita y más buscable por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API de expansión de consultas?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.0135 por consulta, y una tarea fallida nunca se cobra.
¿Cuál es la diferencia entre reescribir y expandir una consulta?
Están estrechamente relacionadas; este endpoint aclara y reestructura la pregunta, lo cual a menudo incluye agregar términos relacionados, para que recupere mejor contra un índice de búsqueda o RAG.
¿Necesito esto si ya tengo un motor de búsqueda?
Con frecuencia sí, porque la mayoría de los índices de búsqueda emparejan la consulta tal como se escribió y no resuelven la ambigüedad por sí mismos; reescribir la consulta primero suele mejorar los resultados sin cambiar el sistema de búsqueda.
¿Puede usar el contexto de una conversación previa?
Sí, si usted proporciona los turnos anteriores como contexto, puede resolver una pregunta de seguimiento vaga en una consulta autocontenida y buscable.
¿Puedo procesar un lote grande de consultas?
Sí, envíe una tarea asíncrona por consulta y reciba las versiones reescritas por webhook a medida que cada una termine.
¿Ya está disponible este endpoint?
Sí, /rag/query-rewrite está en vivo y aceptando tráfico de producción en este momento.
¿Se guardan los datos de mi consulta después?
No, las consultas enviadas y los resultados se eliminan después del período de retención y nunca se usan para entrenamiento.
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, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/rag/query-rewrite \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/rag/query-rewrite", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/rag/query-rewrite",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/rag/query-rewrite", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/rag/query-rewrite", 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
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "rag.query_rewrite",
"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. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |