Практычныя прытамулкі: Графічны інтерфейс базы дадзеных, який таксама кантролюе тое, што дазволена вашай ШІ-агентцы.

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

Семь баз дадзеных, адна натыўная бінарная файлавая структура

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

Праўdziвае Native, а не веб-відображэнне ў вікнах

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

Сервер MCP, пабудованы безпосередна ў кліент

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

Пятнацать інструментоў, арганізаваных у пяць рангаў дазволаў

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

connection: production-orders (read_only)
tool: execute_write_query
result: rejected — SQL sanitizer detected an UPDATE statement
        in a connection scoped to read_only mode

Слоі безпекі, якія стояць за кожным вызовам інструменту

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

Полны, можна пераглядаць ліст таго, што насправды зрабіў агент

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

sh.

AI-чат, які розумеюць асалютную структуру

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

Даны аб’явлення, якія ніколі не выходзяць за межы апарата

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

Дыяграма ER, чытаная безпосередна з жывага схематызму

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

Прыгожы рэдагувальнік і сетка дадзеных

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

Безпечны доступ да баз дадзеных через сеть

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

Архіваўанне і вярнэнне да пачатковага стану: правільны спосаб для кожнага двыжка

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

Перанесенне існуючых звязей з іншых інструментаў

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

Запуск Gridex

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

git clone https://github.com/gridex/gridex.git
cd gridex
swift build
.build/debug/Gridex

./scripts/build-app.sh
open dist/Gridex.app

git clone https://github.com/gridex/gridex.git
cd gridex
cmake -S linux -B linux/build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build linux/build --parallel
./linux/build/gridex

Чыстая, шаровая архітектура ў основе

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

Заключэнне

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

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

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

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

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

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

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

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

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

Прыметка для пакета 71ad8e86a751: не кладзіце ключы прадаўцоў у репазітарый, задаце верхнюю межу токеноў на кожную сесію і зберагачыце транскрыпты празаўсёды разам з фіксатрамі для ацэнкі, каб пазнейшыя замены моделяў заставаліся пораўнанымі.

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

Дзеянне паўжасткі 0/822: звярніце увагу на час выканання, клас памылкі і колькасць викорыстоўваных токенаў для гэтага зазначэння, а пасля, на аднойчынай базе паказаных пытанняў, а не на асобістых спазырэннях, выявіце, чы хачаце застаўіць гэтыя змены.

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

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

Дзеянне паўжасткі 1/822: звярніце увагу на час выканання, клас памылкі і колькасць викорыстоўваных токенаў для гэтага зазначэння, а пасля, на аднойчынай базе паказаных пытанняў, а не на асобістых спазырэннях, выявіце, чы хачаце застаўіць гэтыя змены.

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

Дзеянне зміцнення 2/822: вимеравайце час выканання, класы каштоўкаў та витрату токенав для гэтай прыметкі, а пасля, на аднойчынку з фіксаваным наборам пытанняў, а не на аднойчынку з пераказамі, выберайце, чы рашыцца застаўіць змяну.

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

Дзялейчык 3/822 практыкі забезпечэння надзеі: вы мераваеце час выканання, класы каштоўкаў і витрату токенав для гэтага пункту, а потым прымаеце рашэнне пра тое, чы робіць змяны, на адной пазначкай фіксаванага набора пытанняў, а не на асобістых спазырэннях.

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

Дзеянне 4/822 практыкы забезпечэння безпекі: замерайце час выканання, класы каштоўкаў і витрату токенаў для гэтай практыкі, а потым вырашайце, чы робіць змены на адной основе фіксаванага набору пытанняў, а не на адной лячбе.

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

Дзеянні паўжасткі 5/822: звярніце увагу на час выканання, клас памылак і колькасць викорыстоўваных токенав для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набора пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшыцца застаўіць змяну.