Практычныя прытамулі: Сяйво модульнага манорепа ў эпас агентных систем
Практычныя прыказкі: Сяйво модульнага манорепа ў эпас агентных систем: контракты, перакрыцчы і слоты для коду для команд, якія викорыстоўваюць гэты патэрн.
У гэтым карыце практычным напамінанні перакладзенаецца шлях ад сыр'ёў да рабочай системы для проекту «Сяйво модульнага монорепа ў эпас агентав». Акцэнт ставіцца на практычныя крокі, чысткія пераконтрацыі і код, які можна проста дадаць у репозытарый, не прабуючы здогадвацца пра мету. У стадіўцы «Аптаварыс» неабходна з'явіць вхідныя даны, абавесцю кроку і критэрыі завершэння пры перадзеяванні коду. Аператары должны магчымае перадзеяваць крок з вядомай точкі контролю, не прабуючы здагадвацца пра схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына нехацкага рэзультата должна быць адносна конкретнай абавесці, а не сложнай сэткі крокаў.
Кластер репозытарых і слепы агент
Калі працуеце з The Repo Cluster і стадзіям, спачатку запісайце угоду: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список пераконтроўвае, каб пазнейшыя змены коду былі чыстымі. Спрыятлівае ставленне да гэтай стадзіі як да угоды межа даннімі і перакананымі выходамі. Дайце назву артыфактам, задаце перакананні на успех і адмовіцеся ад тыхоўага частковага завершэння. Зробіце перакананне пасля дорогіх крокаў. Продовжэнне не павінна зноў стаўіць плату за той самы вызов LLM, калі аператар прабуе зноў запрацаваць з пазнейшым вузлам.
Не-модулярны Monorepo і загублены агент
Калі працуеце над проектамі The not-modular Monorepo і stage, спачатку запісайце умовы викорыстоўвання: неабходныя даны, сігнал успеху і тое, што выходзіць па частым няудачам. Такі список дапамагае заліцварыць будучыя змены коду. Запісуйце час виканання і кост токена або запыту разам з рэзультатамі функцыйнасці. Відразлівыя даны пра косты з’яўляюцца на ранніх этапах, таму не будзе неспакою, калі проект пераходзіць з дэмовай среды ў спакульнаныя сераверы. Зробіце перапачатковую пераўтварэнне пасля дорогіх крокаў. Система не должна зноў нарахоўваць косты за той самы вызов LLM, калі аператар прабуе зноў виконаць пазнейшы элемент.
Што на самай працэ прадае модулярнасць
Калі працуеце над стадзіяй «Што на самай працоўны спосаб дае модулярнасць», спачатку запішыце контракт: неабходныя вхідныя даны, сигнал пра успех і тое, што выходзіць у разе частковага абякання. Такі список контроля дапамагае залічваць пазнейшыя змены ў кодзе чыста і прозрачна. Зберагайце настройкі паза кодам прыемліка. Файлы сераўнавання, храненні секрэтных данных і флагі функцый крануцца ў аднам месцы, якое аператары можаць пераглядаць без неабясненага чытання всіх элементаў системы. Стварайце контрольныя пункты пасля дорогіх крокаў. Система вярнення роботы не должна знову ставіць плату за той самы вызов LLM, калі аператар перапрыямляе роботу да наступнага элемента. Калі працуеце над стадзіяй «Што на самай працоўны спосаб дае модулярнасць», спачатку запішыце контракт: неабходныя вхідныя даны, сигнал пра успех і тое, што выходзіць у разе частковага абякання. Такі список контроля дапамагае залічваць пазнейшыя змены ў кодзе чыста і прозрачна. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок абякае, прычына абякання должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач.
Кожны ўстатку можна альбо запрацаваць, альбо пераканацца ў яго надзеях
Этап «Кожны ўстатку можна альбо запрацаваць, альбо пераканацца ў яго надзеях» работае наўсёрэдзе, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Спрыявайце этап як даговор межа вхіднымі даннымі і паверылымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаць критэрыя успеху і не падтрымайце тыхі частковыя завершэння. Адкройце інформацыю пра ўстатку з вузкімі схемамі і чыткімі пазначкамі пра побачныя эфекты. Адпаведальным адміністраторам неабходна знаты, якія вызовы моцу зменіць стан, перш чым яны автаматычна схваляць іх.
Чыстая працоўная пазічка
Апаратна сцэна чыстага контрапункту працюе наяўней, калі яе спрыяваць як мерыемую паверхню. Запісайце адна «золатая» транскрыпцыю, адин прыклад неудачы і прыметку па вярнэнню да пачатковага стану пры расшырэнні масштаба. Запісвайце часы выканання і косты токеноў або запытак па боку ад функцыйнальных рэзультатаў. Візуабельнасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы. Храніце стан графа ў простам і типаваным формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў які поле, і спакшваюць продажчыку роботу пасля перарываў.
Сяйво
Этап «The The Shine» працюе найкраща, калі яго розглядаць як вимерную паверхню. Зберагчыце адны ідеальны прыклад, адзін кейс неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Храніце настройкі парадульна ад коду прыемліка. Файлы сераўнавання, хранальнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяжнага чытання всіх дадзеных. Храніце стан графа ў простам і типаваным формате. Вярнутыя структуры дадзеных маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакоююць продаж чытання пасля перерываў. Этап «The The Shine» працюе найкраща, калі яго розглядаць як вимерную паверхню. Зберагчыце адны ідеальны прыклад, адзін кейс неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу дзеяння. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісьць крок не выйшла, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцоўкі дзеяння.
Чэрніца для аператывных дзеянняў
Этап стварэння чек-ліста для аператыўных задач работае наякша, калі яго спрыяваць як мерыемую структуру. Запісаўце адна ідеальная версія працы, адзін кейс неудачы і прыметкі па вярнэнню да пачатковага стану пры расшырэнні масштаба.
Документавайце як шлях успеху, так і шлях вярнэння да нормальнага стану разам. Практыкі перапрыбутку, людзкія контрольныя пункты і обработка некоректных звесцей ўжо є частью продукту, а не дадатковым элементам пасля його стварэння.
Зберагайце стан графа ў простам і типаваным формате. Вкладзеныя структуры маскуюць інфармацыю пра тое, який вузел запісаў кожна поль і спакоююць продовжэнне роботы пасля перарываў.
Калі бюджет дазволяе, дадаўце тэст на першыя перакананні, які працюе з критычным шляхам у системе CI за дапамогою фіксатываў, а не з рэальнымі платнымі API.
Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшаў, прычына неудачы павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач.
Зберагайце стан графа ў простам і типаваным формате. Вкладзеныя структуры маскуюць інфармацыю пра тое, який вузел запісаў кожна поль і спакоююць продовжэнне роботы пасля перарываў.
Перш чым запускать стак, заморозьце версіі, зафіксавайце ідеальны транскрыпт для критычнага шляху і паказвайце спосабы абяроны. У спільных средах неабходны ліміты частоты запытоў, пераканання ў належнасці ресурсаў і чысткі власнік для змены секрэтных даных. Лепш выбіраць простую надзею на надзейнасць, чым хітрыя експерыментальныя дэманстрацыі.
Прыметка для 441e80b6c64d: не кладзіце ключы прадаўцаў у репазітарый, задаце верхнюю межу токенав на сесію і зберагачыце транскрыпты празаўсёды з фіксатрамі ацэнкі, каб пазнейшыя замены модэляў заставаліся пораўнанымі.
Прыметка па забезпечэнню надзейнасці для стадіі 0 работае лепш, калі яе спрыямаць як мерыму аспект. Зафіксавайце адны ідеальны транскрыпт, адзін кейс абяроны і прыметку па абяранні раней, чым расшырваць масштаб. Храніце настройкі празаўсёды за межамі коду прыемленае, таму што файлы среды, хранільнікі секрэтных даных і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабходнасці чытання всей структуры.
Дзеянне паўжчання 0/815: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы рэшацца застаўляць змяну.
Для першага этапу запісу паўжчання задаць неабходна вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры зміне коду. Аперацыйныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптаў. Калі крок не выйдзе, прычына неудачы павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны процес.
Дзеянне паўжчання 1/815: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы рэшацца застаўляць змяну.
Калі працуеце над 2-й стадзіяю прыемкі з паўнэйшага захавання, спачатку запісайце умовы кантракту: неабходныя даны, сігнал успеху і тое, што выходзіць па частым неудачам. Такі список контроля дапамагае заставаць пазнейшыя змены коду чыстымі. Запісвайце час выканання і вартасьць токенаў або запытак па боку функцыйнальных рэзультатаў. Відразлівасьць вартасцей з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.
Дзеянне прыемкі з паўнэйшага захавання 2/815: замерьце час выканання, класію паканаў і витраты токенаў для гэтай прыемкі, а потым выявіце, чы хацеце застаўіць змену на адной фіксаванай сэтке пытанняў, а не на адной лічбе прыкладаў.
2-я стадзія прыемкі з паўнэйшага захавання працюе лепей, калі яе спрыямаць як мерыму аб’ект. Запісвайце адну ідеальную транскрыпцыю, адзін прыклад пакана і запіс пра вярнэнне да пачатковага стану, перш чым расширваць масштаб. Дакументавайце як успішны, так і вярнэнчы паты. Перапрыбуткі, людзкія контролі і обработка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней.
Дзеянне паўжасткі 3/815: звярніце увагу на час выканання, класы паказчыкаў і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацься застаўляць змяну.
Для 4-го этапа паўжасткі неабходна перад змянай коду чытко апісаць вхідныя даны, адпаведальнага за выкананне крока і критэрыяы завершэння. Аперацыйныя працавнікі павінны магчымае перадзванаць гэты крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Штодзе гэты этап трэба спрацавваць як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі: дайце назвы артыфактам, апісаць критэрыяы успеху і не прабывайце прыймаць часткова завершаныя рэзультаты без падтверджэння.
Дзеянне паўжасткі 4/815: звярніце увагу на час выканання, класы паказчыкаў і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацься застаўляць змяну.
Калі працуеце над 5-м падземам прыемкі забезпечэння безпекі, спачатку запісайце умовы кантракту: неабяжлівыя даны, сігнал успеху і тое, што выходзіць на частым неудачам. Такі список контроля дапамагае залічыць пазнейшыя змены ў кодзе чыстымі. Зберагаюце настройкі пазначыльна ад коду прыемлена. Файлы сераўіса, хранальнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжлівага чытання всей структуры.
Дзялёўка забезпечэння безпекі 5/815: вымерайце час выканання, класію памылак і колькасць викорыстоўваных токенав для гэтай прыемкі, а пасля выберайце, чы хацяце застаўіць змену, стварыўшы фіксаваны набор пытанняў, а не на базе індывідуальных спазыроў.
5-й падзем прыемкі забезпечэння безпекі работае лепей, калі яго спрыямаць як меравальную плошчу. Запісайце адну ідеальную транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваце сферу дзейнасці. Валіце маленькія, тэставаныя елементы замест большых скрыптав. Калі якісь крок не выйшае, неудача должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач.
Дзеянне паўжырання 6/815: звярніце увагу на час выканання, класыя ошибак і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчыне з фіксаваным наборам пытанняў, а не на асобістых спазырэннях, выявіце, чы хацеце застаўіць змяну.
Для 7-го этапа паўжырання неабходна перад змянай коду чытко визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыяныя працавнікі должны магчымае перадзвануць гэты крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісвайце час выканання і колькасць токенаў або запытак праза функцыйнае рэзультат. Відкрытая інформацыя пра витраты запобегае неспакою, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.
Дзеянне паўжырання 7/815: звярніце увагу на час выканання, класыя ошибак і колькасць токенаў, якія былі выкарыстаны для гэтага зазначэння, а пасля, на аднойчыне з фіксаваным наборам пытанняў, а не на асобістых спазырэннях, выявіце, чы хацеце застаўіць змяну.