Практычныя прытамулі: Агентныя архітектуры — Стаття 15: Модель зреласці
Практычныя прыказкі: Агентныя архітектуры — Стаття 15: Модель зреласці: контракты, перакрычанні та слоты для коду для команд, якія викорыстоўваюць гэты патерн.
У гэтым керавану практычным спосабам перакладзена вся дорага ад сыр'ёў да рабочай системы для: Агентных архітектураў — Стаття 15: Перагляд модэлі зреласці. Акцэнт ставяцца на практычныя крокі, чыстае перакананне і код, які можна проста дадаць у репазітарый без неабязковасці здогадвацца пра мету. У стадзіі агледку неабходна практычна з'явіць інпуты, адпаведальную особу за крок і критэрыя завершэння прычым перамене коду. Аперацыйныя працавнікі должны магчымае перадзеўсці крок з вядомага пункта контролю без неабязковасці здогадвацца пра схованы стан. Спрыяйце гэтай стадзіі як даговору межа інпутамі і практычна перакананым выходам. Дайце назву артыфактам, практычна з'явіць перакананні на успех і адмовіцеся ад бяспечнага частковага завершэння.
Што вы знайдзеце тут
Калі працюеце над этапам «Што вы знайдзеце», спачатку запісайце умовы контракту: неабяжлівыя даны, сигнал успеху і тое, што выканаецца у разы ўзельнага неякшага рэзультата. Такі чарточка дапамагае заліцвачваць будучыя змены ў кодзе. Запісвайце час выканання і кост токена або запыту праза функцыйнальныя рэзультаты. Відразлівасць коста з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя среды. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадзесланне ідэнтычных прамаўляючых частак — частая прычына некантрольаваных витрац.
Модэль зроўналежнасці, паглядзелы ўтрох
Калі працюеце над стадзіяй «The Maturity Model Seen», спачатку запісайце контракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неяксамоства. Такі список пераканальвае ў тым, каб пазнейшыя змены коду былі чыстымі. Зберагайце настройкі за межамі коду прыемлена. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжлівага чытання всей структуры. Кэшавайце стабільныя інструкцыі системы і схемы інструментаў. Перадача ідэнтычных прамулі ёсць частым выклікам затрат энергіі.
+---------+---------------------+------------------------------------------+
| Level | Capability | Articles That Build It |
+---------+---------------------+------------------------------------------+
| Level 1 | Reactive | Article 4: Protocols (MCP, A2A) |
| | Responds to inputs, | Basic tool use, standard interfaces |
| | calls tools | |
+---------+---------------------+------------------------------------------+
| Level 2 | Assisted | Article 5: Harness Engineering |
| | Shaped behavior, | Article 13: Human-in-the-Loop |
| | human oversight | |
+---------+---------------------+------------------------------------------+
| Level 3 | Supervised | Article 6: Multi-Agent Orchestration |
| | Coordinated, | Article 8: Evaluation Pipelines |
| | evaluated, secured | Article 9: Security and Red-Teaming |
+---------+---------------------+------------------------------------------+
| Level 4 | Autonomous | Article 7: Memory Architectures |
| | Operates | Article 10: Cost Optimization |
| | independently at | Article 11: Deployment Patterns |
| | scale | Article 14: Goal-Directed Loops |
+---------+---------------------+------------------------------------------+
| Level 5 | Self-Improving | Articles 7 + 8 combined |
| | Learns from its own | Article 12: The frontier (not yet here) |
| | operation | |
+---------+---------------------+------------------------------------------+
Што змянілася ў падходзе
Калі працюеце над этапам «Што змянілася», спачатку запісайце угоду: неабяжлівыя даны, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў ёсць частью продукту, а не пазнейшым дапрацоўкам. Зберагайце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадача таго ж самога прамэра є частым выклікам для ресурсаў. Калі працюеце над этапам «Што змянілася», спачатку запісайце угоду: неабяжлівыя даны, сигнал успеху і тое, што выходзіць у разе частковага невыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрыймайце этап як угоду межа данымі і перакананымі выходнымі даннымі. Даўце назвы элементам, задайце критэрыя успеху і не падтрымвайце тыхню частковую завершэння.
Слоі, якія накладаюцца
Этап «Слоі, які складаюцца» працуе наяўней, калі яго розглядаць як вимерную паверхню. Запісаце адна «золатая» транскрыпцыя, адин прыклад неудачы і запіс пра відкатанне раней, чым расширваць масштабы. Запісвайце часы выканання і кост токенав або запита праза функцыональныя рэзултаты. Відразувая видавальнасць костаў запобегае неспакойным рахункам, калі процес пераходзіць з дэмавай версіі ў спяльныя сераўысы.
+==========================================================================+
| HUMAN OVERSIGHT LAYER |
| Approval gates, escalation, audit trail (Article 13) |
+==========================================================================+
| | |
+==========================================================================+
| GOAL & LOOP LAYER |
| ReAct / Plan-Execute / Reflexion, goal revision (Article 14) |
+==========================================================================+
| | |
+==========================================================================+
| ORCHESTRATION LAYER |
| Supervisor-worker, pipeline, fan-out, debate (Article 6) |
+==========================================================================+
| | |
+==========================================================================+
| HARNESS LAYER |
| Self-verification, loop detection, reasoning routing (Article 5) |
+==========================================================================+
| | |
+--------------------------------------------------------------------------+
| MODEL LAYER |
| AWS Bedrock: Claude 3.7 / 3.5 / Haiku |
+--------------------------------------------------------------------------+
CROSS-CUTTING CONCERNS (touch every layer above):
+----------------+ +----------------+ +----------------+ +----------------+
| MEMORY | | EVALUATION | | SECURITY | | COST |
| Article 7 | | Article 8 | | Article 9 | | Article 10 |
| episodic, | | offline+online | | injection def, | | model routing, |
| semantic, | | LLM judge, | | guardrails, | | caching, |
| procedural | | regression | | red-teaming | | batch, budget |
+----------------+ +----------------+ +----------------+ +----------------+
+--------------------------------------------------------------------------+
| DEPLOYMENT LAYER (Article 11) |
| Blue-green, canary, state migration, model pinning, IaC |
+--------------------------------------------------------------------------+
Што ўсё яшчэ не выявлена
Этап «Што ўсё яшчэ не рашана» найэфектывней працюе, калі яго спрыяваць як вимерную паверхню. Зафіксавайце адны ідеальны прыклад, адзін прыклад неудачы і запіс пра вярнэнне да поперадньего стану, прычым расшырюючы масштабы. Зберагаўце настройкі паза кодам прыемліка. Файлы сяродавішча, хранільнікі секрэтных дадзеных і пазначкі функцый должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль, не чытаяўшы весь структураны дадзеныя. Задаце ліміт токенав на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расширваюць контекст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакоўныя рахункі.
Як выкарыстоўваць гэтую серыю
Этап «Як выкарыстоўваць гэта» працуе найкраща, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад работы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не наступным етапам дорабкі. Задаце ліміты на колька токеноў за раунд і за сесію. Інструменты-агенты агрэсывна расширваюць контекст; жорсткія ліміты запобегаюць таму, каб дэманстрацыі ператварыліся на неспакоюючыя рахункі. Этап «Як выкарыстоўваць гэта» працуе найкраща, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад работы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Спрыявайце гэты этап як кантракт між вхіднымі даннымі і паўнастацэнаванымі выходнымі рэзультатамі. Назвайце всі элементы, задаце критэрыя успеху і адмовіцеся ад мовчанкавага частковага завершэння.
Прымечанне пра інструменты
Для прыткай на сцэне, перад змінайом код неабяжна адзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыіям павінна быць можлівасць перзапускаць крок з вядомай точкі контролю, не падозрываючы схованы стан. Запісваць трэба час выконання і кост токена або запыту праз адзначэнне функцыйнальных рэзультатаў. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі траекторыя пераходзіць з дэмаверсіі ў спакульнаныя сераўы. Калі наступны крок — гэта код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя даны з паўнай пераверкай схемы, чым вольныя тэкстовыя форматы.
Заключныя размышленні
Для стадіі заключных размышлэнняя неабходна ўскладненне вхідных дадзэнняў, абавесцяванне адпаведальнага за крок і крэтарыяў завершэння працы перад змінай коду. Аператары должны магчымае перадзеісцавіць крок з вядомага пункта контролю, не спрабоўваючы з’ясаваць захаваны стан. Конфігурацыю трэба залічыць параду ад коду прыкладнення. Файлы сераўіса, хранальнікі секрэтных дадзэнняў і флагі функцыйяй должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць, не чытаючы весь ланцуг задач. Калі наступны крок — це код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя данні з перакананнем схэмы, чым вольныя тэкстовыя апісанні.
Чэк-ліст для эксплуатацыі
Стадія чэк-ліста для эксплуатацыі працюе наякша, калі яе спрыймать як мерыемую плошчу. Перад расширэнням масштаба неабходна зафіксаваць адну ідеальную транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану.
Лепш выкарыстоўваць маленькія, тэставаныя елементы, чым велікія скрыпты. Калі крок не выйшаў, прычына неудачы должна вказываць на адну конкрэтную абавесцяванность, а не на заплутаны ланцуг задач.
Бюджет токенаў на адны раунд і на адну сесію. Агентныя інструменты актыўна расшыроюць контэкст; строгія ліміты не дазволяюць дэмам ператварыцца на неспакоўныя рахункі.
Неабходна людская апрацоўка для тых крокаў, якія выкорыстоўваюць грошы або зменяюць данні праўлення. Працэс кампіляцыі не є гарантіяй полнай адпаведнасці да вяроўных умоваў роботы.
Напісце кароткі посібнік: як зменяць канты, як спрачыслаць чергу, як анулюваць пярэдніе дадзеныя.
Канфігурацыю трэба зберагаць паза кодам прыкладнай програмы. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжнага чытання всіх элементаў системы.
Перш чым пераводзіць систему на вышэйшую версію, заморозьце ўсія версіі, зафіксуйце важлівыя данні для критычных траектарыў і паказваце способы анулявання змян. У спільных сяродавішчах неабходны ліміты швыдкасці, пераказы належнасці і чыстае вяскрасленне секрэтных дадзеных. Валіце надзейнасць працы над красавімі, але разовымі дэмамі.
Запіска параграфу f4d1cdcaf736: не трэба кантрацеўваць ключы прадаўцаў у репазітарыі, задаць максімальную кантроль на токены на адну сесію, а таксама зберагчы транскрыпціі праза фіксатуры адлічэння, каб пазнейшыя замены моделей заставалі пораўнанневымі.
Для запіскі параграфу 0 пра зміцнэнне: перад зменай коду неабходна адзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыёныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Канфігурацыю трэба кантрацеўваць за межамі коду прыкладнення; файлы сераўіса, сховішчы секрэтных даных і флагі функций павінны знаходзіцца ў аднам месцы, якое працавнікі можуць аудытаваць, не чытаючы весь граф.
Дзялейны пункт зміцнэння 0/960: для гэтай запіскі трэба мерыць час выканання, класы каштоўкаў і витрату токенаў, а пасля — вырашыць, чы робіць змяну на адной падставе фіксаванага набора пытанняў, а не на адной лячбе.
Калі працуеце над першым этапам зміцнення, спачатку запісайте умовы кантракта: неабяцковыя даны, сігнал успеху і тое, што выходзіць на частым неудачам. Такі список дапамагае залічваць пазнейшыя змены коду чыста і прозрачна. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выходзіць, неудача должна паказваць на адну конкрэтную відпаведальнасць, а не на заплутаны ланцюг задач.
Дзеянне зміцнення 1/960: вымерыце час выканання, класію памылак і колькасць токенаў, якія былі выкарыстоўваны для гэтага пункту, а потым выявіце, чы рашыцца застаўляць змену на адной фіксаванай сэтке пытанняў, а не на адзінственных прыкладах.
Этап зміцнення 2 працюе лепей, калі яго спрыяжваць з мерыемымі показнікамі. Запісайце адны ідеальны прыклад роботы, адзін кейс неудачы і прыказку па абратанні змян перад расшырэнням масштаба. Запісвайце часы выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзултатамі. Відразы гляднасці костаў з самага пачатку запобегае неспакойным рашчыткам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.
Дзеянне паўжчання 2/960: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага зьязначэння, а пасля, на аднойчыне з фіксаваным наборам пытанняў, а не на асобістых спазырэннях, выявіце, чы хацяце застаўіць змены.
Для 3-й стадзіі паўжчання неабходна перад змянай коду чытко визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыйныя працавнікі должны магчымае перадзьвяжаць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабходна адначасна задокументаваць шлях успеху і шлях вяснавання проблем. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней.
Дзеянне паўжчання 3/960: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага зьязначэння, а пасля, на аднойчыне з фіксаваным наборам пытанняў, а не на асобістых спазырэннях, выявіце, чы хацяце застаўіць змены.
Калі працуеце над 4-й стадзіяю практыкы забезпечэння безпекі, спачатку запісайце контракт: неабяжлівыя вхідныя даны, сігнал успеху і тое, што выходзіць на частым неудачам. Такі список пераканаець у тым, што пазнейшыя змены коду будуць чыстымі. Спрыятлівае ставленне да гэтай стадзіяй як да контракта межу вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаце критэрыя успеху і не падзейцеся частым завершэнням задачі без паведамлення.
Дзеянне 4/960 практыкы забезпечэння безпекі: звярніце увагу на час выканання, класы памылак і витрату токенав для гэтай стадзіяй, а пасля выберыце, чы робіць змены на адпаведнасць фіксованаму набору пытанняў, а не на адзінственным прыкладзе.
4-я стадзія практыкы забезпечэння безпекі працюе лепей, калі яе спрыятлівае ставленне як да вимернай плошчы. Запісайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіску пра вярнэнне да пачатковага стану, перш чым расширваце сферу дзейства. Зберагаюце настройкі праз чынны код аплікацыі. Файлы сераўіса, хранільнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць аудытаваць іх, не чытаючы весь код.
Дзеянне паўжчання 5/960: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы хачаце застаўіць змяну.
Для 6-й стадзіі паўжчання неабходна перад змянай коду чытка апісаць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыяныя працавнікі должны магчымае перадзвануць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына нехарактернага рэзультата должна быць адносна конкретнай адпаведальнасці, а не сложнай сэткі крокаў.
Дзеянне паўжчання 6/960: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы хачаце застаўіць змяну.
Калі працуеце над 7-ю стадзіяй забезпечэння безпекі, спачатку запісайце умовы кантракту: неабяжлівыя данні, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі список контроля дапамагае заліцвачыць пазнейшыя змены коду адкрыта і чыста. Запісвайце час выканання задачы, а таксама вартасць токена чыў запиту праз адныя з функцыйнальных рэзультатаў. Відразлівая вартасць з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.
Дзеянне 7/960 па забезпечэнню безпекі: вымерыце час выканання, класію паканаў і вартасць викорыстоўвання токена для гэтай стадзіі, а пасля выберыце, чы хацеце застаўіць змену на адной фіксаванай сэтке пытанняў, а не на адной лічбе прыкладаў.
7-я стадзія забезпечэння безпекі працюе лепей, калі яе спрыямаць як меравальную плошчу. Запісвайце адны ідеальны прыклад роботы, адну справу неудачы і прыказку па абратанні да пачатковага стану, прычым не расшырюючы сферу дзеяння. Дакументавайце як успішны, так і вярнучыся парадкі роботы разам. Перапрыбуткі, людзкія контрольны пункты і обработка неканальных пакетаў ёсць часткай продукту, а не пазнейшым дапрацоўкам.
Дзеянне паўжасткі 8/960: звярніце увагу на час выканання, класы паказчыкаў і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшыцца застаўляць змяну.
Для 9-го этапа паўжасткі неабходна перад змянай коду адзначыць вхідныя даны, адпаведальнага за выкананне крока і критэрыяы завершэння. Аперацыйныя працавнікі павінны магчымае перадзванаць крок з вядомай точкі контролю, не прабуючы спадарацца прыватных станоў. Штодзе гэты этап трэба спрацавваць як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі: дайце назвы артыфактам, адзначыце критэрыя успеху і не прабывайце прыймаць часткова завершаныя рэзультаты без падтверджэння.
Дзеянне паўжасткі 9/960: звярніце увагу на час выканання, класы паказчыкаў і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшыцца застаўляць змяну.
Калі працуеце над 10-ю стадзіяй ударожэння, спачатку запісайце шаблон кантракта: неабяжныя даны, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі список контроля дапамагае залічваць пазнейшыя змены ў кодзе чыста і прозрачна. Зберагайце настройкі праза код аплікацыі. Файлы сераўнавання, хранільнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаюць адбавіць аудыт без неабяжнага чытання всіх элементаў.
Дзялей 10/960 ударожэння: замерайце час выканання, класію каштоўкаў і выкарыстоўванне токенаў для гэтай стадзіі, а пасля выберыце, чы хацяце застаўіць змену, стварыўшы адпаведны набор пытанняў, а не на базе індывідуальных спазыроў.
11-я стадзія ударожэння будзе эфектывная, якшо ёй ставіць задачу стацыонарнае вимераванне. Зберагайце адну ідеальную транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Валіце маленькія, тэставаныя елементы замест вялікіх скрыптов. Калі якась ступеня не выйшла, неудача должна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок дзеянняў.
Дзеянне паўжасткі 11/960: звярніце увагу на час выканання, клас памылак і колькасць викорыстоўваных токенав для гэтага зьязку, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы хацяце застаўіць гэтыя змены.