Абвязка, цыкл і граф: тры ўкладзеныя ўзроўні сістэмы агентаў кадавання

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

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

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

Аснова архітэктуры

«Harness», «loop» і «graph» — гэта не супернікуючыя школы мышлэння. Гэта тры вярсткі, якія знаходзяцца ўнутры адной сістэмы, распаўзаныя з зэвнішняй стороны на внутранюю: спачатку «harness», потым «graph», пасля «loop», і нарэшце «model».

Кожная вярстка відпаведае за адну задачу. «Harness» керуе тым, чым агент можа трапіцца, чым можа зберагчыць і чым можа бачыць. «Loop» керуе моментам, калі агенту разрэшаецца заявіць пра завершэння. «Graph» керуе тым, хто і калі працуе, серыйна чы сумаветна, і як адпаведныя рэзультаты з’едынаюцца.

Заказ дае рэзультат адразу, таму што неудача ў вырабоцце паказвае прычыну ў адпаведным слое. Фраза «Усё гатова, але не працюе» — гэта проблема цыклу. Фраза «Адзін чалавек працюе добра, але калі працюе команда — усё ламаецца» — гэта проблема графа. Фраза «Забыў прынятая вчора рашынку» — гэта проблема сістэмы керування. Ніхто не павінен здагадватыся, які файл ачынаць першы, і ніхто не намагаецца рашыць проблему архітэктуры, заменяючы мадэль.

Ёсць адна застэрэжнае заўважэнне пры адпрыеме будзь-якіх цыфр. Кожна тут заява у фармаце «Структураваны стэк працюе N разоў быстрэй» ёсць ілюстратывным засобам, а не рэзультатам вімеравання. Незалежных вімераванняў такога роду яшчэ не існуе, і чыстая правда прыносіць большую парадную цэню, чым выдуманыя цыфры.

Тры слоі, адна архітэктура

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

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

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

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

Слой harness: што даецца модэлю

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

Формула простая: агент = мадэль плюс крэпленне. Калі мадэль — гэта двахтар, то крэпленне — цээ весь автомабіль, з шасі, сістэмай пальвавання і датчыкамі. Хорашы двахтар без автомабіля нікуды не дасягне. Лёгка прыймаць гэты слой за санітарную сістэму замест архітэктуры, і гэта была адна з найдорожэйшых памылак у спосабе, якім людзі разумеюць агенты.

Семь файлов, а не фрэймворк

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

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

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

Адна фігура заслуговае на паведамленне пра тое, звядзе ўзята. У паўпораўнанні было выкарыстоўвана калькі агентаў на аднай модэлі, якія працавалі над часткай тэста SWE-bench Verified, і яго публікаваў создаталю аднага з паўпораўнюваных інструментаў, а не нейтральны лабораторыя. У яму было выявлена, што вартасці разлічыліся прыблізна у тры разы пры схожай або лепшай успеху, прычыной чаго быў толькі шар кантэксту і сяродавышча. Спрыймайце гэта як тверджэнне вэндора, а не як незалежныя доказы.

Толькі абяваронныя умовы не вялікія, калі агент перастае працаваць. Гэта адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпаведна адпав

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

Прыўязка доказа да конкрэтнага коміту

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

Толькі клапан падчыркавання доказоў недастатні. Жорсткі ліміт па колькасці ітэрацый і бюджэту, а таксама датчык відсутнасці прыгона, являюцца яго неразлучнымі партнерамі. Без іх цыкл, керованы доказамі, все рава можа прынесці вельмі вялікі рахунок. Аднам з задапісаваных інцыдэтаў было прысвячана чатыры агента LangChain, якія працавалі па зарадзе без урахоўвання бюджэту праўяло 11 дзён, а рахунок склікаўся прыблізна 47 тысяч долераў, пры чым ніхто нічога не зазначыў працоўнай недзею. Гэтыя даны вядомы толькі з вторынных апавяданняў, а компанія іх не падтвердзіла, хоча всі незалежна знайдзеныя крыніцы сагаджаюць пра тое жа. Функцыя абрыву цыклу працюе як запал, перарываючы яго незалежна ад таго, як трымаецца на сваім месцы мадэль.

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

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

Слой графа: калі патрэбны калькі агентаў

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

У 2025 году парадоксальна суперсічна сітуацыя выклікалася ў гэтым аспекце. Адна з вялікіх лабораторыяў опісала мадэль, у якой кілька агентаў разам працавалі з падагентамі, і якая па рэзультатах саўстанавленых там жа лабораторыяй тэстаў на рознагах доследжэннях перавыплывала ад аднаго агента прыблізна на 90 процэнтаў, пры чым гэтыя тэсты фінансаваліся за рахунак додатковых токенаў. Продавець адрахаваў, што адзін агент выкарыстоўвае прыблізна чатыры разы больш токенаў, чым звычайны чат, а сістэма з калькама агентаў — прыблізна паўтроха больш, таму рэальны каэфіцыент эфектывнасці калькама агентаў у пораўнанні з аднім агентам больш прыбліжаецца да трох чытаў чатырох, чым да паўтроха. Валдэн Ян з Cognition выступіў з працоўнаю позыцыяй працупакоўана: разбіўча працу на калькі агентаў без спяльнага кантэксту стварае нестабільныя сістэмы і суперсучыцца прыпускі, які ён адзначыў у сваім паста з чэрвеня 2025 году пад назвай „Не ствараюце калькі агентаў“.

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

Прага дзелімасці

Рэзультаты можна канкрэтна вырачыць. У студзіі за грудзень 2025 года пад назвай „У напрамку наукі пра масштабаванне агентных сістэм“ (Kim і іншыя з Google Research, Google DeepMind і MIT) была вымерана так званая прага дзелімасці. Цэнтралізаваная коордынацыя павышыла эфектывнасць задач, якія можна было адрабатваць паралельна, прыблізна на 81 процэнт, а знізіла эфектывнасць задач, якія выклікалі патрэбу у последовным мышлэнні, на 39–70 процэнтоў; прычым, корыстнае адзінакаванне зменшалася, калі шансы адзінаго агента на выпанне задачы перасягалі апошнія 45 процэнтоў. Гэта ўмерэнне стосуецца тых задач, якія былі выкорыстаны ў той студзіі, а не ўніверсальнага закона.

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

Цяпер вы ведаеце, калі графы дапамагаюць, а калі шкодзяць. Заставало толькі з’едыніць усе тры шары ў адну лінію апрацоўкі.

Інтэграваная пяцьхэтапная лінія апрацоўкі

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

Кожны этап пасваюцца ў адна рэчы і належыць да аднаго слоя:

1. Harness sandbox initialisation вялічыні межы прычымоўна да пачатку работы.
2. Parallel graph fan-out and scoping выдзеляе толькі тыя заданні, якія справды ўздыячны.
3. Local evidence-gated retry loops змушаюць кожны элемент даказваць свою адпаведнасць пры вярненні рэзультатаў.
4. Harness state hashing and token deduplication фіксуе строгія падтверджэння замест абмежаных статыстык.

Адверсарскія «вората» краснай команды, працованыя ў наступным раздзеле.

Найболей корыстныя вынікі суперачынаюць з інтуіцыяй. Ценнае значэнне крыўцяцца з наявнасцю ўсіх пяці стадзій у мінімальнай форме, а не з відшліфаванай версіі, якая складаецца толькі з двух. Простыя адверсарскія «вораты», якія можна запусціць, лепшыя, чым складныя, якія ніколі не будуць створаны.

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

Канвей завершаны, але яго апошняя стадзія заслуговае на свой раздзел, таму што яна стосуецца міфу пра абсалютную бездыфектнасць.

Пятыя ўрадзень: адвэрсарыяя верыфікацыя, зменшэнне і ніколі нуль

Адвэрсарыяй верыфікатор — гэта сваерадзе „вторыя вочы“, якія ніколі не бачылі працэсу напісання коду. Ён пераглядае патч на наявнасць краевых случаў і вразламоў, не бачачы следаў мыслення разрабоў, таму не мае жадных уперадзеўанняў, прынятых тымі разрабамі.

Этот слой выяўляе іншы клас дыфектаў, чым ты, які працуе на адной основе доказаў, але не ўсі дыфекты; кроме таго, жадна задокументаваная сістэма не доходзіць да рэгістру нуля. Даследжэнні модэляў, якія аналізуюць код, паказваюць явна меншыя колькіцтва бягаў, пры тым тыя ж модэлі іноды выдумваюць частку з тых дыфектаў, якія яны фіксуюць. Колькісць тэстаў, якія могуць буць выкорыстаны для атак, зменілася прыблізна на два трохі межы між паколеннямі, але не знікла цэлкам.

Найболей цікавым ўзвешчэннем ёсць апаведанне пра абавязковыя трэнінгі команды атакавальнікаў, якія прайшлі да злучэння, ад распрацоўшчыка пад іменем Dotzlaw. У першай партыі атакі успялі прыблізна у 65 процэнтах случаў. Застосаванне патчаў да вядомых вектараў атак у другай партыі знізіла гэты показнік да 20 процэнтаў, але новая хвіля, якая выкарыстоўвала новыя тэхнікі абходу фільтраў, падняла яго да 85,7 процэнта ў той жа партыі, што даў сумарны показнік за другую партыю адносна 47 процэнтаў. Следаваць трэба як аднаму апаведанню пра практыку, а не як падтверджанай стандартнай практыцы ў галузі.

Зніжэнне, але не нуль

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

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

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

Рэжым Intern проты архітэктуры: цыфры з адзінакамі

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

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

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

Гэта мае значэнне для доверлівасці чытача. Актыўны чытач можа за секунды пераканацца ў правядомым чысле, таму абозначэнне „ілюстратыўнае“ ўскладнівае, а не захоўвае доверлівасць. Калі ў іншых джэрэгах з’яўляецца тверджэнне „структураваная архітэктура працюе N разоў быстрэй“, перад тым, як яму паверыць, запытайцеся пра методыку, якая вядома для кожнага запіту.

Чысла чыста як ілюстратыўныя пазначаны. Аднак мадэлі, якія не працуюць належна ў рэальных умовах, такімі не ўважаюцца.

Чатыры анты-патэрны і ўсілявыя сімптамы

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

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

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

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

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

Неправільная дыягназа можа прынесці рэальныя збыткі. У незалежным даследжэнні 2025 года было зафіксавана, што досвідчыцелі распрацоўшчыкі працавалі прыблізна на 19 процэнта медленней з ай-ты інструментамі таго перыяду над рэальнымі задачамі. Неабяжна памятаць пра наступнае: 16 учаснікаў, кодбазы з мільйонам ліній і інструменты з пачатку 2025 года. Гэта ўзвешаны, але спецыфічны сігнал, а не адгук пра програмаванне з вядомасцю AI в цэлым.

Дыягназ ужэ встановлен. Заставаеся ўсьмо толькі адна запытанне: чы рэшта вашага тэхнічнага стэку вообшча падпадае пад мінімальныя трэбаванні, каб такі падход быў разумным?

Спіс пераканальнай гатовасці

Гэта спіс пераканальных пераказоў, а не повна інструкцыя з эксплуатацыі. У ям пяць короткіх груп, і кожны пункт можна адпаведзець «так» або «нет».

• Інструментары: інструкцыі для хранення дадзеных, якія складаюцца менш чым з трохцеўсот ліній, сандбокс або прынеймнейша межа рабочай дрэвы, стан, які зберагаецца за дапамою комітаванняў і журналу прагрэсу, а таксама кэш рэзультатаў інструментаў, які функцыонуе.
• Цыкл: умова зупінкі, якая базуецца на рэальным кодзе выходу, а не на опісе ў фармаце тэксту, строгія ліміты на колькасць ітэрацый і спроб, а таксама датчык відсутнасці прагрэсу, які фіксуе павтарэнне тых самых адмов.
• Граф: стандартна наявнасць аднаго запісвальніка, паралельная розгалужэння толькі для незалежных задач з рэжымам толькі чытання, а таксама прыстрой для з’еднання галужакоў за дапамою дэтэрміністычных правіл.
• Ацэнка: прынеймнейшая адна дэтэрміністычная пераканальніца, якая выконваецца ў серэдовышы CI, плюс короткая пісьмовая інформацыя, якая чытко адзначае, што означае успех і чаго ён не гарантуе.

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

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

Тры слоі, адна фраза

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

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

Пяць пунктав, якія варта запамятаць:

• Тоўстыяры ўтвараюць вялікія структуры, а не конкуруюць між сабою. Сістэма з harness, графам, цыкламі і модэлем ёсць адной продакцыйной сістэмай, а не трыма супернікаючымі падходамі.
• Сімптамы пазначаюць свой тоеўстыяр: „Усё зроблена, але не працуе“ — гэта цыкл, „Сістэма рушае, калі команда не супрацоўвае“ — гэта граф, а „Забытыя вчорашнія рашэнні“ — гэта harness.
• Оркестрацыя калькольных агентаў не ёсць ні хорашая, ні паследняя; гэта залежыць ад таго, чы задача дзеліцца на часткі, а не ад падабанняў да архітэктуры.

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

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

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

Супаўзяленая літэратура

• Agent Harness, Loop and Graph: Тры ўракі за адпаведныміі AI-агентамі — Чаму ненадзеяныя агенты зазвычай не маюць аднаго з уракоў: каркаса навакола модэлю, цыклу, які базуецца на дапамогах, і явнага графа, а таксама шаблона коду і чарткі для адлучэння бягаў.
• Ваш сэмантычны модэль — гэта API: Стварэнне сертыфікаваных паказначыкаў для агентаў — Чаму AI-агенты ствараюць сабскія ваказанні пра дохады і запасы, і як кераваны сэмантычны модэль з дэталізацыямі, власнікамі і адмовамі дае ўсім іх аднаковы контракт.

Інжыніерыя цікла для AI-агентаў: пяць частак, чатыры формы і стварэнне LangGraph — Як цаленаправлена спроекаваць цікл за агентам: яго пяць частак, чатыры распашчатыя формы, агент для дакладак і прабаў у LangGraph, механізмы захавання ад неудач і калі не трэба вяртацца да цікла.

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