Open Knowledge Format: Markdown-спека Google для агентов

12 июня 2026 года Google Cloud опубликовал спецификацию того, как AI-агенты должны читать и обмениваться курируемыми знаниями. Можно было бы ожидать графовую базу данных, реестр схем, SDK и сервис, чтобы всё это крутить.

Вместо этого Open Knowledge Format — это: директория Markdown-файлов с YAML-фронтматтером.

Это весь формат целиком. И именно эта сдержанность — самое интересное.

Спецификация меньше, чем вы думаете

Большинство статей об OKF просто пересказывают анонс. Стоит прочитать саму спецификацию — поверхность у неё поразительно маленькая.

OKF v0.1 требует ровно одно поле в каждом документе-концепте:

---
type: BigQuery Table
---

И всё. type — короткая строка, определяющая тип концепта, который описывает документ; используется для роутинга и фильтрации. Значения нигде централизованно не регистрируются — нет комитета, утверждающего список допустимых типов. Производители контента подбирают самоочевидные обозначения и двигаются дальше.

Ещё пять полей рекомендованы, но не обязательны:

Поле	Назначение
title	Отображаемое имя. Если поле отсутствует, потребитель может вывести его из имени файла.
description	Однострочное резюме.
resource	URI, однозначно идентифицирующий исходный актив.
tags	YAML-список для сквозной категоризации.
timestamp	Дата и время последнего изменения в формате ISO 8601.

Производители могут добавлять любые собственные ключи. Потребители обязаны сохранять неизвестные поля, а не отбрасывать их.

Полный, соответствующий спецификации документ-концепт выглядит так:

---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
tags: [sales, orders]
timestamp: 2026-05-28T00:00:00Z
---

# Schema

| Column | Type | Description |
|--------|------|-------------|
| order_id | STRING | Unique identifier |

Если вы хоть раз писали заметку в Obsidian с фронтматтером, вы уже написали нечто очень близкое к валидному концепту OKF.

Граф знаний без графовой базы данных

А вот проектное решение, которое стоит украсть независимо от того, будете вы внедрять OKF или нет.

Связи между концептами выражаются как обычные Markdown-ссылки. Не рёбра в базе данных. Не блок relationships: во фронтматтере. Просто ссылки:

Each order references a [customer](/tables/customers.md).

Для стабильности рекомендуются абсолютные пути внутри бандла (начинающиеся с /); обычные относительные пути вроде ./other.md тоже работают.

А дальше — то, что заставляет всё это работать: тип связи задаётся окружающим текстом, а не самой ссылкой. “Each order references a customer” и есть метка ребра. Не нужно поддерживать онтологию, не нужно договариваться о словаре предикатов — потому что естественный язык уже даёт такой словарь, а потребитель контента — языковая модель.

Десятилетие инструментов для графов знаний ушло на формализацию типов связей, чтобы машины могли их интерпретировать. Ставка OKF в том, что это больше не нужно — теперь машина умеет читать по-английски.

Два зарезервированных имени файлов

Только два имени файлов имеют особый смысл внутри бандла:

• index.md — листинг директории, обеспечивающий постепенное раскрытие информации. Фронтматтера не несёт. Агент сначала читает индекс и переходит только по нужным ссылкам, вместо того чтобы загружать в контекст каждый концепт.
• log.md — хронологическая история обновлений, с заголовками-датами в формате ISO 8601, от новых к старым.

Любой другой файл .md — это документ-концепт. В итоге бандл выглядит как обычная, просматриваемая папка:

sales/
├── index.md
├── datasets/orders_db.md
├── tables/orders.md
└── metrics/weekly_active_users.md

index.md — тихо, но важно. За ним стоит тот же инстинкт, что и за хорошо написанным CLAUDE.md: не сваливать всю библиотеку в контекстное окно, а вручить агенту оглавление и дать ему самому подгружать нужное.

Чем OKF не является

Это не RAG. RAG заново выводит знание в момент запроса — извлекает сырые чанки и надеется, что нужные всплывут наверх. Бандл OKF хранит курируемые, перелинкованные концепты, которые агент читает и обновляет напрямую. Курирование происходит один раз, осознанно, вместо того чтобы приблизительно воссоздаваться при каждом запросе.

Это не AGENTS.md и не CLAUDE.md. Это файлы-инструкции — они говорят агенту, как вести себя в репозитории. OKF описывает предметные знания: что означает эта таблица, как определена эта метрика, почему в этом датасете дыра в марте. Разная работа, взаимодополняющая.

Это не MCP. MCP — рантайм-протокол для подключения агента к живым системам. OKF — файловый формат, лежащий на диске в покое. Разумно использовать оба сразу: MCP — чтобы дотянуться до хранилища данных, OKF — чтобы объяснить, что в нём есть.

Правила соответствия спецификации намеренно снисходительны

Бандл соответствует OKF v0.1, если у каждого нерезервированного файла .md есть парсящийся YAML-фронтматтер, каждый блок фронтматтера содержит непустой type, а зарезервированные файлы, если присутствуют, следуют своей структуре.

Ещё показательнее то, что спецификация запрещает делать потребителям. Потребитель не должен отклонять бандл из-за отсутствующих опциональных полей, неизвестных значений type, неизвестных ключей, битых перекрёстных ссылок или отсутствующего index.md.

Это формат, спроектированный людьми, которые ожидают, что бандлы будут наполовину готовы, частично сгенерированы машиной и в постоянном движении — а именно так и выглядят настоящие базы знаний на практике. Строгие форматы гибнут от собственной строгости. Этот же создан, чтобы пережить столкновение с неряшливой папкой.

Вместе со спецификацией Google выпустил и референсные инструменты: агента для обогащения BigQuery, статичный HTML-визуализатор и три примера бандлов.

Одна оговорка, которую стоит прямо проговорить: OKF — это v0.1, и явно черновик. Спецификация версионируется и спроектирована для обратно совместимого роста, но названия полей и конвенции всё ещё могут поменяться. Не перестраивайте свою базу знаний вокруг неё прямо сегодня. Но стоит отметить, куда движется этот стандарт.

Почему это важно не только для Google Cloud

Уберите примеры с BigQuery — и OKF окажется ставкой с гораздо более широким радиусом действия: что долговечный формат для машиночитаемых знаний — это обычные Markdown-файлы в папке, которая принадлежит вам.

Не проприетарный каталог с API. Не эмбеддинги в векторном хранилище, которое вы не можете прочитать. Не вики с кнопкой экспорта, которая ломает ваши таблицы. Файлы. На диске. Поддающиеся диффу, грепу, переносимые между вендорами, читаемые и человеком, и любой моделью на рынке.

Это тот же вывод, к которому независимо друг от друга пришли Claude Code, Cursor, Copilot и Windsurf, когда выбрали Markdown форматом своих инструкций. То, что Google Cloud оформил это в виде спецификации, — подтверждение, а не изобретение.

При чём тут Minibase

Если вы ведёте Minibase Vault, вы уже поддерживаете нечто структурно близкое к бандлу OKF: папку Markdown-файлов с фронтматтером, на вашем собственном диске, которую читают Claude и ChatGPT.

Сделать его формально соответствующим спецификации — небольшая правка: добавьте type во фронтматтер, а дальше пусть работают ваши ссылки:

---
type: Article
title: How the Open Knowledge Format can improve data sharing
resource: https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing/
tags: [okf, agents, markdown]
timestamp: 2026-07-19T00:00:00Z
---

Вот в чём практический смысл этого анонса. Самой сложной частью базы знаний для агента никогда не был файловый формат — сложнее было наполнить её хорошим исходным материалом. Спецификация говорит, как оформить папку. Она её не наполняет.

Minibase — это как раз то, что наполняет: один клик превращает любую веб-страницу — документацию, README на GitHub, спецификацию, тред, научную статью — в чистый Markdown у вас в папке, готовый для следующего агента, которого вы запустите.

Формат теперь стандартный. То, что вы в него кладёте, — по-прежнему ваше преимущество.

---

Minibase превращает любую веб-страницу в чистый Markdown, который читают ваши агенты — установите расширение и начните собирать бандл, который делает ваших агентов умнее.