Ir al contenido principal
DudoxxSentinel
Iniciar sesión

Estándares y formatos

Paquetes de conocimiento en el Open Knowledge Format

Sentinel convierte un documento leído en una carpeta de archivos markdown sencillos en el formato abierto OKF. Su equipo puede abrirla, buscarla, archivarla y dársela a un agente de IA, sin ningún software de Sentinel.

Qué es

Un formato abierto para el conocimiento en archivos sencillos

El Open Knowledge Format (OKF) describe una carpeta de archivos de texto que reúnen lo que se sabe sobre un tema.

Abierto y neutral

El formato se publica como especificación abierta. Cualquier herramienta puede leer un paquete; ningún proveedor tiene la llave.

Markdown con una cabecera pequeña

Cada concepto es un archivo markdown. Una cabecera YAML breve indica qué tipo de concepto es, de dónde viene y cuándo se creó.

Con versión

Un paquete indica la versión del formato que sigue, para que el lector sepa qué esperar. Sentinel escribe la versión 0.2.

Estructura

Qué hay dentro de un paquete

Un paquete es una carpeta normal o un archivo zip. Los nombres de abajo son los que escribe Sentinel; el formato deja libre la organización de carpetas.

El formato reserva dos nombres de archivo: la lista del directorio y el registro de cambios. Cualquier otro archivo markdown es un concepto.
  • index.md — Lista del directorio y versión del formato
  • log.md — Qué cambió y cuándo
  • pages/ — Un concepto por página
  • figures/ — Un concepto por figura
  • tables/ — Un concepto por tabla
  • transcript.md — Audio hablado, escrito como texto
  • assets/ — Recortes de imagen, imágenes de página y datos de regiones

Cómo lo crea Sentinel

De la subida al paquete verificado

No tiene que hacer nada extra. El paquete se construye con lo que Sentinel ya leyó y se verifica antes de que pueda usarlo.

  1. Subir

    Sube un documento o una grabación a Sentinel.

  2. Leer las regiones

    Sentinel divide cada página en regiones, como texto, figuras y tablas, y lee cada una. Una región que no puede leer con confianza queda marcada como ilegible, con su ubicación conservada.

  3. Escribir los conceptos

    Cada página, figura y tabla se convierte en un concepto markdown. Anota su página, su lugar en la página y su origen. Una corrección humana prevalece sobre la lectura automática.

  4. Validar

    Sentinel comprueba el paquete terminado con las reglas del formato. Un paquete que no pasa la comprobación no se libera.

  5. Indexar para buscar

    El texto se corta en fragmentos y se añade a un índice de búsqueda, para que su equipo encuentre un pasaje en todos los documentos y lo abra en su página.

Cómo lo usa un equipo

Un paquete, cuatro tareas

Como un paquete son solo archivos, encaja con las herramientas que ya tiene.

Recuperación para agentes de IA

Un agente lee la lista del directorio, elige los conceptos que necesita y cita la página de la que viene cada dato.

Archivo a largo plazo

El texto sencillo sobrevive al software. Un paquete sigue siendo legible en cualquier editor, dentro de años.

Intercambio

Envíe el zip a un socio o a otro sistema. Lleva consigo sus fuentes y su historial.

Validación

Una herramienta de comprobación puede confirmar que un paquete sigue el formato antes de que confíe en él.

Límites y honestidad

Lo que afirmamos y lo que no

Queremos que sepa exactamente dónde termina nuestro trabajo y dónde empieza el estándar.

  • Sin aval

    El formato es una especificación abierta publicada por sus autores. Sentinel la usa. Eso no significa que sus autores avalen o certifiquen Sentinel.

  • La especificación es suya

    Esta página es una guía breve, no la especificación. Para las reglas exactas, lea la propia especificación.

  • La comprensión de documentos es opcional

    Los paquetes salen de la función de comprensión de documentos, que su administrador debe activar primero.

Leer la especificación: Open Knowledge Format en GitHub

¿Paquetes a partir de sus documentos?

Cuéntenos qué guarda y qué quiere buscar. Le mostramos un paquete hecho con sus propios documentos.