Google OKF: The Simple Folder That Gives AI Agents Your Entire Company Data

Understanding Active Users and Knowledge Management

The Challenge of Defining Active Users

• Companies often struggle to define "active users" due to scattered knowledge across various platforms.

• Information is found in Confluence pages, Notion docs, Slack threads, and even within individual employees' minds.

Context Assembly Issues

• Every AI agent must repeatedly search for and interpret the same information, leading to inefficiencies.

• Google refers to this as "solving context assembly from scratch." A unified format could streamline this process.

Introducing Open Knowledge Format (OKF)

What is OKF?

• The Open Knowledge Format (OKF) is a new specification from Google Cloud that simplifies knowledge management by using plain Markdown files in a Git repository.

• Each file represents one concept (e.g., a table or metric), with minimal required metadata—only the type field is mandatory.

Benefits of OKF

• Agents can access business knowledge easily without complex retrieval systems; they read it like a handbook.

• This approach allows agents to understand company operations without needing extensive background knowledge.

Institutional Memory and Its Importance

The Role of Institutional Memory

• Modern agents excel at tasks but lack the institutional memory that experienced employees possess, which includes specific facts about metrics and processes.

• Teams currently rebuild context manually for every project, leading to redundancy and inefficiency in data modeling.

Structure of an OKF Document

Building an OKF Document

• An OKF document consists of structured YAML metadata followed by free-form Markdown content detailing schemas or formulas relevant to the topic at hand.

• Metadata helps agents filter and route information effectively while allowing flexibility in additional fields such as descriptions or links.

Navigable Graph of Business Knowledge

Linking Documents Together

• Documents within an OKF framework link through standard Markdown links, creating a navigable graph representing business knowledge comprehensively.

• Bundles consist of directories containing related documents organized intuitively according to team needs rather than rigid schemas.

Version Control and Maintenance

Managing Knowledge Like Code

• The OKF structure allows for version control similar to code repositories, enabling tracking changes over time through pull requests and logs.

• It accommodates broken links or unknown fields gracefully, reflecting real-world scenarios where knowledge may be incomplete or evolving.

Practical Implementation of OKF

Automating Documentation Creation

• Google provides tools that automate the creation of OKF documents by analyzing existing datasets and documentation for completeness before human review occurs.

Sample Bundles Available

• Ready-made bundles are available for common datasets like Google Analytics or Bitcoin data, facilitating quick adoption into workflows.

Key Principles Behind OKF

Core Principles

• The format emphasizes independence between producers and consumers while being minimally opinionated with only one required field: type.

• Unlike traditional wikis designed primarily for human readers, OKFs are machine-readable text files that can be utilized anywhere.

(t=406] Conclusion on Adoption Challenges

Current State of Adoption

• As an early-stage initiative (version 0.1), there are challenges regarding freshness; live data should still be managed via APIs rather than static documents.

• Emphasizes writing down stable expertise once so all agents can access it efficiently without redundant explanations.