WeKnora
Framework open source de Tencent que combina RAG consultable, ReAct Agent, MCP, Auto-Wiki y mantenimiento de conocimiento a largo plazo. Distribuye el sistema en Quick Q&A, ReAct Agent y Wiki Mode para encontrar, usar y organizar conocimiento. Despliegue privado, RBAC, auditoria y observabilidad.
Indice de contenidos
WeKnora: análisis a fondo, ¿merece la pena utilizar esta base de conocimiento RAG de código abierto?
Si solo necesitas «subir unos cuantos PDF y hacer preguntas», WeKnora quizá no sea la opción más necesaria. Pero si quieres construir una plataforma de conocimiento con IA capaz de consultar información empresarial, utilizar herramientas, realizar razonamientos de varios pasos y convertir progresivamente documentos sin estructurar en una base de conocimiento mantenible, WeKnora, el proyecto de código abierto de Tencent, merece una atención seria.
Su principal diferencia no está en que el propio RAG sea especialmente novedoso, sino en que intenta reunir RAG, ReAct Agent, MCP, Auto-Wiki y mantenimiento de conocimiento a largo plazo dentro de un mismo framework de código abierto. Actualmente, el proyecto se presenta como un framework de conocimiento que combina RAG consultable, Agents con razonamiento autónomo y una Wiki capaz de mantenerse a sí misma.
Por eso, WeKnora intenta responder a una pregunta más amplia que simplemente «¿cómo construir un sistema RAG?»:
Una vez que los documentos entran en una base de conocimiento, ¿pueden dejar de ser simples datos recuperables y convertirse progresivamente en activos de conocimiento que la IA pueda utilizar, razonar y mantener?
¿Qué problema intenta resolver realmente WeKnora?
La lógica básica de un RAG tradicional es bastante sencilla:
Documento → Chunk → Embedding → Recuperación → Respuesta del LLM.
Este modelo funciona muy bien para preguntas como «¿cuál es la política de gastos de la empresa?» o «¿cómo se configura este producto según su documentación?».
El problema aparece cuando las preguntas se vuelven más complejas.
Una misma tarea puede requerir consultar varios documentos, determinar qué información falta, utilizar herramientas externas e incluso acceder a Internet. Simplemente introducir más Chunks en el contexto no resuelve necesariamente estos problemas.
Por eso, WeKnora divide el sistema en tres niveles:
Quick Q&A se encarga del RAG tradicional.
ReAct Agent gestiona tareas complejas y puede coordinar la recuperación de conocimiento, MCP, Web Search, Skills y Sandboxes.
Wiki Mode va un paso más allá e intenta transformar los materiales originales en una base de conocimiento Markdown estructurada y conectada mediante enlaces.
Estos tres niveles corresponden, en realidad, a tres etapas de un sistema de conocimiento:
encontrar conocimiento → utilizar conocimiento → organizar conocimiento.
Esto resulta más interesante que limitarse a añadir unos cuantos adaptadores para bases de datos vectoriales.
¿Aporta una innovación importante en RAG?
Si nos fijamos únicamente en el RAG subyacente, WeKnora no ha creado un paradigma de recuperación completamente diferente.
Utiliza una combinación de técnicas bastante maduras: Chunking configurable, búsqueda vectorial, palabras clave/BM25, fusión RRF, Rerank, reescritura de consultas y, de forma opcional, Knowledge Graph y navegación mediante Wiki. La documentación oficial también ofrece herramientas para depurar el Chunking y consultar la estrategia utilizada, la distribución de Chunks y el resultado concreto de la segmentación.
Lo realmente destacable es que no reduce el problema de calidad del RAG a «utilizar un modelo de Embedding más potente».
Los propios Chunks pueden editarse y revertirse, los resultados de recuperación pueden rastrearse, las respuestas pueden mostrar citas y el RAG Pipeline puede observarse mediante Langfuse para analizar las llamadas de recuperación, Rerank y modelos.
Esto indica que WeKnora concibe la base de conocimiento como una cadena completa de procesamiento de datos, no simplemente como una combinación de «base de datos vectorial + Chat UI».
Sin embargo, esto tampoco permite afirmar directamente que su RAG sea más preciso.
Actualmente no existen suficientes datos públicos procedentes de un benchmark unificado que demuestren que la calidad general de recuperación de WeKnora sea claramente superior a la de otros frameworks RAG maduros. Incluso en los Issues recientes del proyecto siguen apareciendo problemas concretos de recuperación, como la deduplicación de Chunks después del Rerank.
Por tanto, la valoración del RAG debería ser:
su nivel de ingeniería merece atención, pero todavía no existen benchmarks públicos suficientes que demuestren que sea claramente más preciso.
El verdadero cambio está en pasar de RAG a Agent
La parte más interesante de WeKnora es probablemente su ReAct Agent.
Un RAG convencional funciona así:
Pregunta → buscar en la base de conocimiento → respuesta del LLM.
Un Agent de WeKnora puede funcionar así:
Analizar la tarea → determinar qué información necesita → buscar en la base de conocimiento → utilizar herramientas → buscar en la Web → realizar varias rondas de razonamiento → generar el resultado.
El Agent integrado oficialmente ya distingue entre los modos Quick Answer y Smart Reasoning. Este último se basa en ReAct y admite razonamiento de varios pasos y uso de herramientas.
Esto significa que la base de conocimiento deja de ser simplemente una «base de respuestas» y se convierte en una herramienta de conocimiento para el Agent.
Por ejemplo:
«Basándote en la documentación de los productos de la empresa y en información reciente del mercado, analiza por qué han aumentado las quejas sobre determinado producto y propone tres mejoras».
Con un RAG tradicional tendrías que diseñar un flujo de recuperación relativamente complejo.
Un Agent puede decidir por sí mismo consultar primero la documentación interna, utilizar después Web Search y volver a consultar la base de conocimiento para completar el análisis.
Por supuesto, los Agents no solo aportan más capacidades.
También implican más llamadas a modelos, un mayor coste en Tokens, más posibilidades de que fallen las herramientas y rutas de ejecución más difíciles de predecir.
Por eso, el Agent de WeKnora no debe entenderse como una mejora «incondicional» del RAG, sino como un modo de trabajo más potente y también más complejo para tareas que requieren razonamiento adicional.
Auto-Wiki es probablemente la dirección que más merece observarse
Si tuviera que elegir una de las tres capacidades principales de WeKnora para seguir de cerca, sería Wiki Mode.
La estructura tradicional de una base de conocimiento es:
Document → Chunk → Vector.
Wiki Mode intenta transformarla en:
Document → Knowledge → Wiki Page → Links → Knowledge Graph.
El Agent genera páginas Wiki estructuradas en Markdown a partir de los materiales originales y establece enlaces entre ellas y un Knowledge Graph. La versión actual también permite edición manual, historial de versiones y rollback.
Este cambio es importante.
Los Chunks son muy adecuados para la recuperación automática, pero no necesariamente para que una persona comprenda la información.
Una Wiki bien estructurada y conectada mediante enlaces puede servir tanto a las personas como a los Agents.
Por eso, Auto-Wiki puede entenderse como un intento de transformar:
la capa de recuperación del RAG → en una capa de organización del conocimiento.
Pero también existen riesgos claros.
Si el Agent interpreta mal la información cuando crea la Wiki por primera vez, ese error podría incorporarse directamente al conocimiento estructurado. Y si los documentos originales cambian, también surge la cuestión de si la Wiki se actualizará correctamente y a tiempo.
Por eso, Auto-Wiki no significa «la IA organiza todo y ya no hay que supervisarlo».
Una interpretación más razonable sería:
la IA se encarga de organizar el conocimiento; las personas mantienen la gobernanza final.
WeKnora ya ofrece historial de versiones, Diff y rollback para las Wiki, algo que precisamente proporciona mecanismos de gobernanza necesarios cuando el conocimiento es generado o transformado por IA.
¿Es realmente WeKnora una solución «enterprise»?
El alcance funcional actual de WeKnora supera claramente el de una simple Demo personal.
Admite múltiples fuentes de datos, más de diez formatos de documentos y múltiples proveedores de modelos. También permite sustituir el LLM, Embedding, Rerank, Vector Store y Storage. Además, ofrece REST API, MCP Server, CLI, RBAC, registros de auditoría, OIDC y observabilidad mediante Langfuse.
La versión v0.8.0 incorporó además Sandboxes por sesión basados en Docker/E2B/Cube, políticas de red, Skills Catalog y memoria a largo plazo entre sesiones.
El valor de todo esto no está en que «la lista de funciones sea muy larga».
Lo que realmente necesitan las empresas es:
¿Pueden los datos permanecer dentro de su propio entorno?
¿Pueden distintos usuarios acceder a diferentes conocimientos?
¿Se puede rastrear qué herramientas ha utilizado un Agent?
¿Se pueden sustituir los modelos?
¿Se puede mantener el conocimiento cuando los documentos se actualizan?
¿Existe aislamiento cuando el Agent ejecuta código?
WeKnora ya está empezando a abordar todas estas cuestiones.
Pero hay una distinción importante:
tener muchas funciones ≠ estar maduro para producción.
El proyecto continúa evolucionando rápidamente y en los Changelogs recientes todavía aparecen numerosas correcciones y mejoras relacionadas con recuperación, Chunk, Rerank, Wiki y Sandbox.
Por eso, una descripción más precisa sería:
WeKnora ya apunta hacia una arquitectura de plataforma empresarial de conocimiento, pero su idoneidad para entornos de producción críticos debería evaluarse mediante un PoC completo adaptado a cada caso de uso.
¿En qué se diferencia de una base de conocimiento RAG convencional?
| Aspecto | RAG tradicional | WeKnora |
|---|---|---|
| Preguntas y respuestas básicas | Capacidad principal | Capacidad principal |
| Recuperación híbrida | Parcial según el producto | Sí |
| Agent | Normalmente requiere integración adicional | ReAct integrado |
| MCP | Depende del producto | Sí |
| Web Search | Depende del producto | Orquestable desde el Agent |
| Auto-Wiki | Normalmente no es una función central | Dirección principal |
| Knowledge Graph | Disponible en algunos productos | Opcional |
| Memoria a largo plazo | Normalmente no es una función central | Compatible actualmente |
| Sandbox | Poco habitual | Docker/E2B/Cube |
| Despliegue privado | Depende del producto | Forma de despliegue central |
| Permisos empresariales | Depende del producto | RBAC, auditoría, etc. |
Por tanto, la diferencia entre WeKnora y un RAG tradicional no es:
«Tengo algunas funciones de recuperación más que tú».
El límite del producto ha cambiado.
WeKnora intenta evolucionar desde:
Knowledge Base
hacia:
Knowledge Infrastructure for AI Agents.
Principales ventajas y problemas
Lo realmente valioso
Primero, RAG, Agent y mantenimiento del conocimiento no están separados.
Esto facilita construir aplicaciones de conocimiento complejas dentro de un mismo sistema.
Segundo, el conocimiento puede gestionarse y gobernarse.
Tanto los Chunks como las Wiki van incorporando capacidades de edición, versionado y rollback, en lugar de quedar fuera de control después de ser generados.
Tercero, la integración con Agents es bastante profunda.
No se limita a proporcionar un Agent: también incorpora MCP, Skills, Sandbox y CLI, además de un contrato CLI/JSON estable orientado a aplicaciones basadas en AI Agents.
Aspectos que conviene tener en cuenta
Su mayor problema es, paradójicamente, también una de sus mayores ventajas:
tiene demasiadas cosas.
Cuando un proyecto incorpora al mismo tiempo RAG, Agent, Wiki, Graph, MCP, Memory, Sandbox, Web Search, CLI, RBAC, IM, Widget y muchas otras funciones...
deja de ser un simple servicio RAG.
El despliegue, la configuración, la selección de modelos, el mantenimiento de las fuentes de datos y las operaciones del sistema se vuelven más complejos.
Si solo quieres:
«Subir 20 PDF y hacer preguntas».
WeKnora probablemente sea una solución con muchas más capacidades de las que realmente necesitas.
Pero si quieres construir un sistema de conocimiento basado en IA que pueda seguir ampliándose, esa complejidad puede resultar útil.
¿Para quién es más adecuado WeKnora?
Adecuado para:
- Desarrolladores que quieren desplegar su propio RAG de código abierto
- Equipos con grandes cantidades de documentación interna
- Usuarios que quieren combinar RAG y Agents
- Empresas que necesitan una plataforma de conocimiento con IA desplegada de forma privada
- Equipos que quieren desarrollar aplicaciones de AI Agents sobre una base de conocimiento
No necesariamente adecuado para:
- Usuarios que solo quieren hacer preguntas sencillas sobre PDF
- Personas que no quieren mantener Docker, modelos y bases de datos
- Proyectos pequeños que no necesitan Agent, Wiki ni MCP
Valoración final: lo más interesante es la combinación de Agent + Wiki
Si evaluamos únicamente el RAG, WeKnora es un framework RAG de código abierto con un nivel de ingeniería elevado y un conjunto de componentes bastante completo, pero actualmente no existen suficientes datos públicos que demuestren una ventaja clara en precisión de recuperación.
Si evaluamos RAG + Agent, su propuesta resulta bastante más interesante: la base de conocimiento deja de limitarse a responder preguntas y se convierte en una herramienta que el Agent puede consultar repetidamente.
Pero cuando hablamos de RAG + Agent + Auto-Wiki, aparece la dirección que probablemente más merece la pena seguir de cerca.
WeKnora está intentando resolver un problema más amplio y de más largo plazo:
Una base de conocimiento no debería limitarse a almacenar documentos. Debería convertirse en un sistema de conocimiento que la IA pueda consultar, utilizar para razonar, invocar, organizar y mantener de forma continua.
Valoración general: 4,5/5,0
La puntuación no se debe simplemente a que WeKnora tenga muchas funciones, sino a que existe una lógica de producto bastante clara entre sus principales capacidades:
RAG se encarga de obtener conocimiento, Agent se encarga de utilizarlo y Wiki se encarga de organizarlo y mantenerlo.
Lo que queda por comprobar es si, cuando estas capacidades se utilicen en entornos de producción reales, pueden mantener un funcionamiento estable, controlable, trazable y con un coste de mantenimiento bajo.
Si solo necesitas RAG, no necesariamente necesitas WeKnora.
Si necesitas RAG + Agent, empieza a resultar una opción interesante.
Y si el objetivo es construir una infraestructura empresarial de conocimiento con IA capaz de evolucionar a largo plazo, WeKnora ya es un proyecto de código abierto que merece la pena estudiar seriamente.
Lo que hace WeKnora
- RAG híbrido con busqueda vectorial, BM25, RRF, Rerank y reescritura de consultas
- ReAct Agent con modo Quick Answer y Smart Reasoning
- Uso de herramientas, MCP, Web Search, Skills y Sandboxes
- Wiki Mode / Auto-Wiki que genera paginas Markdown enlazadas y Knowledge Graph
- Edicion, historial de versiones y rollback para Chunks y Wiki
- REST API, MCP Server, CLI y RBAC con registros de auditoria
- Observabilidad mediante Langfuse y respuestas con citas
- Memoria a largo plazo y Sandboxes por sesion basados en Docker/E2B/Cube
- Permite sustituir LLM, Embedding, Rerank, Vector Store y Storage