ITUZOV LAB
← Все материалы
Разбор

OKF от Google: выдохни, это просто папка с markdown

Google выкатил Open Knowledge Format, и ленты уже кричат «внедряй или умрёшь». Разбираем без паники: что это на самом деле, почему оно тебя ни к чему не обязывает, и в чём всё-таки здравая идея.

6 минНачальный23 июня 2026 г.

Снова бежать что-то внедрять

13 июня 2026 Google Cloud показал OKF, Open Knowledge Format. И через сутки лента превратилась в то, что мы все так любим: «СРОЧНО! Новый стандарт от Google! Внедряй в проект, пока конкуренты не обогнали!». Курсы, гайды «OKF за выходные», тревожные сторис «вы всё ещё без OKF?».

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

Спойлер: штука полезная, но нужна не всем и точно не срочно.

Что это, простыми словами

OKF это формат, в котором знания хранятся как обычная папка с markdown-файлами. Никакой закрытой платформы, ничего покупать и устанавливать не надо. Просто текстовые файлы, которые открываются в любом редакторе и читаются хоть человеком, хоть AI-агентом.

Каждый файл описывает одно понятие: таблицу в базе, метрику, процесс, API. Сверху у файла маленькая «шапка» (YAML-фронтматтер) с парой полей, ниже обычный текст.

И вот тут первый сюрприз. Обязательное поле в спеке ровно одно:

---
type: BigQuery Table
---

type это просто строка-ярлык: «что это за штука». В примере выше BigQuery Table значит «файл описывает таблицу в BigQuery» (это облачная база данных от Google), но значение может быть любым, какое тебе понятно: Метрика, API, Регламент, Модуль. Всё. Остальные поля (название, описание, ссылка на ресурс, теги, дата) рекомендованы, но не обязательны. То есть «стандарт», на внедрение которого продают курсы, в минимальном виде это один файл с одной строчкой в шапке.

Полноценный файлик выглядит так:

---
type: BigQuery Table
title: Заказы
description: Таблица заказов магазина, одна строка на заказ.
resource: bigquery://project/dataset/orders
tags: [продажи, заказы]
timestamp: 2026-06-23T10:00:00Z
---
 
# Заказы
 
Дальше обычный markdown: описание, схема полей,
ссылки на связанные понятия. Читает и человек, и агент.

Вот и весь «формат будущего». Папка таких файлов (в спеке всю эту папку целиком называют «бандлом»), плюс пара служебных имён (index.md, log.md) для оглавления и истории изменений. Вживую это выглядит так:

knowledge/корневая папка (она же «бандл»)
index.mdоглавление (служебное имя)
log.mdистория изменений (служебное имя)
revenue.mdодно понятие = один файл
orders.mdметрика, таблица, процесс, что угодно
tables/
users.mdвложенность как удобно тебе
Обычные папки и .md-файлы. Открывается в любом редакторе, рисуется на GitHub, читается и человеком, и агентом.

Зачем Google это вообще придумал

А теперь честно про пользу, потому что задумка-то здравая.

У больших языковых моделей есть скучная, но фундаментальная проблема: они умные ровно настолько, насколько ты дал им контекст. Сама по себе модель не знает, как у тебя в компании называется выручка, какая таблица «настоящая», а какая мусорная копия, и что значит загадочный столбец rev_adj_v2.

А знания об этом у любой конторы размазаны тонким слоем по вики, гугл-докам, репозиториям, чьим-то закладкам и голове Сергея из аналитики, который уже в отпуске. Когда ты строишь своего AI-агента, он во всё это утыкается и начинает фантазировать.

OKF это попытка дать всему этому одну общую форму. Чтобы и человек, и агент открывали один и тот же файл и одинаково понимали, что где лежит и что это значит.

Главная мысль

OKF это не магия и не модный значок. Это способ аккуратно сложить знания проекта в вид, который одинаково понимают и люди, и AI-агенты. Придумано ровно для одного: чтобы агенты не путались в твоей предметной области.

А теперь то, от чего у хомяка дёргается глаз

И вот тут включается старая добрая паника: «Google выпустил Стандарт, надо срочно внедрять, иначе отстану от жизни». Скажу прямо и по пунктам, без расшаркиваний.

Это тебя ни к чему не обязывает. OKF не из тех штук, что прилетают сверху с дедлайном. Не тронешь его сегодня, не тронешь никогда, ничего не сломается и ниоткуда ты не «отстанешь».

Это внутренний инструмент, а не новый закон для всех. Google Cloud сделал OKF для дата-команд и AI-агентов внутри компаний. Это как шаблон оформления документов: полезно тем, у кого этих знаний вагон, и абсолютно мимо, если у тебя простой проект с Клодом на пару экранов.

Сама работа это рутина, а не магия. «Опиши все свои знания аккуратными markdown-файлами по спеке» звучит благородно, а по факту это часы перекладывания того, что лежит в голове, вики и чатах, в стройные файлы. Браться стоит, только когда понимаешь зачем, а не потому что «вышло у Google».

Google, кстати, и сам остужал похожий ажиотаж. Когда все носились с форматом llms.txt, Джон Мюллер из Google сравнил эту суету с тегом meta keywords, реликтом, который давно все бросили. Перевод на человеческий: не делайте культ из каждого анонса.

Если коротко

Любой, кто продаёт тебе «внедри OKF за выходные, пока не поздно», продаёт тревогу. OKF никуда не убежит, и срочности в нём ровно ноль.

Так кому оно реально надо

Не простому проекту на пару экранов. А тебе, если ты строишь что-то серьёзное поверх AI.

Если у тебя есть свой агент, бот или RAG-система, которым нужно понимать твою предметную область (твои таблицы, твои метрики, твои правила), вот тут OKF в кассу. Вместо того чтобы скармливать модели хаотичную кашу из доков, ты складываешь знания в предсказуемую форму. Сегодня их читает твой агент, завтра, может, чужой инструмент, и переписывать ничего не придётся.

То есть ценность не в том, чтобы быстро внедрить и радоваться галочке, а в дисциплине: один раз причесал знания по-человечески, и дальше ими удобно кормить любые модели.

Что делать прямо сейчас

Спокойно. По порядку.

  1. 01

    Не паниковать

    Если ты не строишь AI-системы, OKF тебе прямо сейчас просто не нужен. Можно закрыть тревожный гайд и спокойно жить дальше. Никаких действий, серьёзно.

  2. 02

    Запомнить идею, а не формат

    Главная ценность тут не спека, а привычка держать знания в чистом читаемом виде: markdown, понятные названия, одно понятие на один файл. Это окупается и без всякого OKF.

  3. 03

    Присмотреться к OKF, если строишь своего агента

    Делаешь бота, RAG или внутренний AI-инструмент? Вот тогда стоит почитать официальную спеку и сложить свои знания в этот формат. Один обязательный type, остальное по вкусу.

Вывод

OKF это не новый ритуал и не палка, которой Google кого-то гонит. Это удобный, честный формат для знаний, которыми кормят AI-агентов. Паниковать незачем, а присмотреться, если ты в теме агентов, точно стоит. Делать вид, что без него твой проект развалится, не надо.

Что дальше

Такие разборы выходят регулярно

Короткие мысли и находки я публикую в телеграм-канале, а глубокие разборы, курсы и сообщество, где растут инженеры, живут здесь, в Lab.

Заведи аккаунт в ITUZOV LAB

Зарегистрироваться