Практычныя нататкі: ці ўмее ваш агент шукаць MCP-серверы

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

Чаму ў офіцыяльным рэестры няма можлівасці шукання вашага агента

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

Каталог, які скануе, ацэнюе і выкарыстоўвае толькі неабходнае

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

Інструмент, які вызывае ваш агент

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

{
  "mcpServers": {
    "find-mcp": {
      "command": "npx",
      "args": ["-y", "@agentage/find-mcp"]
    }
  }
}

Кліент практычна нічога

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

Занятая галерыя без лідэра

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

Раней вы толькі пераглядалі; цяпер вы запытваеце.

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

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

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

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

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

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

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

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

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

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