Практычныя прытамулі: Архітектурныя шаблоны інжынерыі контэкста для агентаў AI — А

Існавайце гэта як перапрацоўаную версію ідэй з кнігі “Context Engineering Architecture Patterns for AI Agents — A Practitioner’s Guide”, адпрацоўаную для аператараў: чыткія этапы, аранжаваныя блакі коду і прыметкі з вяселення, якія застаюцца пасля перадачы.

Архітэктурныя вядомасці пра чатыры сталоўкі, кэш KV і дрэва рашэння — для спецыялістаў, якія ствараюць прыменныя AI-агентаў.

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

Што вы навучыцеся

Этап «Што вы навучыцеся» работае наяўней, калі яго спрыяваць як мерыемую плошчу. Запісайце адну ідеальную транскрыпцыю, адзін прыклад неудачы і прыметку па адвярненню змян перш чым расширваць масштаб. Запісвайце часы выканання і косты токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае паказанне костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы. Храніце стан графа простым і з адначыяным типам дадзеных. Вкладаныя блокі маскуюць інфармацыю пра тое, який вузел запісаў кожны поле, і спакшваюць продажчык пасля перарываў.

Агент без архітектуры памяці — гэта агент з амнезіяй

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

Чаму падышча якості ў некалькі разоў є матэматычна немінучая

Заніжэнне якосты краща ўсвядомляць матэматычна, калі яго расследаваць як вимерную плошчу. Запісайце адны ідеальны прыклад роботы, адну справу з бягам і прыметкі па вярнэнню да пачатковага стану пры перадзеяванні масштаба. Дакументавайце як шлях успеху, так і шлях вярнэння да нормы. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є часткай продукту, а не наступным етапам дорабатка. Храніце стан графа ў простам і типаваным формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакшуюць продовжэнне роботы пасля перарываў.

Трывога ў контэксте — калі модель “вядома”, што ёй заканчываецца RAM

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

LLM — гэта CPU, контекст — гэта RAM: падход, які зменяе архітектуру

На стадыі, калі LLM выступае як CPU, пярэд тым, как зменіць код, неабходна ясная ваказка пра вхідныя даны, адпаведальнага за кожны крок і критэрыя завершэння. Аперацыяныя системы должны магчымаць перзапуск кроку з вядомай точкі контролю, не прабуючы спадарацца прыватны стан. Конфігурацыю трэба знаходзіць за межамі коду прыемліка. Файлы сераўнавальнага сераўса, хранілішчы секрэтных данных і флагі функцыйяў должны быць аднароджаны ў аднам месца, якое аперацыяныя системы можаць пераглядаць, не чытаяўшы весь код. Калі наступны крок — гэта код або вызов інструмента, лепш выкарыстоўваць структураваныя выходны даны з перакананнем ў правільнасці схемы, чым вольныя тэкстовыя апісанні.

Іерархія памяці агента

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

Чатыры столпы — Запіс, Выбор, Компрэсія, Ізоляцыя

Для стадіі «The Four Pillars Write» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выканаецца, прычына нехарактэрства должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны процес. Заставіць людзкую апраўдку для тых крокоў, якія выкарыстоўваюць грошы чы зміняюць даны ў працэсе. Компіляцыйныя налашчанні не ўзначаюць павнае адпрацоўвання задачы. Для стадіі «The Four Pillars Write» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Запісвайце час выканання, а таксу токенаў чы запытаў разам з функцыйнальнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмовай среды ў спаканую.

.

Запіс — Экстерналізацыя стану

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

Выбіранне — Зялёны рэтрыўванне

Калі працюеце над стадзіяй Select Just-in-Time Retrieval, спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неяксамоства. Такі список пераканаецца дапамагчы залічваць змяны ў кодзе адпаведна. Дакументавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некоректных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Змяроўвайце рэкалі на фіксаваным наборы пытанняў прычымо да налаштавання запрасаў. Частыя змены запрасаў рэдка калі выправляюць слабую систему адзысквання інформаціі.

Складзенне — змена об’ёму

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

Ізоляцыя — Разлік па саб-агентах

Этап ізоляцыі па саб-агентах працюе найэфектывней, калі яго розглядаць як вимерную паверхню. Зафіксавайце адны «золаты» транскрыпт, адны прыклад неудачы і запіс пра вярненне да пачатковага стану, перш чым расширваць масштабы. Зберагаюце конфігурацыю пазначкі за межамі коду прыемлі. Файлы сераўнавальнага сэрвісу, хранілішчы секретных дадзеных і флагі функций павінны знаходзіцца ў адном месцы, куда аператары можуць аудытаваць іх, не чытаючы весь граф. Зберагаюце стан графа у простам і типаваным формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў якое поле, і спакоююць працэс пасля перерываў.

KV Cache — Метрыка, якая дазволяе архітекторам спаць спакойна

Этап KV Cache The Metric работае наяўней, калі яго спрыяваць як мерыябельную паверхню. Зафіксавайце адна ідеальная транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є частью продукту, а не наступным этапам дорабкі. Храніце стан графа ў простам і типаваным формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакоююць продовжэнне роботы пасля перарываў.

Эканаміка агента і кэшаванне

Этап «Эканоміка агента» і кэшаванне працюе найкраща, калі яго розглядаць як меркавыя елемент. Зберагчыце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг дзеяння. Рэжым графа павінен быць простым і з адначытаемымі даннымі. Вярнутыя структуры данных маскуюць інфармацыю пра тое, який вузел запісаў кожны поле, і спаказваюць роботу пасля перарываў. Этап «Эканоміка агента» і кэшаванне працюе найкраща, калі яго розглядаць як меркавыя елемент. Зберагчыце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Запісвайце часы виконання і косты токенав або запита разам з функцыональнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмавайнага режыму ў спяльныя сераўы.

Тры правілы для зберагчэння кэша

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

Тры системы, тры філасофіі кантэкстнага адарожнення

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

Claude Code — Static Preload + JIT

Для стадіі Static Preload у Claude Code неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшаў, прычына нехасабності должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны процес. Заставіць людзкую апраўдку для тых крокоў, якія выкарыстоўваюць грошы чы зміняюць даны у працэйным серавере. Компіляцыйныя налашчэння не ўзначаюць полной готовасці рашэння для бізнесу. Для стадіі Static Preload у Claude Code неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісваць час выконання і вартасць токенаў чы запытаванняя разам з функцыйнальнымі рэзултатамі. Відразувая візуабільнасць вартасцей запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльнае серавера.

Рэгламенты.

Cursor — Двух-рэўенювальная, дынамічная аднаходка

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

Manus — Стохастычны спуск градіента

Калі працуеце над стадзіяй Manus Stochastic Gradient Descent, спачатку запісайце умовы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список дапамагае заліцьваваць змяны ў кодзе пазнейша.

Урок на мета-рыхлосці

Калі працюеце над стадзіяй «Урок на мета-рыхласці», спачатку запісайце контракт: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список перакладоў захоўвае чыстасць пазнейшых змян у кодзе. Валічыце маленькія, тэставаныя елементы замест большых скрыптаў. Калі якісь крок не выйшоў, нявыпанне павінна вказваць на адную адпаведальнасць, а не на заплутаны ланцюг задач. Зробіце перапаконтаванне пасля дорогіх крокаў. Система не павинна зноў выраховваць адпаведную плата за вызыв LLM, калі аператар перапрыяўляе роботу да наступнага вузла. Калі працюеце над стадзіяй «Урок на мета-рыхласці», спачатку запісайце контракт: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список перакладоў захоўвае чыстасць пазнейшых змян у кодзе. Запісвайце час выканання і кост токеноў або запытаў праза функцыйнае рэзультат. Відкрытыя данні пра косцы з’являюцца рана, таму не будзе неспакою праз нечаканыя рахункі, калі працэс перайдзе з дамовыя версіі ў спакульнаныя сераўеры.

План — калі чаго выкорыстоўваць і што мерыць

Этап «План: калі выкорыстоўваць» працюе найэфектывней, калі яго спрыяглядаць як мерыемую структуру. Запісаўце адна ідеальная транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да поперадняе стану перш чым расширваць масштаб. Храніце настройкі параду ад коду прыемліка. Файлы сяродавішча, хранальнікі секрэтных дадзеных і флагі функций павінны знаходзіцца ў адном месцы, куды аператары можаць аудытуваць без неабяжнага чытання всіх дадзеных. Храніце стан графа у простам і типаваным формате. Вкладні блокі маскуюць інфармацыю пра тое, який вузел запісаў які поле, і спакоююць працэс пасля перерываў.

Дрэва рашэння для архітектараў

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

Што трэба інструментаваць

Этап «Што інструментаваць» працюе найэфектывней, калі яго розглядаць як вимерную паверхню. Зберагчыце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Валіце маленькія, тэставаныя элементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг задач. Рэзультаты графа павінны быць простымі та з адначытаемым типам. Вярнутыя структуры маскуюць інфармацію пра тое, який вузел запісаў канкрэтны поле, і спакоююць працу пасля перерываў. Этап «Што інструментаваць» працюе найэфектывней, калі яго розглядаць як вимерную паверхню. Зберагчыце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Запісвайце часы выконання і косты токенав або запытак праза функцыйнальныя рэзультаты. Відразувая візуабельнасць костаў запобегае неспакойным рахункам, калі процес пераходзіць з дэмавайнага режыма ў спяльныя сераўы.

Падсумак

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

Чек-ліст для эксплуатацыі

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

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

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

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

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

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

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

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