Knowledge Base
Gestiona los documentos que guían a cada factoría y alimentan como contexto a los agentes durante los proyectos.
La Knowledge Base es el hub central de conocimiento de la plataforma. Desde aquí eliges una factoría y gestionas los documentos que la guían: políticas, estándares, ejemplos y reglas que el agente consulta como contexto cuando trabaja en un proyecto. Cada documento se indexa para poder recuperarlo de forma relevante durante las fases.
Encontrarás este módulo en el menú lateral, sección Análisis → Knowledge Base.
No la confundas con la Base de Conocimiento del Centro de Ayuda: aquella contiene artículos de ayuda para personas; esta contiene el conocimiento que consultan los agentes al trabajar.
Qué puedes hacer aquí
Elegir una factoría
El hub lista las factorías; entra a la base de conocimiento de cada una.
Añadir documentos
Escribe en Markdown o sube archivos, y clasifícalos por tipo.
Seguir la indexación
Consulta el estado de cada documento y qué significa.
Versionar y depurar
Revisa el historial, restaura versiones y re-indexa o elimina documentos.
Un recorrido por el hub
La pantalla de entrada muestra el título Knowledge Base y el texto «Selecciona una factoría para gestionar sus documentos de conocimiento». Debajo aparecen las factorías como tarjetas (nombre y dominio). Al elegir una, entras a su Base de conocimiento.
Si aún no hay factorías, verás «No hay factorías disponibles. Crea una factoría primero.»
Un recorrido por la base de conocimiento de una factoría
Encabezado y accesos
El título es Base de conocimiento con el nombre de la factoría y «Gestiona los documentos que guían al agente». A la derecha:
| Botón | Qué hace |
|---|---|
| Añadir documento | Abre el editor para crear un documento nuevo. |
| Herramientas MCP → | Gestiona las herramientas externas conectadas a la factoría. |
| Fuentes Azure Search → | Configura fuentes de búsqueda externas. |
Resumen (estadísticas)
Una fila de tarjetas muestra Total documentos, Alta confianza, Con problemas (resaltado si hay alguno) y Espacio usado.
Búsqueda y filtros
- Buscar documentos... filtra por nombre.
- Selector Tipo para acotar por tipo de documento.
- Selector Estado para acotar por estado de indexación.
Tabla de documentos
Cada fila muestra Nombre, Tipo, Cargado, Tamaño, Estado (badge de indexación), Último uso y un menú de acciones con Editar documento, Re-indexar, Ver historial y Eliminar.
Si no hay documentos verás «No hay documentos de conocimiento» y el botón Añadir documento; con filtros sin coincidencias, «Sin resultados» y Limpiar filtros.
Historial de versiones
Ver historial abre un panel lateral con cada versión (número, fecha, nota de cambio y vista previa). La versión vigente se marca Versión actual; en cualquier otra puedes pulsar Restaurar versión N para volver a ese contenido (el contenido actual se conserva en el historial).
Añadir o editar un documento
El editor tiene dos modos, que eliges con el conmutador Escribir texto / Subir archivo:
- Escribir texto: redactas el contenido directamente en un editor Markdown, con contador de caracteres y palabras.
- Subir archivo: arrastras o seleccionas un archivo. El texto de la zona indica «Arrastra el archivo aquí o haz clic para seleccionar» y los formatos admitidos.
Antes de guardar, asigna un nombre y selecciona el tipo de documento.
Durante una re-indexación, «el agente seguirá usando el índice anterior hasta que finalice». No se queda sin contexto mientras el documento se re-procesa.
Tipos de documento
Al clasificar un documento eliges uno de estos tipos: ADR, Política, DDR, Few-Shot, Path Rule, Rúbrica, Escalación y Estándar.
Formatos soportados
Desde el editor de la Knowledge Base puedes escribir en Markdown o subir PDF, DOCX, Markdown o TXT (máx. 50 MB).
Cuando construyes una factoría, el paso de documentos admite un conjunto más amplio: PDF, DOCX, XLSX, MD, TXT, JSON, PNG, JPG (máx. 50 MB), es decir, también hojas de cálculo, JSON e imágenes. En ese paso puedes subir nuevos documentos o vincular documentos existentes de la plataforma. Consulta Construir factorías.
Las imágenes (PNG, JPG) se almacenan como referencia, pero su estado es «Almacenado — sin indexación»: no se extrae texto de ellas para búsqueda. Los documentos con tablas o imágenes embebidas pueden quedar en estado Parcial (solo se indexa el texto visible).
Estados de indexación
El estado de cada documento indica cómo quedó tras procesarlo:
| Estado | Qué significa |
|---|---|
| Pendiente | El documento está en cola para ser analizado. |
| Analizando documento... | Se está analizando el contenido del documento. |
| Re-indexando... | Se está re-procesando con nueva configuración. |
| Alta confianza | Indexado correctamente con alta confianza. |
| Parcial — solo texto visible | Solo se indexó el texto visible; puede haber contenido omitido (tablas, imágenes). |
| Baja confianza | La indexación fue exitosa pero con baja confianza; conviene revisar el contenido. |
| Error al indexar | Ocurrió un error; usa Re-indexar para reintentar. |
| Almacenado — sin indexación | Imagen almacenada sin indexación de texto. |
| No aplica | El documento no requiere indexación. |
Los estados en proceso (Pendiente, Analizando, Re-indexando) se actualizan solos en tiempo real hasta llegar a un estado final.
Cómo alimenta el conocimiento a factorías y agentes
La base de conocimiento es por factoría: los documentos que subes a una factoría son los que su agente consulta. Durante un proyecto, cuando una fase se ejecuta con esa factoría, el agente recupera los documentos relevantes como contexto para producir su trabajo. Por eso el Mensaje de arranque de una fase con inicio automático influye en qué documentos se recuperan: un texto concreto orienta mejor la búsqueda que uno genérico.
Permisos
| Permiso (etiqueta en la interfaz) | Qué habilita en este módulo |
|---|---|
| Construir factorías | Ver la entrada Knowledge Base en el menú y acceder al hub y a la base de conocimiento de cada factoría. |
Lo que no tienes permitido no aparece en la interfaz: no se muestra deshabilitado, simplemente no está. Si no ves Knowledge Base en el menú, tu rol no incluye el permiso Construir factorías.
Relación con otros módulos
- Factorías: la Knowledge Base es la memoria de cada factoría. Aprende a crearlas y a poblar su conocimiento en Construir factorías y consúltalas en Factorías.
- Proyectos y fases: el conocimiento de una factoría alimenta a los agentes durante las fases de un proyecto.