Галоўная / Артыкулы / Практычныя прытамкі: Чы гэтыя навыкі агента дапамагаюць? Я практыкуўся 72 разы, каб выясніць.

Практычныя прытамкі: Чы гэтыя навыкі агента дапамагаюць? Я практыкуўся 72 разы, каб выясніць.

Практычныя прытамулкі: чы робяць канскрэты спрыяюць? Я адрабатав 72 тэсты, каб выявіць: контракты, пераконтроль і месца для коду для команд, якія выкарыстоўваюць гэты патэрн.

2401 слоў

Наступныя прытамлівкі паказваюць практычны шлях для рашэння запытання «Чы гэтыя навыкі агента дапамагаюць? Я адрабатав 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, каб пазнейшыя замены модэляў заставаліся парабяльнымі.