Галоўная / Артыкулы / Практычныя прытамулкі: Microsoft створыў сервер Playwright MCP. Потым сказаў вам…

Практычныя прытамулкі: Microsoft створыў сервер Playwright MCP. Потым сказаў вам…

Практычныя прыказкі: Microsoft створыў сервер Playwright MCP. Потым сказаў вам: кантракты, перакрыцчы і месца для коду для команд, якія викорыстоўваюць гэты патэрн.

1583 слоў

Існавайце гэта як перапрацоўаны варыянт ідэй з артыкула “Microsoft Built the Playwright MCP Server. Then Told You to Maybe Not Use It.”, адпрацаваны для аператараў: чыстыя этапы, арганізаваныя блакі для коду і прыметкі з восстанавлення, якія застаюцца пасля перадачы задання. Этап “Агульныя відзнакі” найэфектывнейша працюе, калі яго розглядаць як меркаваную плошчу. Запісаце адна ідеальная транскрыпцыя, адзін прыклад неудачы і прыметку з вярненням да пачатковага стану прычаму расшырэння масштаба. Дакументавайце як шлях успеху, так і шлях восстанавлення разам. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не наступным етапам дорабкі.

Вашы пачатковыя падставы

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

Падатак на інтэрфейс

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

Agent
  ↓
MCP tool discovery         → tool schemas loaded into context
  ↓
Tool call + arguments
  ↓
Browser interaction
  ↓
Structured result          → page/browser state returned as part of the response
  ↓
Agent reasons over response
  ↓
Next tool call

Як выглядае версія CLI для той самай задачы

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

Agent
  ↓
Skill (playwright-cli --help)
  ↓
CLI command
  ↓
Compact result, or a reference to a saved snapshot file
  ↓
Agent requests more detail only if it needs to
playwright-cli open https://demo.playwright.dev/todomvc --headed
playwright-cli type "Buy groceries"
playwright-cli press Enter
playwright-cli snapshot --depth=4
playwright-cli click e21

Калі трэба выбраць тое чы то

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

Большая наука

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

Пачатковая точка для ланцуга інструментаў QA для AI

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

Browser validation   → CLI + Skills   (high-throughput, repetitive)
API investigation    → CLI/script     (composable, scriptable)
Test management      → MCP            (structured, multi-client)
CI orchestration      → API/CLI        (agent-driven, low overhead)
Observability          → MCP/API        (introspection-heavy)
Human-facing tooling   → MCP            (rich discovery matters more than tokens)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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