🖥️ Conocimiento IA
Objetivo Principal: Comprobar qué documentación encuentra el copiloto cuando responde y ampliarla subiendo documentos propios, para que los perfiles de administración controlen de qué material se alimentan sus respuestas.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
Se llega desde la pestaña "Conocimiento IA" de la barra de pestañas de Cuenta. La pestaña solo aparece —y la página solo se abre— para los perfiles Administrador y Admin Global.
La pantalla, titulada “Fuentes del conocimiento”, reúne dos herramientas independientes: "Buscar en las fuentes", siempre disponible para esos perfiles, y "Anadir fuente", que depende de un interruptor de activación de la instalación.
El bloque “Anadir fuente” solo muestra el formulario si la subida de documentos está habilitada en tu instalación. Si no lo está, en su lugar aparece el aviso “Ingesta deshabilitada en este entorno” y no hay forma de subir nada desde esta pantalla; la búsqueda, en cambio, sigue funcionando con normalidad. Activarlo corresponde a quien administra la plataforma.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Pestaña "Conocimiento IA" | Navegación por pestañas | Abrir las fuentes del conocimiento | Punto de entrada a la pantalla desde la barra de pestañas de Cuenta, que se mantiene visible arriba para volver a cualquier otra sección de la cuenta. Solo se muestra a los perfiles Administrador y Admin Global. |
| Bloque "Buscar en las fuentes" | Sección de la página | — | Herramienta de consulta. Su descripción explica que sirve para escribir una pregunta y ver los fragmentos que recuperaría el copiloto, con la puntuación de cada uno. |
| Campo "Pregunta al conocimiento" | Campo de búsqueda | Lanzar la consulta | Cuadro donde se escribe la pregunta, con ejemplos en el propio campo. La consulta se lanza pulsando Intro o el botón contiguo. Mientras no se busca nada, el bloque indica que se escriba una consulta para ver qué fragmentos recupera el copiloto. |
| Botón "Buscar" | Botón de acción | Ejecutar la consulta | Lanza la búsqueda sobre las fuentes de la empresa. Durante el proceso el bloque muestra “Recuperando fragmentos...”. |
| Resumen de resultados | Indicador | — | Línea que aparece sobre la lista con el número de fragmentos recuperados. Cada consulta devuelve como máximo ocho. |
| Ficha de un fragmento | Tarjeta de resultado | Ver el texto recuperado | Una tarjeta por fragmento, en orden de relevancia. Muestra su número de orden (“#1”, “#2”…), el título del documento del que procede, una puntuación en porcentaje, el texto recuperado, las entidades citadas en él y su posición dentro del documento en la forma “chunk 2/7”. |
| Botón "Ver completo" / "Menos" | Botón de acción | Desplegar o plegar el fragmento | Aparece cuando el texto del fragmento está recortado. “Ver completo” muestra el fragmento entero y “Menos” vuelve a recortarlo. |
| Aviso de búsqueda sin resultados | Mensaje de estado | — | Si la consulta no recupera nada, el bloque muestra “Sin resultados. Prueba con otros terminos o ingesta mas fuentes.”. |
| Bloque "Anadir fuente" | Sección de la página | — | Herramienta de subida. Su descripción indica que se suben documentos en Markdown, PDF, HTML o texto, y que se indexan de forma que sigan siendo localizables tanto por su significado como por códigos exactos de equipo o de espacio. Solo muestra el formulario si la subida está activada en la instalación. |
| Zona de arrastre y selector de archivo | Área de subida | Elegir el documento | Admite arrastrar un archivo sobre ella o elegirlo con el selector. Acepta archivos .md, .txt, .html, .htm y .pdf, de uno en uno. Una vez elegido, muestra el nombre del archivo, su tamaño en KB y el tipo detectado. |
| Campo "Titulo" | Campo de texto | Nombrar la fuente | Nombre con el que quedará registrada la fuente y con el que aparecerá luego en los resultados de la búsqueda. Se rellena automáticamente con el nombre del archivo sin extensión y puede cambiarse; admite hasta 400 caracteres. |
| Selector "Scope" | Botones de opción | Decidir quién usa la fuente | Dos botones: “Tenant”, que incorpora el documento al conocimiento de toda la empresa, y “Personal”, que lo reserva a tu propia cuenta. Viene marcado “Tenant”. |
| Botón "Subir" | Botón de acción | Incorporar el documento | Envía el documento y lo indexa. Permanece deshabilitado mientras falte el archivo o el título, y muestra su progreso mientras trabaja. |
| Botón "Limpiar" | Botón de acción | Vaciar el formulario | Descarta el archivo elegido, el título y el mensaje de estado, sin subir nada. |
| Mensaje de estado de la subida | Mensaje de estado | — | Bajo los botones. En verde y empezando por “OK:” cuando la subida termina, con el número de fragmentos generados; en rojo y empezando por “Error:” cuando falla; y con el texto “Selecciona archivo y titulo.” si se pulsa “Subir” con el formulario incompleto. |
💡 Guía de Uso
Esta pantalla responde a dos preguntas distintas: qué sabe hoy el copiloto y cómo se le enseña algo nuevo.
Empieza por el bloque “Buscar en las fuentes” siempre que quieras entender una respuesta del copiloto. Escribe la misma pregunta que le harías a él —por ejemplo, un umbral de referencia o un procedimiento de una máquina— y pulsa “Buscar”. La plataforma devuelve, como mucho, ocho fragmentos ordenados de más a menos relevantes, cada uno con su porcentaje de coincidencia, el documento del que sale y su posición dentro de ese documento. Si el texto viene recortado, “Ver completo” lo despliega entero.
Ese listado es exactamente el material sobre el que el copiloto construye su respuesta, así que sirve de diagnóstico: si los fragmentos que aparecen arriba no son los que esperabas, el problema no está en la pregunta sino en las fuentes. Y si la búsqueda devuelve “Sin resultados. Prueba con otros terminos o ingesta mas fuentes.”, esa documentación sencillamente no está cargada.
Para cargarla, baja al bloque “Anadir fuente”. Arrastra el archivo o selecciónalo —se admiten Markdown, texto plano, HTML y PDF, de uno en uno—, revisa el título propuesto y cámbialo por uno que reconozcas después, porque es el que verás en los resultados de la búsqueda. Decide a continuación el alcance: con “Tenant” el documento pasa a formar parte del conocimiento de toda la empresa y podrá aparecer en las respuestas de cualquier usuario; con “Personal” se queda en tu cuenta. Termina con “Subir”.
La plataforma no guarda el archivo tal cual: lo trocea en fragmentos y los indexa para poder recuperarlos después por significado, conservando además los códigos exactos que aparezcan en el texto, de forma que una referencia a un aula o a una máquina concreta se siga encontrando tal como está escrita. Por eso la confirmación de una subida correcta es un mensaje en verde que empieza por “OK:” e indica cuántos fragmentos se han generado. Si en su lugar aparece un mensaje en rojo que empieza por “Error:”, el documento no ha entrado: revisa que el formato sea uno de los admitidos y vuelve a intentarlo.
La comprobación final se hace en el mismo sitio donde empezaste: vuelve al bloque de búsqueda, formula una pregunta que solo pueda contestarse con el documento recién subido y confirma que aparece entre los fragmentos recuperados, con el título que le pusiste. Si no aparece, no des por hecho que el copiloto lo conoce.
Ten en cuenta que subir un documento con alcance “Tenant” lo pone a disposición de las respuestas que reciba cualquier usuario de la empresa: no cargues aquí documentación confidencial que no deba circular.
Junto a esta pantalla, el copiloto se apoya en la wiki interna, que se edita en AI Brain, y las relaciones entre todo ese conocimiento pueden explorarse en AI Grafo.