WeKnora: respuestas sustentadas, memoria acotada y operación consciente
Arquitectura RAG de WeKnora: eventos, estado intermedio y entrega reanudable
Sigue el pipeline documentado sin confundir etapas completadas, entrega SSE y calidad de la evidencia.
Qué aprenderás
- El pipeline depende de la petición
- Conserva los resultados intermedios
- Streaming es una capa de entrega
Antes de empezar
- Conceptos básicos de HTTP y contenedores
- Documentos, pasajes y proveedores de modelos
Separar ingesta, recuperación, respaldo y alcance de memoria para diseñar aceptación basada en evidencia.
Conclusiones clave
- Las capacidades de la petición eligen etapas.
- Recuperación, rerank y contexto son puntos distintos.
- Reanudar salida no prueba acciones externas exactamente una vez.
El pipeline depende de la petición
La guía describe plugins registrados por tipo de evento. Sin bases ni búsqueda web, una petición puede seguir chat directo; RAG añade comprensión, recuperación paralela, rerank, fusión, límite top-k y contexto antes de generar. Las capacidades de la petición determinan las etapas opcionales.
Dentro del mismo evento, el registro determina la cadena anidada de next. Un plugin puede actuar antes o después de invocarlo. Una lista plana de nombres no basta para deducir toda la secuencia; la guía explica específicamente la ponderación de Wiki respecto al rerank.
Conserva los resultados intermedios
ChatManage separa configuración, estado del pipeline y referencias de ejecución. SearchResult, RerankResult y MergeResult son puntos distintos de diagnóstico. Ayudan a distinguir ausencia de candidatos, mal orden, contexto perdido y generación sin respaldo; no son copias equivalentes de una respuesta final.
La guía describe clonación para recuperación paralela sin copiar el contexto de ejecución. Eso es una explicación de diseño, no una prueba de concurrencia realizada aquí. Asimismo, el fallback sin resultados puede producir texto del modelo, que no debe presentarse como evidencia documental por aparecer en el mismo chat.
Streaming es una capa de entrega
Los resultados pasan por un bus por petición, manejador y gestor de streams antes de SSE. La documentación contempla memoria o Redis y continuación al reconectar. Varias réplicas aún requieren coordinación compartida adecuada; reanudar salida no garantiza efectos externos exactamente una vez.
Cancelar y no encontrar resultados necesitan desenlaces diferentes. La guía sitúa la cancelación antes del fallback y publica referencias antes del streaming final. Separa progreso, fuentes y aceptación al diagnosticar. No probamos reconexión ni ejecución multirréplica.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Mapea las etapas habilitadas.
- 2
Inspecciona resultados intermedios.
- 3
Sigue referencias y respuesta por separado.
- 4
Prueba cancelación y reconexión en un entorno controlado.
Ejemplo para copiar
{
"pipeline": true,
"resultadoBusqueda": null,
"resultadoRerank": null,
"contextoFusionado": null,
"entregaReanudada": null,
"afirmacionSustentada": null,
"pruebaDistribuida": false
}Preguntas frecuentes
¿Toda petición recorre las mismas etapas?
No. El constructor documentado las ensambla según la petición.
¿Reconectar SSE demuestra una respuesta correcta?
No. Continuidad de entrega y calidad de evidencia son propiedades distintas.
Fuentes
- WeKnora / website-docs/02-architecture/04-rag-pipeline.mdFuente verificada 2026-09-14
- WeKnora / README.mdFuente verificada 2026-09-14