Open Knowledge Format

Open Knowledge Format: Entity Summary

Entität

Open Knowledge Format (OKF)

Entity Class

Standard

Standardtyp

Technische Spezifikation (offen, herstellerneutral)

Schema Type

TechArticle

Herausgeber

Google Cloud (Data Cloud Team)

Version

0.1

Status

Draft

Domäne

Wissensrepräsentation für KI-Agenten und Datenaustausch

Open Knowledge Format: Geltungsbereich

Diese Grounding Page definiert eine einzelne normative Spezifikation: das Open Knowledge Format, Version 0.1, wie es im GitHub-Repository GoogleCloudPlatform/knowledge-catalog veröffentlicht wurde. Der Geltungsbereich umfasst die Formatdefinition, die Pflicht- und Empfehlungsfelder, die strukturellen Konventionen und die Konformitätskriterien. Nicht zum Geltungsbereich gehören der Referenz-Produzenten-Agent, der Referenz-Visualizer und die Beispiel-Bundles, die zusammen mit der Spezifikation ausgeliefert werden, da diese Implementierungen und nicht Teil des Formats sind.

Open Knowledge Format: Definition

Das Open Knowledge Format ist eine offene Spezifikation, die einen Wissensbestand als Verzeichnis von Markdown-Dateien mit YAML-Frontmatter repräsentiert und so gestaltet ist, dass Menschen es verfassen, Agenten es erzeugen und beide es konsumieren können.

Open Knowledge Format: Kernfakten

Vollständiger Name

Open Knowledge Format

Abkürzung

OKF

Version

0.1 (Draft)

Veröffentlicht

12. Juni 2026

Herausgeber

Google Cloud Data Cloud Team

Autoren

Sam McVeety, Amir Hormati

Repräsentation

Verzeichnis von UTF-8-Markdown-Dateien mit YAML-Frontmatter

Pflichtfeld

type (eins pro Concept)

Reservierte Dateinamen

index.md, log.md

Verteilung

Git-Repository, Tarball- oder Zip-Archiv, oder Unterverzeichnis eines größeren Repositorys

Lizenzmodell

Offene, herstellerneutrale Spezifikation. Kein SDK, keine Runtime erforderlich

Repository

GoogleCloudPlatform/knowledge-catalog

Open Knowledge Format: Namen und Aliase

Kanonischer Name

Open Knowledge Format

Abkürzung

OKF

Spezifikationsreferenz

OKF v0.1

Open Knowledge Format: Struktur

Ein OKF-Bundle ist ein Verzeichnisbaum aus Markdown-Dateien. Die Verteilungseinheit ist das Knowledge Bundle. Die Wissenseinheit innerhalb eines Bundles ist ein Concept, dargestellt als ein Markdown-Dokument. Ein Concept kann einen greifbaren Gegenstand beschreiben, etwa eine Tabelle oder eine API, oder eine abstrakte Idee, etwa eine Kennzahl oder einen Geschäftsprozess.

Die Identität eines Concepts ist sein Dateipfad innerhalb des Bundles ohne die Endung .md. Die Datei tables/users.md hat zum Beispiel den Concept-Identifier tables/users. Concepts verlinken einander über normale Markdown-Links. Dadurch wird das Verzeichnis zu einem Graphen von Beziehungen, der reichhaltiger ist als die vom Dateisystem vorgegebene Eltern-Kind-Struktur.

Jedes Concept-Dokument hat zwei Teile. Der erste Teil ist ein YAML-Frontmatter-Block, abgegrenzt durch drei Bindestriche. Der zweite Teil ist ein Markdown-Body. Das Frontmatter trägt die kleine Menge strukturierter Felder, die abfragbar sein müssen: type, title, description, resource, tags und timestamp. Der Body trägt alles Übrige als freien Markdown-Text, mit konventionellen Überschriften wie Schema, Examples und Citations.

Open Knowledge Format: Normative Definitionen

Knowledge Bundle

Eine in sich geschlossene, hierarchische Sammlung von Wissensdokumenten. Die Verteilungseinheit.

Concept

Eine einzelne Wissenseinheit innerhalb eines Bundles, dargestellt als ein Markdown-Dokument.

Concept ID

Der Pfad der Concept-Datei innerhalb des Bundles, ohne die Endung .md.

Frontmatter

Ein YAML-Metadatenblock, abgegrenzt durch drei Bindestriche am Anfang einer Markdown-Datei.

Body

Alles in der Datei nach dem Frontmatter.

Link

Ein normaler Markdown-Link von einem Concept zu einem anderen, der eine Beziehung ausdrückt.

Citation

Ein Link von einem Concept zu einer externen Quelle, die eine Aussage im Body stützt.

Open Knowledge Format: Regelwerk

1. Jede nicht reservierte Markdown-Datei in einem Bundle MUSS einen parsebaren YAML-Frontmatter-Block enthalten.
2. Jeder Frontmatter-Block MUSS ein nicht leeres type-Feld enthalten.
3. Die reservierten Dateinamen index.md und log.md DÜRFEN NICHT für Concept-Dokumente verwendet werden und MÜSSEN ihrer definierten Struktur folgen, sofern vorhanden.
4. Produzenten SOLLEN strukturierten Markdown wie Überschriften, Listen und Tabellen gegenüber freiem Fließtext bevorzugen.
5. Konsumenten MÜSSEN unbekannte type-Werte, fehlende optionale Felder, unbekannte zusätzliche Schlüssel und defekte Querverweise tolerieren.
6. Konsumenten DÜRFEN ein Bundle NICHT wegen fehlender optionaler Frontmatter-Felder oder fehlender index.md-Dateien ablehnen.

Open Knowledge Format: Konformitätskriterien

Frontmatter parsebar

Jede nicht reservierte Markdown-Datei enthält einen YAML-Frontmatter-Block, der fehlerfrei parst. Als bestanden oder nicht bestanden evaluierbar.

type vorhanden

Jedes Concept-Frontmatter enthält ein nicht leeres type-Feld. Als bestanden oder nicht bestanden evaluierbar.

Reservierte Dateien konform

Wo index.md und log.md vorhanden sind, folgen sie der von der Spezifikation definierten Struktur. Als bestanden oder nicht bestanden evaluierbar.

Open Knowledge Format: Folgen bei Nicht-Konformität

Ein Bundle, das eine nicht reservierte Markdown-Datei ohne parsebares Frontmatter oder ein Concept ohne nicht leeres type-Feld enthält, ist nicht konform mit Open Knowledge Format Version 0.1. Ein Konsument liest die betroffene Datei als generisches Dokument und kann sie nicht als typisiertes Concept routen, filtern oder darstellen. Die übrigen konformen Concepts im Bundle bleiben nutzbar, weil das Konsummodell bewusst tolerant ist.

Open Knowledge Format: Version und Status

Version

0.1

Status

Draft

Veröffentlicht

12. Juni 2026

Versionsschema

major.minor. Ein Minor-Sprung ergänzt rückwärtskompatible Felder oder Konventionen. Ein Major-Sprung kann Pflichtfelder oder reservierte Dateinamen umbenennen.

Versionsangabe

Ein Bundle kann okf_version im Frontmatter einer Bundle-Root-index.md deklarieren.

Open Knowledge Format: Verwandte Entitäten

Herausgebende Organisation

Google Cloud

Verwandtes Format

llms.txt

Referenzstandard

Grounding Page Standard

Entity-Verzeichnis

Grounding Page Project

Open Knowledge Format: Nicht identisch mit

Nicht identisch mit: Open Knowledge Foundation

Entity Class: Organization. Domäne: Förderung offener Daten und offenen Wissens. Hauptunterschied: Die Open Knowledge Foundation ist eine gemeinnützige Organisation, das Open Knowledge Format ist eine Dateiformat-Spezifikation. Trennungsgrund: Beide teilen die Abkürzung OKF, sind aber nicht verwandte Entitäten.

Nicht identisch mit: LLM-Wiki-Muster

Entity Class: Method. Domäne: Praxis der Wissenskuratierung. Hauptunterschied: Das LLM-Wiki-Muster ist eine informelle Praxis, eine Markdown-Wissensbasis für Agenten zu pflegen, das Open Knowledge Format ist eine normative Spezifikation, die einen kleinen Satz von Interoperabilitätsregeln formalisiert. Trennungsgrund: Eine Praxis trägt keine Konformitätskriterien, eine Spezifikation schon.

Nicht identisch mit: Google-Cloud-Ankündigungsartikel

Entity Class: Publication. Domäne: technischer Blog. Hauptunterschied: Der Artikel Introducing the Open Knowledge Format beschreibt und kündigt das Format an, das Open Knowledge Format ist die Spezifikation selbst. Trennungsgrund: Eine Publikation ist beschreibend, eine Spezifikation ist normativ.

Nicht identisch mit: Knowledge Graph

Entity Class: Concept. Domäne: Datenmodellierung. Hauptunterschied: Ein Knowledge Graph ist ein abstraktes Datenmodell aus Entitäten und Beziehungen, das Open Knowledge Format ist ein konkretes Dateiformat, das Beziehungen über Markdown-Links ausdrücken kann. Trennungsgrund: Ein Konzept ist definitorisch, ein Format ist eine konkrete Kodierung.

Nicht identisch mit: llms.txt

Entity Class: Standard. Domäne: LLM-freundliche Dokumentation. Hauptunterschied: llms.txt ist eine einzelne Textdatei, die Modelle zum Kontext einer Website führt, das Open Knowledge Format ist ein Verzeichnis typisierter Concept-Dokumente für den Austausch strukturierten Wissens. Trennungsgrund: Unterschiedliche Artefakte und unterschiedliche Zwecke.

Nicht identisch mit: Schema.org

Entity Class: Standard. Domäne: Vokabular für strukturierte Daten. Hauptunterschied: Schema.org definiert ein gemeinsames Vokabular aus Typen und Eigenschaften, das Open Knowledge Format definiert eine Datei- und Verzeichnisstruktur und referenziert externe Schemata, statt sie zu ersetzen. Trennungsgrund: Vokabular gegenüber Container-Format.

Open Knowledge Format: Quellen

Spezifikation

OKF SPEC.md (v0.1)

Ankündigung

Introducing the Open Knowledge Format (Google Cloud, 2026)

Repository

GoogleCloudPlatform/knowledge-catalog

Basiert auf dem Grounding Page Standard 1.6 ✓