Практычныя прытамкі: Чы гэтыя навыкі агента дапамагаюць? Я практыкуўся 72 разы, каб выясніць.
Практычныя прытамулкі: чы робяць канскрэты спрыяюць? Я адрабатав 72 тэсты, каб выявіць: контракты, пераконтроль і месца для коду для команд, якія выкарыстоўваюць гэты патэрн.
Наступныя прытамлівкі паказваюць практычны шлях для рашэння запытання «Чы гэтыя навыкі агента дапамагаюць? Я адрабатав 72 прыклады, каб выявіць гэта». Акцэнс ставіцца на контракты, пераконтрольванне і месця для коду, а не на мотывацыйны падход. Калі працуеце на стадзіі агляду, спачатку запісайце контракт: неабяжлівыя даныя, сігнал успеху і тое, што выканаецца у разе частковага нявыполнення. Такі спіс контроля дапамагае заліцьварыць пазнейшыя змены ў кодзе. Спрэцьвуйце да гэтай стадзіі як да контракту межа данымі і пераконтрольванымі рэзультатамі. Дайце назвы элементам, задаць крытэрыя успеху і не падзеўляйцеся частковым завершэнням без паведамлення.
Дапамога чы галюцінацыя?
Этап «Падчырка» або галюцінацый работае наявней, калі яго розглядаць як вімерную плошчу. Запісаўце адна «золатая» транскрыпцыя, адын прыклад неудачы і прыметку пра вярнэнне да поперадньага стану, прычым расшыруючы сферу дзеяння. Запісвайце часы выканання і кост токеноў або запытаў па боку ад функцыйнальных рэзультатаў. Візуабельнасць костаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя сераўы. Храніце стан графа ў простам і тыпаваным фармаце. Вкладзеныя блокі маскуюць, які вузел запісаў кожны поле, і спакшваюць продажчык працы пасля перарываў.
Тэставанне Claude Code ў ізольванай песчаныце
Тэставанне коду Claude на стадыі працюе найкрашча, калі яго спрыяваць як мерыемую паверхню. Запісаце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па абяроŭненню перад расшырэнням масштаба. Храніце настройкі пазырочна ад коду прыемлена. Файлы сераўіса, хранальнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяŭнага чытання всіх дадзеных. Храніце стан графа ў простай форме з адзінаковым тыпам дадзеных. Вярсткаваныя блокі маскуюць інфармацыю пра тое, які вузел запісаў канкрэтны поле, і спакойваюць працу пасля перарываў.
Што паказваюць цыфры
Этап «Што паказваю цыфры» працуе наяўней, калі яго спрацоўваюць як мерыемую паверхню. Зафіксавайце адны ідэальны прыклад, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Храніце стан графаў у простым і тыпаваным фармаце. Вярнутыя блокі маскуюць, які вузел запісаў канкрэтны поле, і спакшуюць продовжэнне працы пасля перарываў. Этап «Што паказваю цыфры» працуе наяўней, калі яго спрацоўваюць як мерыемую паверхню. Зафіксавайце адны ідэальны прыклад, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Спрацоўвайце гэты этап як кантракт межаў вхідных дадзенняў і перакананых выходных рэзультатаў. Даці назвы артыфактам, задаць крытэрыя успеху і адмовіцца ад беззвучнага частковага завершэння.
Чаму агенты-базовыя паказалі ноль за эфектывасцю
Для выклікання базовых показнікаў агентаў на этапы «Чаму» неабходна перш за ўсё візначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння пры зміне коду. Аператары должны магчыма было перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Запісвайце час выканання і вартасьць токеноў або запытанняя разам з функцыйнальнымі рэзультатамі. Візуабілізацыя вартасцей з самага пачатку запобегае неспакою, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную. Заставьце людзкія празборы на тых кроках, дзе вітрачаюцца грошы або зміняюцыся даны для працы. Працэс складання коду не ўзроўнюецца з повнасцю бізнес-процэсаў.
Дзе плагін зробіў розныяцю
Для распрацоўкі кроку, які стварыў плагін, неабходна перад змянай коду задаць параметры вводу, адпаведальную особу за крок і крэтыяры завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы схованы стан. Конфігурацыю трэба зберагчы за межамі коду прыемліка. Файлы сераўнавання, хранальнікі секрэтных дадзеных і флагі функцый належаць у аднам месца, якое аператары можаць пераглядаць, не чытачы весь лянцуг заданняў. Автэнтыфікуйцеся на воратах і паўторна автарызуйцеся на роўні дадзеных. Толькі токэн-носіцель не ёсць межай арэндавання.
Автэнтыфікацыя у Cloud Run
Для этапы аутантыкацыі у Cloud Run неабяжна прадзефінаваць параметры вводу, адпраўніка крока і крэтыяры завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчымае перайсці крок з вядомага пункта контролю без неабяжнай адгадвання скрытага стану. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія пераказы і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Неабяжна прынясі людзкую згоду для тых крокаў, якія выкарыстоўваюць грошы або зменяюць даны ў працэсе. Конфігурацыя ў часе компілявання не ёсць падтверджэннем полной готовасці продукту. Для этапы аутантыкацыі у Cloud Run неабяжна прадзефінаваць параметры вводу, адпраўніка крока і крэтыяры завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчымае перайсці крок з вядомага пункта контролю без неабяжнай адгадвання скрытага стану. Спрацавляйце з гэтым крокам як з контрактом межа параметрамі вводу і перакананымі рэзультатамі. Даўце назвы файлам, прадзефінаваць пераказы успеху і не прабывайце прыймаць часткова завершаныя рэзультаты без падтверджэння.
# Plugin recipe: create custom identity and bind least-privilege role
gcloud iam service-accounts create batch-worker \
--project="my-app-prod" \
--display-name="Batch Worker Service Account"
gcloud projects add-iam-policy-binding my-app-prod \
--member="serviceAccount:batch-worker@my-app-prod.iam.gserviceaccount.com" \
--role="roles/storage.objectViewer"
gcloud run jobs create batch-job \
--image="gcr.io/my-app-prod/job:latest" \
--service-account="batch-worker@my-app-prod.iam.gserviceaccount.com" \
--region="us-central1"
Перакантрольванне сінтаксу пры выконанні
Кал працуеце на стадзіі перакантрольвання сінтаксу пры выконанні, спачатку запісайце умовы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частыя неудачы. Такі спіс контролю дапамагае заліцвачыць змяны ў кодзе. Запісуйце час выканання і кост токеноў або запытаў праза функцыйнае рэзультат. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўсы. Зробіце контрольную пазнаку пасля дорогіх крокаў. Функцыя адновлення не должна зноў нараховваць косты за той самы вызыв LLM, калі аператар прабуе зноў выконаць пазнейшы вузел.
# Verified via leaf-level help check before drafting final command
gcloud run deploy invoice-service \
--image="gcr.io/my-app-prod/invoice:latest" \
--region="us-central1" \
--add-volume="name=data-vol,type=cloud-storage,bucket=my-data,readonly=true" \
--add-volume-mount="volume=data-vol,mount-path=/mnt/gcs" \
--set-secrets="DB_PASSWORD=db-password:latest"
Пошук навыкаў па запатранню
Калі працуеце на стадыі «Адказванне навыкаў за запатраннем», спачатку запісайце контракт: неабходныя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс пераконтрацый дапамагае залічваць змяны ў кодзе чыста. Зберагайце настройкі паза кодам прыемліка. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт без неабяжнага чытання всіх элементаў. Стварайце контрольныя пункты пасля дорогіх крокаў. Сістэма вярнення не должна занова ставіць плату за той самы вызыв LLM, калі аператар перапрыяўляе працу да наступнага элемента.
Фільтраўванне дадзеных на серверэ
Калі працуеце з фарматаваннем дадзейна на гэтым этапе, спачатку запісайце угоду: неабяжлівыя даныя, сігнал працэйскага успеху і тое, што выканаецца у разы частковага нявыполнення. Такі спіс пераканальвае ў тым, каб пазнейшыя змены коду былі чыстымі. Дакументавайце як шлях успеху, так і шлях вярнення да нормы. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зрабіце контрольную пазнаку пасля дорогіх крокаў. Сістэма вярнення не павінна зноў выклікаць той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел. Калі працуеце з фарматаваннем дадзейна на гэтым этапе, спачатку запісайце угоду: неабяжлівыя даныя, сігнал працэйскага успеху і тое, што выканаецца у разы частковага нявыполнення. Такі спіс пераканальвае ў тым, каб пазнейшыя змены коду былі чыстымі. Спрыятліва ставіцеся да гэтага этапу як да угоды межа данымі-вхідамі і паверанымі данымі-выходамі. Дайце назву рэзультатам, задацьце крытэрыя успеху і адмовіцеся ад тыхнага частковага завершэння без паведамлення.
gcloud compute disks list \
--project="my-app-prod" \
--filter="-users:*" \
--format="table(name, zone, sizeGb)"
Размежаванне секрэтнага доступу між праектамі
Секрэтны доступ даўедзення межаў працы ў разных этапах работае наўлучэй, калі яго спрыявае можнае вымеры. Зафіксавайце адну «золатую» копію даных, адны прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць межы. Запісвайце час выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзултатамі. Відразы костаў з самага пачатку запобегае неспакойным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўысы. Храніце стан графа ў простам і тыпаваным фармаце. Вярнутыя структуры даных маскуюць інфармацыю пра тое, калькі вузел запісаў калькі поль, і спаказваюць працу пасля перарываў.
# Resource-level binding: grants access strictly to stripe-webhook-key in sec-vault-prod
gcloud secrets add-iam-policy-binding stripe-webhook-key \
--project="sec-vault-prod" \
--member="serviceAccount:app-runner@app-prod.iam.gserviceaccount.com" \
--role="roles/secretmanager.secretAccessor"
Захаванне ад разрушальных каманд за дапамогою паўтарнай адзначкі
Команды забэрагання разрушніх дзеянь, якія выкалікаюцца пад час адпрацоўкі стэйжаў, найлепяй працуюць, калі іх розглядаць як вімерную паверхню. Зафіксавайце адны «золаты» прыклад, адну справу аб неудачы і запіс пра вярнэнне да поперадньего стану, прычым расшыруючы сферу дзеяння. Зберагаўце настройкі праза код аплікацыі. Файлы сераўнавальнага сераўсу, хранілішчы секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт, не чытаючы весь граф. Зберагаўце стан графа у простам і тыпаваным фармаце. Вярнутыя блокі маскуюць інфармацыю пра тое, які вузел запісаў якое поле, і спакойваюць працэс пасля перарываў.
# Step 1: Preview candidate instances safely
gcloud compute instances list \
--filter="name:legacy-worker-* AND zone:us-central1-a" \
--format="table(name, status)"
# Step 2: Prompt user for confirmation before executing deletion
# (Execution refused until explicit human consent is given)
Локальныя крантэнціі проты ключаў адказвальных рахункоў
Мадэль «Локальныя крантыджэнтсі за сэрвісным стадыям» працуе наўзярэджэй, калі яе спрыяваць як мерыемую паверхню. Зберагачыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць сферу дзеяння. Дакументавайце як успішны, так і вярнучыся парадоксы разам. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Рэзультаты графах трэба залічваць у простам і тыпаваным фармаце. Вярнутыя блокі маскуюць, калькі вузел напісаў калькі поль і спакшваюць продовжэнне працы пасля перарываў. Мадэль «Локальныя крантыджэнтсі за сэрвісным стадыям» працуе наўзярэджэй, калі яе спрыяваць як мерыемую паверхню. Зберагачыце адны ідэальны прыклад працы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць сферу дзеяння. Спрыявайце гэты стадыя як кантракт межа вхіднымі дадзеннямі і перакананымі выхіднымі рэзультатамі. Даўайце назвы артыфактам, задаюце крытэрыя успеху і не падтрымайце беззвучнае частковае завершэнне працы.
Чатыры правілы для развіцьбы лепых навыкаў
Для чатырох правіл стварэння ўражэй, пярэд тым як зменіць код, неабходна вялічыні вхідных дадзеных, адпаведальныя за кожны крок і крытэрыі завершэння. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісваць трываласць выканання і кост токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае паказанне костаў запобегае неспадзяваным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спяльнаваныя сераўеры. Пры кроках, якія вітрачаюць грошы або зменяюць даныя ў працэсе, неабходна людская апраўка. Прыеднанне элементаў у час компіляцыі не ўзначае повнайсткі рэалізацыі бізнес-функцый.
1. Пераканацца ў дапамозе CLI пярэд запускам команд
Для этапы падчыркі дапамогі 1 Inspect CLI неабяжна прадзеява параметраў, выявленне адпаведальнага за крок і заданне крэатарыяў выйшчы з працы, перш чым змяніць код. Аператары должны магчымае перзапускіць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Конфігурацыю трэба залічыць праза код аплікацыі. Файлы сяродавішча, хранальнікі секрэтных дадзеных і флагі функцыяў павінны знаходзіцца ў адном месцы, якое аператары можаць пераглядаць, не чытаючы весь ланцуг. Пры выконанні дзеяння, якія купуюць грошы або зменяюць даныя ў працэўным рэжыме, неабяжна ўключыць людзкія падтверджэння. Паўтарны кампіляванне коду не ёсць гаранцыяй полнай адпаведнасці з бізнес-трэбованнямі.
Rule: When using gcloud subcommands with volume mounts, IAM bindings,
or filtering, always run 'gcloud help <group> <command>' first.
Never invent parameter names.
2. Зробіце скрыпты налаштавання ідэмпатнымі і некінерагуючымі
Для этапы скрыптав налашчэння 2 Make неабяжна практыкаваць заданні вхідных дадзеных, адпаведальнага за крок і крэтарыя выходу пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія пераказы і апрацоўка некорэктных паведамленняў ёсцю часткай продукту, а не элементамі пазнейшага дапрацоўкі. Неабяжна прынясць людзкую згоду для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны праўдзівай працы. Кампіляцыйныя налашчэння не ўзроўнаваны з абсягам бізнес-функцыйнасці. Для этапы скрыптав налашчэння 2 Make неабяжна практыкаваць заданні вхідных дадзеных, адпаведальнага за крок і крэтарыя выходу пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Спрыяць гэтай этапы як кантракту межа вхіднымі дадзенымі і перакананымі выходнымі рэзультатамі. Назваць всі элементы, практыкаваць пераказы успеху і адмовіцца ад беззвучнага частковага завершэння крока.
# Check before creating to ensure idempotency
if ! gcloud iam service-accounts describe "${SA_EMAIL}" --project="${PROJECT_ID}" >/dev/null 2>&1; then
gcloud iam service-accounts create "${SA_NAME}" \
--project="${PROJECT_ID}" \
--display-name="App Service Account" \
--quiet
fi
3. Фільтрацыя дадзейна на серверэ
Калі працуеце над этапам фільтрацыі дадзейна, спачатку запісайце умовы: неабяжлівыя даныя, сігнал успеху і тое, што выканаецца у разе частковага невыпалення. Такі спіс дапамагае заліцварыць змяны ў кодзе. Запісывайце час выканання і вартасць токена або запытку празаўсёды разам з рэзультатамі функцыйнасці. Відразлівая вартасць з самага пачатку запобегае неспакою, калі праця пераходзіць з дэмовай асяроддзя ў спакульнаныя сераверы. Ствараюце контрольны пункт пасля дорогіх крокаў. Сістэма не должна занова нарахоўваць плата за той самы вызов LLM, калі аператар прабуе зноў выканаць пазнейшы элемент.
# Return only running VM names and internal IPs in compact tabular form
gcloud compute instances list \
--project="my-app-prod" \
--filter="status:RUNNING" \
--format="table(name,networkInterfaces[0].networkIP:label=INTERNAL_IP)"
4. Абавяжыце падтверджэнням пры разрушаючых дзеяннях
Калі працуеце з пунктам «Патрабуецца паўтарна адзначка перад наступным этапам», спачатку запісайце угоду: неабходныя даны, сігнал пра успех і тое, што выходзіць на падчасныя неудачы. Такі чэк-ліст дапамагае заставіць пазнейшыя змены коду быць чыстымі. Зберагаеце настройкі за межамі коду прыемліка. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаюць адбавіць аўдыт без неабяжнага чытання всіх элементаў. Стварайце контрольныя пункты пасля дорогіх крокаў. Сістэма вярнення працы не должна занова ставіць плату за той самы вызыв LLM, калі аператар перапрыяўляе працу да наступнага вузла.
Ад перакананняў да рэальных пераглядаў
Калі працуеце над стадзіяй «Перайшочы за межы пераконтроўкаў настрою», спачатку запісайце кантракт: неабходныя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконтроўкаў дапамагае заліцвачыць пазнейшыя змены ў кодзе. Документавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшай дапрацоўкі. Зробіце пераконтроль пасля дорогіх крокаў. Сістэма вярнення не павінна знову выклікаць той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел. Калі працуеце над стадзіяй «Перайшочы за межы пераконтроўкаў настрою», спачатку запісайце кантракт: неабходныя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконтроўкаў дапамагае заліцвачыць пазнейшыя змены ў кодзе. Спрыйміце гэтую стадзію як кантракт межаў між вхіднымі данымі і павернутымі, пераконтроленымі рэзультатамі. Дайце назвы артыфактам, задаць пераконтроўкі успеху і адмовіцеся ад тыхнай частковай, непазначанай завершэння.
Чарт пераконтроўкаў працы
У стадыі перагляду апаратнай часткі неабяжна практычна ваказка: перад тым, як зменшыць код, неабяжна адзначыць вхідныя даныя, адпаведальную особу за кожны крок і крытэрыі завершэння. Апаратнікі павінны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы схованы стан.
Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына неабяжна стосувацца адной конкрэтнай адпаведальнасці, а не заплутанага ланцоўка дзеянняў.
Неабяжна прыменіць людскую апраўдку для тых крокаў, якія выкарыстоўваюць грошы чы зміняюць даныя ў працоўным рэжыме. Компіляцыйныя налашчэння не ёсць падтверджэннем полной готовасці сістэмы.
Напісці кароткую інструкцыю: як зменяць ключы, як спрачыслаць чэргу, як анулюваць пярэдніе дадзеныя.
Спрыятліва ставіцца да гэтай этапы як да кантракту межа вхіднымі данымаў і перакананымі выходнымі рэзультатамі. Назваць усе элементы, адзначыць крытэрыі успеху і не праграмаваць тыхню частковую апраўдку.
Неабяжна людская празначэнне для тых элементаў, якія выдваюць грошы або зменяюць даны праработкі. Працаванне ў часе компілявання не абяжаецца пачынкамі бізнес-процэсаў.
Перш чым пераводзіць стэк, заморажуйце версіі, зафіксавайце «золаты» транскрыпты для крытычных шляхоў і паказвайце способы адвярнення змян. У спільных срэдах неабходны ліміты частоты запытоў, перакананні ў правах на вікорыстоўванне рэсурсоў і чыста вялікі адпаведальны за змяну секрэтных даных. Валіце надзейнасць, а не крэатыўныя разовыя дамастанкі.
Запіс для b328ba4d66b2: не кладзіце ключы прадаўцоў у рэпазітарый, задаце ліміт токена на кожную сесыю і зберагаце транскрыпты праз адносна да фіксатуў eval, каб пазнейшыя замены модэляў заставаліся парабяльнымі.