Практычныя прытамкі: Агенты Harnesses — інтуўітываўскі та ўсесторонні адказ

Існавайце гэта як перапрацоўаны варыянт ідэй з кнігі “Agent Harnesses — Intuitively and Exhaustively Explained” для аператараў: чыткія этапы, аранжаваныя слоты для коду і прыміткі па вяснаванню, якія застаюцца пасля перадачы задання. Этап “Адгледжэнне” найкраща працюе, калі яго розглядаць як мерыемую структуру. Запісаўце адна ідеальная транскрыпцыя, адзін прыклад неудачы і прыміткі па адвярнуццю змян прычым расшырэнні масштаба. Зберагайце настройкі праза код аплікацыі. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць контроль без неабяжнага чытання всей структуры.

Стварэнне фундаментальнага розумеўня

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

Адзорт: LLM-ы

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

Адзінктаванне: Агенты

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

Адзінкты: Логіка развязвання проблем і выкарыстоўванне інструментаў

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

Адзінкты: Навыкі

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

my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories

Фундаментальная ідея Harness

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

Агент выкарыстоўвае стандарт

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

my-harness/
├── HARNESS.md        # Required: metadata + instructions
├── skills/           # Optional: a set of skills
└── references/       # Optional: a set of reference documents

З’явленне файла HARNESS.md

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

---
name: <name of the harness>
description: <description of what the harness is for>
---

<body>

Устаноўкі каталогу навыкаў

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

my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories

my-harness/
├── HARNESS.md
├── skills/
|  ├── my-skill-1/
|  |  ├── SKILL.md
|  |  ├── scripts/
|  |  ├── references/
|  |  ├── assets/
|  |  └── ...
|  └── my-skill-2/
|     ├── SKILL.md
|     ├── scripts/
|     ├── references/
|     ├── assets/
|     └── ...
└── references/

Апранавань каталогу рэферэнсаў

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

my-mraketing-harness/
├── HARNESS.md
├── skills/
|  ├── create-blog-post/
|  |  ├── SKILL.md
|  |  └── ...
|  ├── generate-images/
|  |  ├── SKILL.md
|  |  └── ...
|  └── scan-social/
|     ├── SKILL.md
|     └── ...
└── references/

my-mraketing-harness/
├── HARNESS.md
├── skills/
|  ├── create-blog-post/
|  |  ├── SKILL.md
|  |  └── ...
|  ├── generate-images/
|  |  ├── SKILL.md
|  |  └── ...
|  └── scan-social/
|     ├── SKILL.md
|     └── ...
└── references/
   ├── style-guide.md
   └── brand-priorities.md

---
description: a style guide for the marketing website, which covers the creation
of all visual assets and standard typography rules
---

<body>

Структураванне большых комплексаў

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

my-harness/
├── HARNESS.md
├── skills/
|  ├── skill1/
|  ├── skill2/
|  ├── skill3/
|  └── ...
└── references/
   ├── reference1
   ├── reference2
   ├── reference3
   └── ...

my-harness/
├── HARNESS.md
├── skills/
│   ├── software-development/
│   │   ├── SKILLS.md
│   │   ├── skill1/
│   │   │   └── SKILL.md
│   │   └── skill2/
│   │       └── SKILL.md
│   ├── market-analysis/
│   │   ├── SKILLS.md
│   │   └── skill3/
│   │       └── SKILL.md
│   └── social-media/
│       ├── SKILLS.md
│       ├── skill4/
│       │   └── SKILL.md
│       └── skill5/
│           └── SKILL.md
└── references/
    ├── brand-assets/
    │   ├── REFERENCES.md
    │   ├── reference1.md
    │   └── reference2.md
    ├── software-infrastructure/
    │   ├── REFERENCES.md
    │   ├── reference3.md
    │   └── reference4.md
    └── product-information/
        ├── REFERENCES.md
        └── reference5.md

...
└── references/
  └── data-sources/
      ├── REFERENCES.md
      ├── relational/
      │   ├── REFERENCES.md
      │   └── schema-overview.md
      └── warehouse/
          ├── REFERENCES.md
          └── dataset-catalog.md

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

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

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

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

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

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

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

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

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