Лепшыя практыкі AI-агентаў: інжынерыя абвязкі для прадакшну

Існавайце гэта як перапрацоўаны варыянт ідэй з кнігі “AI Agent Best Practices: Production-Ready Harness Engineering (2026 Guide)” для аператараў: чыстыя этапы, арганізаваныя блакі коду і прыметкі па вяснаванню, якія застаюцца пасля перадачы. Этап “Апглэв” найкрашча працюе, калі яго розглядаць як вімерны элемент. Запісайце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметкі па адвярненню змян прычым расшырэнні масштаба. Запісвайце часы выканання і вартасць токенав або запытаў праза функцыйнае рэзультат. Відкрытая інформацыя пра вартасці запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмавайшнага рэжыма ў спакульнае сераўера.

Што такое Agent Harness (і чаму ён вам патрэбен)?

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

Непераговорныя прынцыпы (з рэпазітарыю)

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

Дэтальны аналіз рэпазітарыю agents-best-practices

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

Файлы-параджэнты за мгновенныя

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

Чаму гэта не «яшчое адно выкліканне»

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

Ключовыя прынцыпы для агентаў, гатовых да выкарыстоўвання ў працэсе (выявлены з кантэнту)

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

1. Мадэль прыявляе — харнес выканае

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

2. Кожны вызов інструмента вяртае рэзультат — нават у разе неудачы

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

3. Рызыкі зменяюць працэс

Метод «3 Risk changes the stage» працюе найэфектывней, калі яго расследжваць як меравальную плошчу. Перш чым расшырваць масштаб, неабяжна зафіксаваць адны ідэальны прыклад працы, адну справу з бягам і прыметку па вярнэнню да пачатковага стану. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына бягу должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Неабяжна вікорыстоўваць інструменты з часткавымі схемамі і чысткімі пазначэннямі побачных эфектаў. Адпаведальныя за эксплуатацыю должны ведаць, якія вызовы моцна зменяюць стан сістэмы, перш чым автаматычна схваліць іх. Метод «3 Risk changes the stage» працюе найэфектывней, калі яго расследжваць як меравальную плошчу. Перш чым расшырваць масштаб, неабяжна зафіксаваць адны ідэальны прыклад працы, адну справу з бягам і прыметку па вярнэнню да пачатковага стану. Неабяжна фіксаваць час выкарыстоўвання, а таксама косцы токенаў чы запытанняў разам з рэзультатамі функцыянальных тэстаў. Візуальная даступнасць косцаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спаканую.

4. Кантэкст складаецца пашагоўна, а не скарбліва

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

5. Длігія заданні маюць бюджэты

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

6. Паўтарыяя неудачы становяцца функцыямі сістэмы

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

Пасоўкавыя інструкцыі: ад ідэі да выпуску з выкарыстоўваннем даных навыкаў

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

Фаза 1: Карта (задавайце правыя запітанні)

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

Этап 2: Адначыць (выбраць рэвень MVP)

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

Фаза 3: План-праект (стварэнне дыяграмы крэплень)

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

Фаза 4: Адкліканне (строга следаваць план-праекту)

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

Фаза 5: Выпуск (аўдыт пры пераходзе на рэальную експлуатацыю)

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

Рэальны прыклад: Агент для аналізу рызыкаў у контрактах

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

Кейс: Аўдыт існуючага агента для даследжэнняў

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

Практычныя патрэбнікі апранавання (з псевдокодам)

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

Канонічны цыкл агента (спрасцаваны)

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

budgets = Budgets(step=25, time=120, tokens=8000, cost=0.50)
context = build_initial_context()
permissions = load_permission_matrix()while not budgets.exhausted():
    response = model.generate(context, tools=typed_tool_schemas)
    if response.finish_reason == "stop":
        break
    if response.tool_calls:
        for tool_call in response.tool_calls:
            if not permissions.is_allowed(tool_call):
                observation = "Permission denied: " + tool_call.name
            else:
                # Execute with risk‑appropriate checks
                if permissions.risk(tool_call) == "external_write":
                    approval = request_human_approval(tool_call.draft)
                    if not approval:
                        observation = "Human rejected: " + tool_call.name
                    else:
                        observation = execute_tool(tool_call)
                else:
                    observation = execute_tool(tool_call)
            context.append(observation)
        # Optional compaction trigger
        if context.token_count() > budgets.token_per_turn:
            context = compact_context(context, preserve_approvals=True)
    else:
        # No tool calls, just final answer
        break

Інструменты: ад паслабелых да хорашых

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

Шары кантэксту для падвышэння эфектыўнасці кеша

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

Layer 0: System policies (stable prefix) → Cached
Layer 1: Agent skill definitions (rarely change) → Cached
Layer 2: User session instructions (per conversation) → Not cached
Layer 3: JIT‑retrieved tool outputs (fresh) → Not cached

Развёртыванне вашага агента: чаму важна інфраструктура

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

Сюды і вступае Aeza.

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

Чаму саме Aeza для заданняў агента?

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

Безпека, стварэнне візуальных дадзеных і ацэнкі (Не прыхоўдзіце гэта)

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

Вывык і наступныя крокі

Ваш план негайных дзеянняў

npx skills add DenisSergeevitch/agents-best-practices -g

git clone https://github.com/DenisSergeevitch/agents-best-practices.git ~/.codex/skills/

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