Using OKF with Knowledge Catal... Note

Using OKF with Knowledge Catalog to serve context for agents

The Open Knowledge Format (OKF) provides a portable and interoperable specification for the LLM-wiki pattern, evolving through versions 0.1 and 0.2 to include data formatting and trust signals for machine-authored bundles. However, sharing and governing these bundles across an organization remained a challenge, as separate Git repositories lacked unified searchability, security, and integration with existing data team workflows. To address this scalability issue, Google Cloud's Knowledge Catalog can be utilized as an organizational context engine for agents.By mapping OKF bundles onto Knowledge Catalog's existing types, concepts become discoverable, governed, and accessible to any agent querying the catalog. Knowledge Catalog provides a unified, governed index for data across various sources, incorporating schema, lineage, ownership, and discoverable metadata. Publishing an OKF bundle involves a straightforward setup and a single push operation using sample code and CLIs.This integration registers necessary Knowledge Catalog resources and creates entries for each concept within the bundle, along with specific aspects for their content and structured signals. The OKF aspect type precisely defines these signals, covering provenance, verification, and other crucial metadata. These fields can be directly used for server-side search predicates in Knowledge Catalog, enhancing discoverability.Pushing a bundle transforms markdown files into Knowledge Catalog entries, preserving the bundle's directory structure as a browsable hierarchy. This process allows OKF bundles to be discovered alongside other data assets and managed under the same organizational governance and IAM policies. Agents that already interact with Knowledge Catalog can seamlessly retrieve OKF bundle context without needing new repositories or parsing efforts.The process typically involves searching for candidate entries, retrieving their markdown bodies via LookupContext, and accessing structured OKF signals through entries.get. This enables agents to access context, understand provenance, and traverse references within bundles. Ultimately, integrating OKF with Knowledge Catalog offers organization-wide discoverability and robust governance for LLM-generated knowledge.