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

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

Пяць тэрмінаў, з’явленых

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

Проблема з адним файлам, які выкааноўвае ўсё

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

Што змяніла планаванне

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

Трыслойны разлік

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

Слой 1: Правілы/AGENTS.md

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

Ярус 2: Рабочы процес/навык spec-driven

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

Слой 3: Падчынныя агенты/пяць ізольаваных працоўнікаў

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

«Клей»/«хакі»

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

Ішчо адна наявнасць: MCP

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

Як усё з’яўляецца ў зв’язку

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

Што насправды дае нам разделенне

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

Куды далей

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

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

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

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

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

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

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

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

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

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