AI-агенту патрэбен не большы кантэкст, а мозг, якому можна давяраць

Уявіце саблейтар, які запрацавае у 02:14. Вы ачынаеце інструкцыю, і яна выглядае чудова: там ёсць прынцыпаваныя крокі, дыяграма, ясныя знакі таго, што хтось паклопаўся пра гэта. Вы выконваеце 4-й крок, але ён не дапамагае. У ніжней частцы сторанкі вы бачыце дату последней правкі: чатырнацца месяцэў таму.

Кожны абзац у інструкцыі быў правільны ў дзень, калі яго было напісана. Але не было жадных знакоў таго, што ёё тэрмін давальнасці ўжо спыніўся.

Гэта і ёсць справжнія баг. Гэта не нехватка дакументацыі чы неякісная дакументацыя. Гэта дакументацыя, якая выглядае такой жа надзеяным у свой найгоршы дзень, як і ў першы. Протыяўносц часоў сорак гадоў програмнае забезпечэнне выпускалася пад прыняццем правіла, што дакументацыя — гэта проза, і чытальнік сам яе оцінюе. Потым рэпазітарыі перайшлі да агентаў, якія не можуць нічога оцаніць і якія чытаюць кожны слова з абсалютным адказам.

Што змянілася

Агент на базе ШЫ не мае сабее памяці. Ён не мае стану, і ў кожны момент усё спілкуванне падае занова з самага пачатку. У дасягліхханнях Anthropic працэўніках гэта сказана працоўна: кожны раз трэба падаваць цэлую історыю спілкування.

Таму дакументацыя архітэктуры з 4 000 токенамі, якая завжды завантажваецца ў файл агента, чытаецца не адной раз. У сесіі з сорака раундамі яна чытаецца сорак разоў. А яе завантажэнне можа пагоршыць працэздатнасьць агента.

У даследжэнні Chroma па тэме змены кантэксту было перапытана 18 перэдавайныхя модэляў, у тымліво GPT, Claude, Gemini і Qwen, і было зафіксавана, што тачнасьць падае ў меру збільшэння велічыны вхідных дадзенняў — у дзеякіх случаях з 95% да 60%. Тое, што мае змяніць вашы прычыны, — гэта тое, што гэта не ўплыв, блізкі да максімальнага ліміту. Падэйшчанне працэздатнасьці было зафіксавана на кожным роўні дужыны дадзенняў, якія яны перапытвалі. Калі гэтыя нараджэнні будуць правдзівымі, нават вікна з мільйонам токенама пачнуць падвергацца проблемам ўжэ на роўні пяцідзесят тысяч токенама, адтуды, што галоўным працоўнікам ёсць шум, а не ўместнасьць.

Anthropic гэта апісвае як бюджэт увагі: кантэкст — гэта скончаныя рэсурсы з зменшаючыміся гранулярнымі рэзультатамі, а мета — максімальна колькасць токенав з высокім сігналам. Гэта залучае два паслаблівыя варыянты.

• Завантажыць усё. Агент знае сістэму, але ў кожнай задачы ўражаецца менш эфектыва, а кожная правка дакумента анулюеўкае весь кэш запытанняў і змушвае перзавантажыць яго.
• Не завантажыць нічога. Агент застаецца спрытным, але нічога не знае, таму ён імпровізуе. Ён стварае новы крок запуску або выкананае команду, якая ужо была знята ў марцы.

Команды выбіраюць адны з варыянтав, страждаюць ад наследкав, а потым пераходзяць на іншы. Самэ гэта сёння і ёсць станом галузі.

Ужо існуе дыягназы на аднае рэчэнце

У квітні 2026 года Андрэй Карпаты публікав короткія туторыялы, якія называў файламі з ідэямі. Гэта не было ні продуктам, ні бібліятэкай. У ягох быў опісаны адны падход: мадэль ператварае сырые даны на аднародны, структураваны Markdown-вікі, і з таго часу запытанні направляюцца да гэтага вікі, а не да первых джэрэл.

Фраза, якая ў ягох мае значэнне, не мае нічынага з ШЫ: людзі застаўляюць вікі, таму што навантажэння з ўтрыманняў расце быстрэй, чым ўжоць цяныхасць.

Кожны, хто бачыў, як гінуў які-небудзь простор Confluence, адразу ж гэта упазнае. Людзі не пакінулі яго таму, што было важка пісаць. Яны пакінулі яго таму, што была важка ўтратацыя, а ўтратацыя здэйснюецца пераважна адносна бюрократычных задач: апавежыць пра змяненыя лінкі, апдэйтаваць падсумак, пазначыць, што гэная стораніца цяпер суперасходзіцца з іншай, пасправіць індэкс. Гэта самэ тае завадзе, якое перэстало быць дорогім, адтолькі што LLM не вярожыцца, не забывае прыкладніяя паўзы і можа обработаць панздзесят файлоў за адну паўзу. Яго разпад працы просты: вы чытаеце, а LLM пісае.

Суць гэтага быстра распраслалася. Чырэз два месцы Google Cloud выдала спецыфікацыю, якая, за яе ж заявамі, формалізуе патэрн LLM-вікі ў портатыбны, інтэроперабельны фармат. Основная дыягноз застаецца дыягнозам Карпаты, і самэ гэта ўскладніць, чаму ўсё гэта працюе сёньня, а не ў 2019 годзе.

OKF за палавіну хвіліны

OKF, тэкстовы фармат адкрытых ведамаў, быў выпусцаны камандай Data Cloud компаніі Google Cloud у чэрвені 2026 года як праект (v0.2) і ўособліва являе сабою формалізацыю гэтага патэрану. З тэхнічной точкі зору цэе каталог файлаў у фармаце Markdown з прымесамі YAML, і ўсё.

У спецыфікацыі яе сутнасць апісваецца так: кожны, хто можа выкарыстоўваць команду cat для чытання файла, можа чытаць OKF, а кожны, хто можа выкарыстоўваць git clone для копіювання рэпазітарыю, можа яго распрасцвараць.

Толькі адна палата ў OKF ўмовна обав’язковая — type. Файл, у яком толькі палата type, вважаецца супарадным з стандартам. Не трэба ні рэестру схем, ні базы дадзенаў, ні практык убудовы, ні залежнасцяў ад прадавца, ні SDK.

okf/
  index.md                  ← table of contents
  billing/
    index.md
    invoice-retries.md      ← one file, one answerable question
  flows/
    customer-offboarding.md

Калі ваша рэакцыя — «тады, папка з Markdown», то гэта правільна. Фармат не ўсё, што цікава, і адгуком можа быць тое, што папцы не патрабуеяць спецыфікацыі. У ананунце Google ёсць адказ: вікі Карпаты, вікі команды і экспорт каталога прадавца можу выглядаць аднакова, з Markdown, frontmatter і пераходамі, але ніхто з іх не быў створаны для саўместнай працы. У гэтым і справа з спецыфікацыяй. Усе незалежна дасяглі аднаго фармата, што зазвычай значыць, што гэты фармат правільны, а пасля кожная рэалізацыя стварыла своія назвы поль. Фармат ператварае калькі прыватных правіл у ўсё, што агент можа прачытаць будзь-дзе.

Основная ідэя: дакументацыя стае станам

Ось прыклад дакумента:

---
type: Playbook
title: Invoice retry policy
status: stable                      # draft | stable | deprecated
stale_after: 2026-11-01             # stale when today >= this date
generated: { by: "human:dana", at: 2026-08-10 }
verified:  [{ by: "human:sam",  at: 2026-08-11 }]
sources:
  - resource: services/billing/retry.go
    last_modified: 2026-07-15
not:
  - term: "restart the worker to clear the queue"
    why: "in-flight jobs are lost, they are not re-queued"
    instead: "drain first, then restart"
---

Пяць з паказаных поль выйшлі з спецыфікацыі. Шасцое ўсё ценнейша і з’являецца знову ніжэй.

Шухляда проста зберагае дакументы. Мозг таксама знае, што ён зберагае, насколькі ён упэўнены і якія памылкі чамусь яго навучылі. Наступныя элементы адпавядаюць гэтаму:

Тэперы чытайце гэты фронтматэр так, як бы чытала машына. stale_after — гэта дата заканчыцьа тэрміну чыннасці. Гэта не пазнака „пасляльгіншага апдэйту“, якую трэба тлумачыць. Гэта абсалютная дата, якая ператварая працэс пераканання документа ў простаяе паўраненне: today >= stale_after. Гэты контроль можа выканаць хто-небудзь: агент, які чытае файл, запланаваная задача, ваш CI.

Застойцеся над гэтым. Проблема застою дакументацыі ёсць культурным пытаннем з моменту стварэння вікі. Постаўкі прыпомненняў, дні дакументацыі, квартальныя аўдыты, плюс старонка „Стандарты дакументацыі“, якая сама ўжо застаўлася. Усё гэта базуецца на сацыяльным тысле, і нічога з гэтага нельга прымусіць. З stale_after застой стае паўнама невыпаным тэстам, у той жа клас, як і зламаны працэс будавання. Ён або праходзіць, або не праходзіць, і нікому не трэба сабе вадаваць.

Іншыя полья працуюць так сама. sources пераказвае шляхі кода, якія опісвае дакумент, тады скрыпт можа нарэшце адпаведзець на запытанне, на якое вікі ніколі не маглі адпаведзець: гэты pull request змяніў файл, які, як стверджваюць тры дакументы, павінен яго адгукаваць, тады чыі хто яны апошнія адкорэктаваў? verified фіксуе, хто падтвердзіў дакумент, аддзельна ад таго, хто яго напісаў, таму што, як сказана ў спецыфікацыі, той, хто напісаў канцэпцію, не павінен быць тым, хто яе падтвердзіў. Праект агента і затверджэнне старшагінжынера — гэта два аддзельныя прыемы, адзінак, які большасць інструментаў для дакументацыі ніколі не фіксуе. Рэйтынгі доверы вылічваюцца на адварце актара і не зберагаюцца, адтолькі што зберагнуты бал ёсць суб’ектывным, неперэносным між корыстнікамі і з часам стае застарэлым.

status: deprecated дазваляе вам заставіць старую вярсію замест адзіну з яе выдалення. Калі два панелі керавання не пагадваюць адно пра „доход“, прычыной частаюць не паслужны даны. Гэта две вярсіі, адна з яых тыхо заменяецца, але ніякая з іх не пазначаецца. Заставіце обе, пазначыце адну, і цыфры пасляпэльнага квартала будуць як і раней.

Гэта і ўсё змены: не проста лепшы фармат для тэксту, а тэкст плюс можлівасць запытання стану. Дакументы можна адпытваць, тэставаць і пераканацца, што яны не працуюць.

Арыметыка токэнаў

Гэтыя цыфры былі вылічаны на адной з прыкладных комплектацый, публікаваных Google, таму іх можна пераканацца:

Обработка аднаго факту з початку да канца коштае прыблізна 950 токэнаў і выкалічваецца толькі для запітоў, якім гэта неабходна. Частка, якая працуе завжды, належыць да рангу 0: 60 токэнаў, адна рэчэ.

Пораўняйце гэта з тыповым падходам: у кожны запіт дадаецца нарадчык дыялогу дыялогу з 1,600 токэнаў, хоця можа, што толькі адзін з дзесяці запытоў яго патрабуе. Знанні застаюцца тымі ж, сярэдняя сума складае адзін дзесятай часткі, а дакументацыя можа раставаць без ліміту, таму што дадатковая дужына больш не вплывае на некалякуючыя размовы ў рэпазітарыі. Спецыфікацыя створыла index.md на адной з гэтых цэлей і дала яй назву — поступовая адкрыць: спачатку пераканацца, што існуе, а потым адкрываць дакументы.

Што OKF не ёсць

OKF не выступае як захоўні бар’ер. Файл у фармаце Markdown не можа запобiec таму, што агент запустыць шкодзічную дзеяннё. Працызнае выкарыстанне такіх мераў мусі выконваліцца праз код – напрыклад, праз спіскі заборон і хукі перад выконаннем, якія блакуюць дзеяннё незалежна ад таго, калі саме выбраў мадэль. Што б вы ўсё не памяталі, не выводзіце, што проста запісавшы аб парадку, вы ужо захішчаны.

Тое, што насправды дае вам OKF, – гэта агент, які знае правілы. У спецыфікацыі таксама візначаны тып «Attested Computation», па якому агент можа перэдаваць параметры, але ніколі не можа пісаць чы прыменяць змяны да самай процедуры вычыслення, што ўсё, што можна зробіць, каб запобiec перапісву пераканання ў безпеце. Следзіце за гэтым, але пакуль не будуце на ўсём гэтым будаваць: у спецыфікацыі сказана, што інтэрфейс будзе візначаны толькі у пазнейшых версіях.

Пам’ятайце таксама, што гэта ўсьмо праект-праект. Пераход з v0.1 на v0.2 ужо перайменаваў два элементы, таму выберыце толькі восьма полей, якія вам патрэбны. Усе пасляэтапныя перайменавання будуць выкананы за дапамою функцыі пошуку і замены.

Пачніце з малага, дадзіце правіла контролю, калі гэта будзе карысна

Гэта не праект — гэта проста адна файлавая структура.

1. Напісце адны документ пра тое, што неякраз неякраз змусіла каго-небудзь пасвятаваць паўдзень, з паказаннем type, title, description і stale_after.
2. Напісце файл index.md, у яком будзе супакораны гэты документ, з столбцам «Калі чытаць», і дадзіце значэнне okf_version: "0.2". Корневы індэкс — гэта ўсё месца, дзе патрабуецца гэтае поле, і, згідна з спецыфікацыяй, гэта ўсё, што можа мець індэкс у роўні фронтматэру.

Дадзіце адказчык у ваш файл, які застаецца актываўным увесь час. Ёго стоімасць адпаведна шасцьдзесят токенаў, і ён мае шлях плюс трыгар, але ніколі не сумарыз, таму што сумарыз не толькі падвайнае кост актываўнага файла, але і прымусвае агента ачыніць яго.

Гэтага дастаткова, каб запусціць працэс. Паколькі today >= stale_after — гэта проста параване, агент можа яго вырахаваць як толькі файл будзе ачынены. Што робіць з застарэлым дакументам, залежыць ад вас, і спецыфікацыя намерна залішае гэта нез’ясаваным.

Дадзіце аўтаматызацыю тады, калі другі чалавек можа знеасабліваць ваш дакумент без яго чытання. Гэта справжнія праг, і ён стосуецца больш розмеру команды, чым правільнасці. Калі у вас толькі пяць дакументаў, вы заўважыце проблему, і дастатнек будзе перагляду тэрміну давальнасці з боку агента. У командзе той, хто парадоксальна знеасаблівае ваш дакумент, па значэнні ёсць тым, хто ніколі яго не ачынаў, таму добрыя намеры не можу да яго дасягнуць, і чыгульнае ў працэсе падачы запрошэння на зміны павінна гэта зробіць. Дышэўская версія — цэе запланаваная задача, якая адмаўляе прыпыненыя дакументы. Моцная версія — цэе контрольнае пункт запрошэння на зміны, які блакуе пры прыпыненым дакуменце і паднімае апавешчэнне, калі код, які опісвае дакумент, быў зменены. Пачніце з дышэўскай версіі.

Короткая версія

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

Да дальнейшага чытання: спецыфікацыя OKF v0.2 і прыкладныя пакеты, параграфы Google Cloud пра гэты фармат, статыкі Anthropic пра інжынерыю кантэксту, навыкі агентаў і кэшаванне запытанняў, а таксама даследжэння Chroma пра змяну кантэксту.

Спадзяючыся чытання

• Практычныя прытамулы: ваш агент для кодавання не патрэбуе большэй кантэксту. Йому патрэбна карта. — Практычныя інструкцыі па вікорыстоўванню прытамулаў: ваш агент для кодавання не патрэбуе большэй кантэксту. Йому патрэбна карта: контракты, перакрыццяі і месцы для вставкі коду для команд, якія выкарыстоўваюць гэты патэрн.
• Практычныя прытамулы: ваш агент для кодавання не патрэбуе лепшаг запіту — Практычныя інструкцыі па вікорыстоўванні прытамулаў: ваш агент для кодавання не патрэбуе лепшаг запіту: контракты, перакрыццяі і месцы для вставкі коду для команд, якія выкарыстоўваюць гэты патэрн.

Практычныя прыемы: Israeli Tech Radar 2026-27: Інжынерыя ў эпоху агентаў — Дэталізаваны апіс практычных прыемаў: Israeli Tech Radar 2026-27: Інжынерыя ў эпоху агентаў: контракты, перакананні і шаблоны коду для команд, якія вікорыстоўваюць гэты падход. —