Практычныя прытамулкі: 3 урокі, якія я выучыў падчас стварэння агентных рабочых практык
Практычныя прытамулкі: 3 урокі, якія я выучыў пад час стварэння агентных рабочых праграм: контракты, перакантрольваннія і месцы для вставкі коду для команд, якія выкарыстоўваюць гэты патэрн.
Наступныя прытамлівкі паказваюць практычны шлях для рэалізацыі ідэй, выказаных у статце «3 урокі, якія я выучыў пад час стварэння агентных рабочых практык». Акцэнт ставіцца на контрактах, пераканальных кроках і месцях для падставкі коду, а не на мотывацыйных аспектах. Калі працуеце над стадзіяй адгляду, спачатку запісайце контракт: неабяжлівыя даныя, сігнал успеху і тое, што вядзецца, калі выйшла частковая памылка. Такі спіс контроля дапамагае залішацца чыстасным пад час будучых змян у кодзе. Спрэцыявляйцеся на гэтай стадзіі як на контракце межа данымі і пераканальнымі рэзультатамі. Дайце назвы элементам, задаце крытэрыя успеху і не падтрымайце частковае завершэння без адпаведных падтверджэнняў.
Некалькі слоў пра мяне
Этап «Некалькі слоў пра мяне» работае наякша, калі яго спрыяваць як мерыемую паверхню. Запісайце адна «золатая» транскрыпцыю, адзін прыклад неудачы і прыметку па адвярненню змян перш чым расшырваць масштаб. Запісвайце часы выканання і косты токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае паказанне костаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя. Храніце стан графа простым і з адначыяным тыпам дадзеных. Вкладаныя блокі маскуюць інфармацыю пра тое, які вузел запісаў канкрэтны поле, і спакшваюць продажчыку працу пасля перарываў.
Урок №1: Чы рэальна нам патрабуецца Bash?
Урок 1. Чы гэтыя працы выконваюцца лепша, калі іх спрыята як до мерымабельнай паверхні. Запісаце адна «золатая» версія, адзін случай неудачы і прыметкі па вярнэнню да пачатковага стану пры расшырэнні масштаба. Храніце настройкі пазырочна ад коду прыемліка. Файлы сераўіснага сераўісу, базы секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць адбавіць аўдыт без неабходнасці чытання всей структуры. Храніце стан структуры ў простам і тыпаваным фармаце. Вярнутыя блокі дакладнаўляюць, канкрэтны вузел запісаў канкрэтную поль, і спакойваюць працу пасля перэрываў.
Урок №2: Шэтан знаходзіцца ў запіце.
Этап «Урок 2: Шаўтан» працюе наякша, калі яго спрыяваць як мерыемую паверхню. Зафіксавайце адна ідэальная транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Задаце бюджэт токенав на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расшырваюць кантэкст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакоўлівыя рахункі. Этап «Урок 2: Шаўтан» працюе наякша, калі яго спрыяваць як мерыемую паверхню. Зафіксавайце адна ідэальная транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Спрыявайце гэты этап як кантракт межа вхіднымі данымі і паверыранымі выходнымі рэзультатамі. Даць назвы артыфактам, задаць крытэрыя успеху і адмовіцца ад мовчанкавага частковага завершэння.
Урок №3: Логаваць. Аналізаваць. Спазіраваць.
Для этапы аналізу журнала дзеяння ў уроцы 3 неабходна пазначыць вхідныя даны, адпаведальнага за этап і крэтыры завершэння пры перадзеі коду. Аперацыйныя працавнікі должны магчыма ўвайсці этап з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Запісвайце час выканання і кост токенаў або запытаў праза функцыйнае рэзультат. Відкрытыя даны пра косцы запобегаюць неспакоўным рахункам, калі працэс пераходзіць з дэмавай версіі ў спяльныя асяроддзя. Пры застосаванні коштаў або змянэ ў продакшн-даных неабходна атрыбут людзкага затверджэння. Праця ў час компілявання не ёсць адпаведнай для пачатку рэальной дзеянняў у бізнесе.
Заключныя меркі
Для этапы «Заключныя заўважэнні» неабходна прадзефінаваць вхідныя даны, адпаведальную особу за крок і крытэрыя завершэння пры перадзмене коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан.
Чэк-ліст для эксплуатацыі
Для этапы «Чэк-ліст для эксплуатацыі» неабходна прадзефінаваць вхідныя даны, адпаведальную особу за крок і крытэрыя завершэння пры перадзмене коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан.
Лепшыя маленькія, тэставаныя елементы, чым велікія скрыпты. Калі якісь крок не выйшае, адказнасць за гэта павінна быць прызначана для адного элемента, а не для заплутанага ланцюга задач.
Неабяжна людская апраўда на тых этапах, дзе выконваюцца расходы чыя зміняюцца даныя для працы. Працэўнае з’ёднанне ў часа компіляцыі не абавесць цэліснасцю бізнес-працэсаў.
Напісце кароткі посібнік: як зменяць кантрольныя клучы, як спрачыслаць чэргу задач, як вярнуць стан да пярэдніх налашоўкаў.
Спрыяйце цэму этапу як кантракту межаў вхідных дадзеных і перакананых выходных рэзультатаў. Дайце назвы всім элементам, задаць крытэрыя успеху і адмовіцца ад мовчанкавага частковага завершэння задач.
Неабяжна людская апраўда на тых этапах, дзе выконваюцца расходы чыя зміняюцься даныя для працы. Працэўнае з’ёднанне ў часа компіляцыі не абавесць цэліснасцю бізнес-працэсаў.
Перш чым запускаць стак, заморозьце версіі, зафіксавце «золаты» транскрыпты для крытычнага шляху і паказайце способы абяроны. У спільных срэдах неабходны ліміты частоты запуска, пераконтроль стану абонента і чысткі власнік для змены секрэтных даных. Лепшая ўзаемна надзея, чым хітрыя разовыя дэманстрацыі.
Прыметка для 5ac2322ce9e2: не кладзіце ключы прадаўцаў у рэпазітарый, задаце верхнюю межу токеноў на сесію і зберагачыце транскрыпты празаўсёды з фікстурамі для ацэнкі, каб пазнейшыя замены мадэляў заставаліся порównанымі.
Для прыметкі па забезпечэнню безпекі этапы 0 паказвайце вхідныя даны, власніка крока і крытэрыя завершэння прычымкі перад зменай коду. Аператары должны магчымае перзапускіць крок з вядомай точкі контролю, не падозрываючы схованы стан. Дакументавайце як успішны, так і вярнучыся шляхы. Праказы, людзкія контралі і обработка некорэктных паведамленняў — частка продукту, а не ўжо пазнейшая дапрацоўка.
Дзеянне паўжасткі 0/858: звярніце увагу на час выканання, клас памылакі і колькасць вікорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай сэтце запытаў, а не на асобістых спазыраннях, выявіце, чы хачаце застаўіць змяну.
Калі працюеце над першым этапам запісу паўжасткі, спачатку запішыце контракт: неабходныя вхідныя даны, сігнал успеху і тое, што выканаецца у разе частковай памылкі. Такі чэрніцкі ліст абавяжае да адкрытых змян у кодзе пазнейша. Спрыятлівае ставленне да гэтага этапу як да контракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаце правілы пераканання успеху і адмовіцеся ад тыхоўкага частковага завершэння.
Дзеянне паўжасткі 1/858: звярніце увагу на час выканання, клас памылакі і колькасць вікорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай сэтце запытаў, а не на асобістых спазыраннях, выявіце, чы хачаце застаўіць змяну.
Этап 2 прыцелення на зміцнэнне работае найкрашча, калі яго расследжваюць як вімерную паверхню. Запісаўце адна «золатая» транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць сферу дзеяння. Зберагаюце настройкі пазырочна ад коду прыемліка. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт без неабяжнага чытання всіх дадзеных.
Дакладнасць прыцелення на зміцнэнне 2/858: вімеравайце час выканання, класію памылак і колькасць вікорыстоўваных токенав для гэтага прыцелення, а пасля, на аднойчынку з фіксаваным наборам пытанняў, а не на адзінчынках з практыкі, выявляйце, чы хацеце застаўіць змяну.
Для трэція ўрагу практыкы забезпечэння надзеі неабходна прадзеяваць параметры вхідных дадзеных, адпаведальнага за выкананне крока і крэтарыяі завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчымае перадзеяваць выкананне крока з вядомай точкі контролю, не прабуючы спадарожваць схованы стан сістэмы. Лепш выкорыстоўваць маленькія, тэставаныя елементы працы ніж велікія скрыпты. Калі крок не выкаанаваецца, прычына неудачы павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач.
Дзеянне забезпечэння надзеі 3/858: памерыць час выканання, класію каштоўкаў і колькасць выкарыстоўваных токенав для гэтай практыкі, а потым вырашыць, чы робіцца змена на адной падставе фіксаванага набору крэтарыяў, а не на падставе індывідуальных спазыроў.
Калі працуеце над 4-й стадзіяю прыемкі з павышэння безпекі, спачатку запісайце умовы кантракту: неабяжлівыя даныя, сігнал успеху і тое, што выканаецца у разе частковага нявыполнення. Такі спіс контроля дапамагае заліцвачыць пазнейшыя змены ў кодзе. Запісвайце часы выканання і вартась токенаў або запытак праза функцыйнае рэзультат. Відразлівась вартасей з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя.
Дзеянне прыемкі з павышэння безпекі 4/858: вымерайце час выканання, класію памылак і вартась токенаў для гэтай прыемкі, а пасля выберайце, чы робіць змены на адной пазначанай базе пытанняў, а не на адной толькі прыватнай інформацыі.
4-я стадзіяю прыемкі з павышэння безпекі будзе работаць наякша, калі яе спрыймаць як меравальную плошчу. Запісайце адну ідэальную транскрыпцыю, адзін прыклад нявыполнення і запіс пра адворачэнне змян, перш чым расшырваць сферу дзеяння. Дакументавайце як «шчаслівы» шлях, так і шлях вяснавання. Перапрыбуткі, людзкія контрольныя пункты і обработка неканальных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней.
Дзеянні паўжасткі 5/858: звярніце увагу на час выканання, клас памылак і колькасць вікорыстоўваных токенав для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набора пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшыцца застаўіць змяну.