Практычныя нататкі: агент атрымаў JSON-спасылку і сабраў працоўную карпаратыўную праграму
Практычны разбор тэмы «AI-агент, які па адной JSON-спасылцы сабраў працоўную карпаратыўную праграму»: кантракты, праверкі і гатовыя фрагменты кода для каманд, якія ўкараняюць гэты падыход.
Крыніцы: I Gave an AI Agent a JSON URL. It Built a Working Enterprise Grid.
У гэтым карыце парадокс занова створаецца ад сыр'ёчных матэрыялаў да рабочай сістэмы для наступнага: Я даў AI-агенту URL у фармаце JSON. Ён створыў рабочую Enterprise Grid. Акцэнт ставіцца на практычныя крокі, чыстае перакананне і код, які можна проста падставіць у рэпазітарый без неабязковасці здогадвацца пра мету. У стадыі агледзення неабходна практычна з'явіць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння прычымкі коду. Аперацыйныя працавнікі должны магчымае перазапускаць крок з вядомай точкі контролю, не прабуючы здагадвацца пра схованы стан. Запісвайце час выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае праказванне костаў запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя.
Проблема не завжды ў запіце
Калі працуеце над задачай, якая не ўскладнена на стадыю, спачатку запісайце умовы кантракту: неабяжныя даны, сігнал успеху і тое, што выходзіць пад частковым нявыпаннем. Такі спіс пераконтроўваець дапамагае залічыць змяны ў кодзе пазнейша. Зберагайце настройкі за межамі коду прыемліка. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць аўдытаваць іх без неабяжнага чытання всіх элементаў. Зберагайце у кэшы стабільныя інструкцыі сістэмы і схемы інструментаў. Перадача таго ж самога прамэра ёсць частым выклікам затрат рэсурсаў.
Стак кантэксту
Калі працуеце з этапам «Стак тэксту», спачатку запісайце умовы вікорыстоўвання: неабходныя даны, сігнал успеху і тое, што выходзіць на падчасныя неудачы. Такі чэк-ліст дапамагае заставіць пазнейшыя змены коду быць чыстымі. Документавайце як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія контрольныя пункты і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Ставіце контрольныя пункты пасля дорогіх крокаў. Сістэма вярнення не должна зноў ставіць плату за той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел.
Эксперымент першы: JSON URL да корпоратыўнай сеткі
Калі працуеце над адным этапам JSON URL у Эксперыменце, спачатку запісайце «контракт»: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неякшання. Такі спіс пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неякшанне должна паказваць на адну адпаведальнасць, а не на заплутаны ланцужок задач. Зробіце контрольную паузу пасля дорогіх крокаў. Функцыя адновлення не должна зноў плаціць за той самы вызов LLM, калі аператар прабуе зноў запрацаваць пазнейшы вузел. Калі працуеце над адным этапам JSON URL у Эксперыменце, спачатку запісайце «контракт»: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неякшання. Такі спіс пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Запісвайце час выканання і кост токеноў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая візуабільнасць костаў запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя.
Што на самай працэ падтрымало агента
Канцэпцыя «What actually grounded the stage» працюе наўзям лепш, калі яе спрыяваць як вімерную паверхню. Зафіксавайце адны «золаты» прыклад, адну справу аб неудачы і запіс пра вярнэнне да поперадньего стану, прычаму расшырэння масштаба. Зберагайце настройкі пазырочна ад коду прыемлівача. Файлы сераўнавальнага сэрвісу, хранілішчы секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяжнага чытання всіх дадзеных. Зберагайце стан графа ў простам і тыпаваным фармаце. Вярнутыя структуры дадзеных маскуюць інфармацыю пра тое, які вузел запісаў канкрэтны поле, і спакшуюць возз'яджанне пасля перэрываў.
ig ai-config
Пошук у жывой API проты перыядычна індэксаванай дакументацыі
Праця Live API і этапаў развітку выконваецца наяўна, калі яе спрыявае можласць вімеры. Запісаўце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметкі па адкату перш чым расшырваць масштаб. Дакументаваць трэба як успішны, так і варыянт вяснявання проблемы. Перапрыбуткі, людзкі контроль і обработка некорэктных паведамленняў ёсць часткай продукту, а не наступным етапам дапрацоўкі. Стан графа трэба падтрымваць у простым і тыпаванам фармаце. Вкладзеныя блокі маскуюць інфармацыю пра тое, які вузел запісаў канкрэтны поле, і спакшваюць продовжэнне працы пасля перэрываў.
Экспэрымент два: ад скрыншота да рабочага панелі керування
Эксперымент два з стадзіі працуе лепш, калі яго спрыяваць як меравальную паверхню. Зберагчыце адны ідэальны прыклад, адзін кейс неяўнасці і прыметку па адваротным запуску, перш чым расшырваць масштаб. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неяўнасці павінна вказваць на адную адпаведальнасць, а не на заплутаны ланцюг задач. Рэзультаты графа павінны быць простымі і з адначытаемым тыпам. Вярнутыя блокі маскуюць, калькі вузлы запісалі калькі поль, і спакойваюць працу пасля перарываў. Эксперымент два з стадзіі працуе лепш, калі яго спрыяваць як меравальную паверхню. Зберагчыце адны ідэальны прыклад, адзін кейс неяўнасці і прыметку па адваротным запуску, перш чым расшырваць масштаб. Запісвайце часы выканання і косты токеноў або запытак праза функцыйнае рэзультаты. Відразувая візуабілізацію костаў запобегае неспакойным рашчыткам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя.
App Builder — гэта неабавязковы інструмент для пачатку работы
Для стваральніка аплікацый існуе практыка, калі спачатку задаюцца вхідныя даны, адміністратар крока і крытэрыя завершэння, прычаму якім зменшаецца рызык паследніх правак у кодзе. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы вычысляць захаваны стан. Конфігурацыю трэба залічваць пазначальнай часткай, а не часткай коду аплікацыі. Файлы сераўнавання, храненні секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можу працаваць, не чытаяўшы весь код. Пры выкананні дзеяння, якія коштуюць грошы або зменяюць даны ў працэсе, неабходна людская апраўда. Прыеднанне элементаў у час компіляцыі не ўзначае повнайсткавасці бізнес-процэса.
Дзе дапамагае аднаковасць на розных платформах
Калі неабяжна ўніфікацыя межаў платформ, трэба загадзя вызначыць параметры вхідных дадзеных, адпаведальнага за крок і крытэрыя завершэння пры змены коду. Аператары должны магчымае перзапускіць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія пераказы і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не яго пазнейшай дапрацоўкі. Неабяжна атрымваць людзкую згоду для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны ў працэсе віробніцтва. Праця ў часе компілявання не ёсць гарантыяй повнай адпаведнасці продукту бізнес-трэбованням.
Што гэты рабочы працэс яшчэ не рашае
Для тагу “What this workflow still stage” неабяжна прадзефінавацыя вхідных дадзеных, адпраўніка крока і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчымаецца перапрацаваць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест абмоўжлівых скрыптав. Калі крок не выйшаў, прычына нехасабносты павінна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны працэс. Пры выконанні дзеяння, якія коштуюць грошы або зменяюць даны ў працэсе, неабходна людзкая апраўдка. Компіляцыйные налашчэнні не ўзначаюць пачатковай завершанасці бізнес-процэса. Для тагу “What this workflow still stage” неабяжна прадзефінавацыя вхідных дадзеных, адпраўніка крока і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчымаецца перапрацаваць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Запісвайце час выканання і кост токенаў аб запытаў разам з функцыйнальнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмавайнага рэжыма ў спяльную срэду.
Гэта ўсе.
Як відтворыць шаблон
Працюючы над этапам «Як відтворыць», спачатку запісайце умовы: неабяжлівыя даны, сігнал успеху і тое, што відбываецца у разе частковага невыпання. Такі спіс дапамагае залішацца чыстым пад час пазнейшых змян у кодзе. Зберагаюце настройкі паза кодам прыемленае. Файлы серавыску, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаюць пераглядаць іх без неабяжлівага чытання всей структуры. Стварайце контрольныя пункты пасля дорогіх крокаў. Функцыя вярнення працы не должна занова ставіць плату за той самы вызыв LLM, калі аператар перапрыявляе працу да наступнага вузла.
Урок, які вы запам’ятаеце
Калі вы працуеце над урокам, спачатку запісайце умовы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс контролю дапамагае заліцвачыць змяны ў кодзе.
Рэсурсы
Калі працуеце на стадыі Рэсурсаў, спачатку запішыце кантракт: неабходныя даныя, сігнал успеху і тое, што выканаецца у разы частковага нявыпалення. Такі спіс пераканальвае ў тым, што пазнейшыя змены коду будуць чыстымі. Валіце маленькія, тэставаныя елементы замест большых скрыптаў. Калі якісь крок нявыпанаецца, прычына нявыпалення павінна вказваць на адну адпаведальнасць, а не на заплутаны ланцужок задач. Зробіце перапаконтаванне пасля дорогіх крокаў. Сістэма адновлення не павінна зноў выклікаць той самы кантакт з LLM, калі аператар пракушае пазнейшы вузел. Калі працуеце на стадыі Рэсурсаў, спачатку запішыце кантракт: неабходныя даныя, сігнал успеху і тое, што выканаецца у разы частковага нявыпалення. Такі спіс пераканальвае ў тым, што пазнейшыя змены коду будуць чыстымі. Запісвайце час выканення і кост токенаў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая візуабельнасць костаў запобегае неспакойным рачынкам, калі працэс пераходзіць з дэмавайнага рэжыма ў спаканяныя сераўы.
Чэк-ліст для аператараў
Этап перагляду канцэлекту працюе найкрашча, калі яго спрыяваць як мерыемую структуру. Запісайце адны ідэальны прыклад працы, адзін прыклад неудачы і прыметку па вярнэнню да пачатковага стану, прычым расшыруючы сферу дзеяння.
Спрыяйце гэтам этапу як кантракту межа вхідным дадзенням і перакананым выходным рэзультатам. Дайце назвы всім элементам, задаце крытэрыя успеху і адмовіцеся ад частковага завершэння без паведамлення.
Зберагаеце стан графа ў простам і тыпаваным фармаце. Вкладзеныя блокі маскуюць інфармацыю пра тое, які вузел запісаў кожны поле, і спакоююць працэс пасля перарываў.
Калі бюджэт дазволяе, дадзіце тэст на перакананне работы крытычнага маршруту ў сістэме CI з вікорыстанням фіксатывальных элементаў, а не рэальных платных API.
Запісвайце часы выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі маршрут пераходзіць з дэмовай асяроддзя ў спяльнаныя сераўеры.
Зберагаеце стан графа ў простам і тыпаваным фармаце. Вкладзеныя блокі маскуюць інфармацыю пра тое, які вузел запісаў кожны поле, і спакоююць працэс пасля перарываў.
Перш чым запускаць даную сістэму, заморозьце версіі, зафіксавце ідэальны транскрыпт для крытычнага шляху і паказвце способы анулювання змян. У спільных срэдах неабходны ліміты частоты запуска, пераконтрольванне прав на выкарыстоўвання рэсурсаў і чысткі власнік для змены секрэтных даных. Лепш выбраць простую надзею на надзейнасць, чым хітрыя разовыя дэманстрацыі.
Прыметка для 462a33f95175: не кладзіце ключы прадаўцаў у рэпазітарый, задаце верхнюю межу токенав для кожной сесіі і зберагачыце транскрыпты разам з фіксатрамі для ацэнкі, каб пазнейшыя замены мадэляў заставаліся порównанымі.
Прыметка па забезпечэнню надзейнасці на стадыі 0 работае лепш, калі яе спрыяваць як мерыемую плошчу. Зафіксавце адны ідэальны транскрыпт, адзін прыклад неудачы і прыметку па анулюванні змян перш чым расшырваце сферу дзейнасці. Дакументаваць трэба і успешны шлях, і шлях вяснавання проблем. Перапрыбуткі, людзкі контроль і обработка некорэктных паведамленняў ёсць часткай продукту, а не чымось, што дадаецца пазней.
Дзеянне паўжасткі 0/743: звярніце увагу на час выканання, класы памылак і колькасць выкорыстоўваных токенаў для гэтага зьязначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы хацеце застаўіць змяну.
Для першага этапу паўжасткі неабходна ўзначыць вхідныя даны, адпаведальнага за выкананне крока і крытэрыяы завершэння працы перад змінай коду. Аператары должны магчыма было перзапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Штодзе гэты этап трэба спрыятаць як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Назвіце артыфакты, узначыце перакананні успеху і адмовіцеся ад беззвучнага частковага завершэння.
Дзеянне паўжасткі 1/743: звярніце увагу на час выканання, класы памылак і колькасць выкорыстоўваных токенаў для гэтага зьязначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы хацеце застаўіць змяну.
Для этапы 0 пры практыцы змецчэння неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісваць час выканання і вартасць токена або запыту разам з функцыйнальнымі рэзултатамі. Відразы вартасці з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спяльнаныя сераўеры.
Дзеярожны дэталі 0/762: зважыць час выканання, класію адказаў і вартасць вікорыстоўвання токена для гэтай прыметкі, а пасля — вырашыць, чы робіць змяну на аднойчы зафіксаванай сэтке пытанняў, а не на аднойчы інформацыі.
Калі працюеце над першым этапам зміцнення, спачатку запісайце умовы кантракта: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс контроля дапамагае заліцвачыць пазнейшыя змены коду.
Документавайце як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам.
Дзеянні зміцнення 1/762: вымерайце час выканання, класію памылак і колькасць выкорыстоўваных токенав для гэтага пункту, а потым выберайце, чы робіць змену на аднойчынных крытэрыях, а не на аснове індывідуальных спостарожэнняў.