Google Cloud предложила формат OKF для знаний AI-агентов

Группа инженеров из Google Cloud 12 июня 2026 года анонсировала открытый формат Open Knowledge Format (OKF). В нём предложена концепция LLM-wiki: knowledge bundle — каталог Markdown-документов с YAML frontmatter. В начале каждого файла прописан блок метаданных со структурированным контекстом, нужным агенту для работы с проектом.

Спецификация умещается на одной странице. Ключевое свойство формата — знания одинаково читаются человеком и LLM. Пакет OKF состоит только из файлов: его можно отправить архивом, разместить в git-репозитории или подключить к файловой системе. YAML-преамбула содержит небольшой набор полей: type, title, description, resource, tags и timestamp.

Что нового в v0.2

24 июля 2026 года та же группа инженеров выпустила обновление OKF v0.2, посвящённое доверию в агентных системах. Появились механизмы, позволяющие агенту учитывать происхождение, подтверждение и актуальность знания. Само по себе это не устраняет галлюцинации, но даёт агенту дополнительные сигналы для оценки источника.

В YAML добавили необязательные поля:

• Provenance — откуда взяты данные;
• Trust — кто создал и кто проверил информацию, человек или алгоритм;
• Lifecycle & Freshness — статус документа и дата, после которой знания считаются устаревшими;
• Attestation / Attested computations — было ли вычисление выполнено заявленным способом.

Практика: от AGENTS.md к структуре

Автор статьи на Хабре Стас Васильев рассказал, как применил OKF в своих проектах. По его словам, вместо одного файла AGENTS.md на 500 строк получается сфокусированное ядро примерно на 60 строк и более 25 тематических файлов, которые загружаются по необходимости. Такой подход называют lazy-loaded: агент не держит всё в контексте, а получает информацию тогда, когда она нужна.

В структуре AGENTS.md выполняет роль точки входа и маршрутизатора по базе знаний. Тематические файлы — architecture, setup, CI, codestyle, security, testing, API, performance, release и другие — загружаются по запросу. Отдельные рабочие директории — issue/, playbook/, pr/, analysis/, runbooks/, archive/ — хранят создаваемые в процессе работы материалы.

В описании OKF у Google присутствует идея progressive disclosure: агент или человек двигается по дереву знаний постепенно, не загружая весь bundle в контекст. Васильев отмечает, что использует Opencode и ориентировал шаблон на его требования, но доработать под другого агента несложно.