Administración del conocimiento

Base de conocimiento

Organiza documentos operativos para que puedan localizarse por texto y utilizarse como contexto autorizado. El alcance de cada archivo determina quién puede encontrarlo.

Administrador · Administrador de tenant · Superadministrador Ruta del front: /knowledge-base
FormatosPDF · DOCX · TXT · MD
OrganizaciónAlcance y colecciones
FlujoCargar · procesar · buscar

Acceso y visibilidad

La página solo aparece para perfiles administrativos. Aunque dos usuarios puedan abrirla, no necesariamente verán los mismos recursos: el tenant, la empresa, el sistema y el alcance del documento limitan los resultados.

RolPuede consultarPuede administrar
AdministradorRecursos globales de plataforma en solo lectura, globales de su tenant y los de empresa o sistema que pueda leer.Recursos propiedad del tenant dentro de su alcance; nunca los globales de plataforma.
Administrador de tenantRecursos de todo su tenant y globales de plataforma en solo lectura.Documentos y colecciones propiedad del tenant; nunca los globales de plataforma.
SuperadministradorTodos los ámbitos autorizados.Incluye recursos globales de plataforma.
Primero confirma el contexto

Antes de cargar un archivo, verifica el tenant, la empresa y el sistema que aparecen en el formulario. Un alcance demasiado amplio expone contenido a más usuarios; uno demasiado estrecho impide encontrarlo donde se necesita.

Cargar un documento

  1. Selecciona agregar o cargar.

    Abre el formulario desde la barra de acciones de la biblioteca.

  2. Elige el archivo.

    Utiliza PDF, DOCX, TXT o MD. Asigna un nombre claro y revisa el tipo detectado.

  3. Define el alcance.

    Selecciona tenant, empresa, sistema o global según el propósito del contenido.

  4. Asigna una colección.

    Es opcional, pero facilita filtrar manuales, procedimientos o fichas técnicas relacionadas.

  5. Guarda y espera el procesamiento.

    El archivo pasa por Cargado, Procesando, Listo o Fallido. No lo uses para búsquedas hasta que figure como Listo.

Uploaded · CargadoEl archivo llegó al servidor y espera que comience la preparación.
Processing · ProcesandoEl contenido se está fragmentando e indexando.
Ready · ListoEl contenido ya puede aparecer en búsquedas autorizadas.
Failed · FallidoEl procesamiento no concluyó; consulta el detalle y vuelve a cargar una copia válida.

Elegir el alcance correcto

TN

Tenant

Comparte el documento con usuarios autorizados dentro de la misma organización.

EM

Empresa

Lo restringe a una empresa y a quienes tengan acceso efectivo a ella.

SI

Sistema

Es la opción más específica para instrucciones ligadas a una instalación o proceso.

GL

Global

Solo el superadministrador puede administrarlo. Úsalo para contenido común y no confidencial.

El nombre no protege el contenido

La autorización se decide por el alcance guardado, no por el título, la carpeta original ni la colección. No cargues contraseñas, tokens o secretos en documentos de conocimiento.

Organizar colecciones

Una colección agrupa recursos relacionados y agrega un filtro reutilizable. Puede representar una línea, un equipo, una disciplina o un tipo de procedimiento.

  1. Abre la administración de colecciones.

    Consulta primero las existentes para evitar nombres duplicados.

  2. Crea o edita la colección.

    Usa un nombre breve y una descripción que explique qué documentos deben pertenecer a ella.

  3. Asigna documentos.

    Selecciona la colección al cargar o editar cada archivo.

  4. Verifica antes de eliminar.

    Eliminar una colección también elimina sus documentos, fragmentos, índices y archivos asociados.

Eliminación con impacto

La eliminación de una colección no equivale a quitar una etiqueta. Confirma que los documentos ya no sean necesarios o muévelos antes a otra colección.

Buscar y comprobar conocimiento

La biblioteca permite localizar recursos por documento, colección, tipo MIME o identificador, además de probar una consulta semántica.

  1. Acota la biblioteca.

    Combina búsqueda de texto con estado, alcance, colección y orden.

  2. Abre el detalle.

    Comprueba nombre, tipo, alcance, colección y estado de procesamiento.

  3. Ejecuta una prueba semántica.

    Formula una pregunta específica y revisa si los fragmentos devueltos corresponden al documento esperado.

  4. Ajusta la fuente.

    Si el resultado es ambiguo, mejora títulos y contenido, separa documentos extensos o corrige su alcance.

  • Busca con términos que realmente aparezcan en el procedimiento.
  • Comprueba que el archivo esté en estado listo.
  • Valida la respuesta con el documento fuente antes de tomar una decisión operativa.

Editar, descargar o eliminar

Desde el detalle puedes consultar metadatos, descargar el archivo original, cambiar propiedades permitidas o eliminar el recurso.

AcciónÚsala paraPrecaución
EditarCorregir nombre, descripción, alcance o colección.Revalida qué usuarios podrán encontrarlo.
Ver o descargarContrastar la información indexada con la fuente.Respeta la clasificación del documento fuera del sistema.
EliminarRetirar un recurso obsoleto o cargado por error.Elimina registro, fragmentos, índices y archivo; no es una acción reversible desde la página.

Para administrar autorizaciones externas relacionadas, consulta alcances y concesiones. Para conocer las reglas generales, revisa secretos y datos sensibles.

Base de conocimiento · Manual de usuario de SCADA IA