Guía OKF
¿Qué es Open Knowledge Format (OKF)?
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, legible tanto por personas como por agentes de AI.
La versión corta
OKF guarda el conocimiento como archivos Markdown normales con un pequeño bloque de frontmatter YAML al inicio. Es solo Markdown, solo archivos y solo unos pocos campos estructurados: sin base de datos, sin API y sin SDK. Un agente de AI lee o escribe un archivo directamente, así que el sistema de archivos es la interfaz.
Cómo se estructura un archivo OKF
Cada documento OKF es Markdown para el cuerpo legible más frontmatter tipado para el pequeño conjunto de campos que deben ser consultables: type, title, description, resource, tags y timestamp. El cuerpo sigue siendo Markdown libre, así que se renderiza en cualquier sitio y es fácil de editar.
Por qué los agentes de AI usan OKF
Los agentes funcionan mejor con contexto curado y estable. OKF les da una capa de conocimiento precompilada que pueden cargar directamente en lugar de rederivarla cada vez. Complementa a llms.txt (un mapa a nivel de sitio) y al Model Context Protocol (una forma de obtener datos bajo demanda).
Herramientas y guías OKF relacionadas
FAQ
¿Quién creó Open Knowledge Format?
OKF fue publicado por el equipo de datos de Google Cloud como una especificación abierta con licencia Apache-2.0. La versión 0.1 es intencionadamente pequeña y se espera que evolucione a medida que la adopten más productores y consumidores.
¿OKF es lo mismo que llms.txt?
No. llms.txt es un único índice a nivel de sitio que dirige a los sistemas de AI hacia URLs importantes. OKF es el conocimiento curado en sí: un paquete de archivos Markdown tipados que los agentes cargan en el contexto.
¿Cómo empiezo a usar OKF?
Empieza con una plantilla, pégala en el Validador OKF para comprobar el frontmatter y luego publica archivos enfocados para tus APIs, datasets, métricas y documentación de producto.