Centro de ayuda
Preguntas frecuentes
Encuentra respuestas a preguntas comunes sobre Open Knowledge Format, herramientas OKF, validación y mejores prácticas.
General
FAQ
¿Qué es Open Knowledge Format?
Open Knowledge Format (OKF) es una especificación abierta de Google Cloud para empaquetar conocimiento curado como un directorio de archivos Markdown con frontmatter YAML. Hace que el conocimiento sea legible tanto para humanos como para agentes de IA.
¿Quién mantiene OKF?
OKF fue publicado por el equipo de datos de Google Cloud como una especificación abierta bajo licencia Apache-2.0. La comunidad contribuye con herramientas e implementaciones.
¿Es estable OKF v0.1?
OKF v0.1 está en estado de borrador. El formato central es utilizable, pero las especificaciones pueden cambiar a medida que la comunidad proporciona retroalimentación y surgen más implementaciones.
Uso de herramientas OKF
FAQ
¿Cómo valido mi documento OKF?
Usa la herramienta Validador OKF. Pega tu contenido Markdown y verificará el frontmatter obligatorio, las reglas de validación y proporcionará un OKF Score con desglose detallado.
¿Puedo generar OKF por lotes desde Sitemap?
Sí. El Generador de web a OKF admite el modo Sitemap. Ingresa una URL de sitemap.xml y procesará hasta 20 páginas, generando un paquete completo con índice, registros e informes de validación.
¿Qué es OKF Score?
OKF Score es una métrica de 0-100 que mide la calidad del documento en tres dimensiones: Estructura (40%), Cobertura (30%) y Conectividad (30%). Las puntuaciones más altas indican conocimiento mejor estructurado y más completo.
¿Cómo funciona el Live Badge?
El Live Badge valida la URL de tu documento OKF implementado y genera una insignia SVG que muestra el OKF Score actual. Puedes incrustarla en archivos README o documentación para mostrar el estado de validación en tiempo real.
Técnico
FAQ
¿Qué campos de frontmatter son obligatorios?
El único campo obligatorio es 'type'. Los campos recomendados incluyen title, description, id, tags y source_url. Consulta el validador para ver advertencias sobre campos recomendados faltantes.
¿Cómo mejoro mi OKF Score?
Mejora la Estructura agregando frontmatter completo (type, title, description, id, tags). Mejora la Cobertura escribiendo contenido detallado con encabezados. Mejora la Conectividad agregando source_url y enlaces internos.
¿Puedo usar OKF para proyectos comerciales?
Sí. OKF se publica bajo la licencia Apache-2.0, que permite uso comercial. Puedes usarlo para bases de conocimiento internas, documentación de productos o APIs públicas.