Практычныя нататкі: агент упіраецца ў сцяну на 12-м кроку — Deep Agents ад LangChain
Практычны разбор тэмы «чаму агент упіраецца ў сцяну на 12-м кроку і як дапамагаюць Deep Agents ад LangChain»: кантракты, праверкі і гатовыя фрагменты кода для каманд, якія ўкараняюць гэты падыход.
Крыніцы: Your AI Agent Hits a Wall at Step 12. LangChain’s Deep Agents Explains Why.
У гэтым керавану практычна перакладзець шлях ад сыр'ёў да рабочай сістэмы для наступных сітуацый: ваш AI-агент сталкнуўся з працою на 12-м кроку. Deep Agents ад LangChain пояснюе прычыны. Акцэнт ставіцца на крокі, якія можна выконваць, чыстае перакананне і код, які можна проста дадаць у рэпазітарый без неабяснення меты. У стадзіі агульнага пераканання неабходна прадзефінаваць вхідныя даны, адпаведальную особу за крок і крытэрыя завершэння пры перамены коду. Аперацыйныя працавнікі должны магчымае перадзеўсці крок з вядомага пункта перапытку без неабяснення схованага стану. Спрыятлівае ставленне да гэтай стадзіі як да кантракту межа вхіднымі данымі і падтверджанымі выходнымі рэзультатамі. Назваце артыфакты, прадзефінаваце пераканання на успех і адмовіцеся ад беззвучнага частковага завершэння.
Проблема паверхневага агента
Калі працюеце над стадзіяй «Проблема паверхневага агента», спачатку запісайце контракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс дапамагае заліцьваваць змяны ў кодзе пасля таго, як яны былі здабыты.
Чатыры основныя элементы, проста
Калі працуеце над стадзіямі «Чатыро сталпа», спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неяксамоства. Такі спіс контроля дапамагае заліцвачыць змянам у кодзе пазнейша. Зберагайце настройкі за межамі коду прыемліка. Файлы сераўнавання, хранальнікі секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаюць адбавіць аўдыт без неабяжлівага чытання всей структуры. Ставьце контрольныя пункты пасля дорогіх крокаў. Програма для продакцыі не должна занова ставіць плата за той самы вызов LLM, калі аператар перапрыяўляе працу да наступнага вузла.
Сталп 1: Запісайце план там, дзе мадэль можа яго бачыць
Калі працуеце над Піларам 1, спачатку запісайце этап і дакладны контракт: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконтроўкаў дапамагае заставіць пазнейшыя змены коду чыстымі. Дакументавайце як «шчаслівы» шлях, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткаю продукту, а не пазнейшым дапрацоўкам. Зберагаюце у кэшы стабільныя інструкцыі сістэмы і схемы інструментаў. Перадача таго ж самога прамэра ёсць частым выклікам зношвання рэсурсаў. Калі працуеце над Піларам 1, спачатку запісайце этап і дакладны контракт: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс пераконтроўкаў дапамагае заставіць пазнейшыя змены коду чыстымі. Спрыймайце гэты этап як контракт межа данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задайце крытэрыя успеху і адмовіцеся ад беззвучнага частковага завершэння.
Пілар 2: Сістэма файлавання, якую агент можа выкарыстоўваць як памяць
Этап файлавой сістэмы Pillar 2 працюе наякраўжэй, калі яго спрыяваць як мерыемую паверхню. Запісаце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па абратанні змян перад расшырэнням масштаба. Запісвайце часы выканання і косты токеноў або запытак па боку ад функцыйнаых рэзультатаў. Візуабельнасць костаў з самага пачатку запобегае неспакойным рахункам, калі працэс пераходзіць з дэмавай версіі ў спяльныя асяроддзя. Храніце стан графа ў простам і тыпаваным фармаце. Вкладзеныя блобы маскуюць інфармацыю пра тое, які вузел запісаў які поле, і спакшваюць продажчыку працу пасля перарываў.
Pillar 3: Падагенты для кварантайны раздзелу кантэкста
Падзеўнік 3 для працы на этапах працюе найэфектывней, калі яго розглядаць як вімерную паверхню. Зафіксавайце адна «золатая» транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да попераднего стану перш чым расшырваць сферу дзеяння. Зберагаюце настройкі пазыроўна ад коду прыемліцеля. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцый павінны знаходзіцца ў адном месцы, куда аператары можуць адбавляць контроль без неабяжнага чытання всіх дадзеных. Зберагаюце стан графа ў простам і тыпаваным фармаце. Вкладныя блокі маскуюць інфармацыю пра тое, які вузел запісаў якое поле, і спакоююць працу пасля перэрываў.
Pillar 4: Навыкі, якія агент завантажае за патрэбай
У роўні Pillar 4 Skills усё працюе найкрашча, калі яго спрыяглядаць як вімерную паверхню. Зафіксуйце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па анулюванні змян перш чым расшырваць масштаб. Документавайце як шлях успеху, так і шлях вяснавання разам. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не наступным етапам дорабкі. Храніце стан графаў у простам і тыпаваным фармаце. Вкладзеныя блокі маскуюць, які вузел запісаў якое поле, і спакшуюць продовжэнне працы пасля перэрываў. У роўні Pillar 4 Skills усё працюе найкрашча, калі яго спрыяглядаць як вімерную паверхню. Зафіксуйце адна ідэальная транскрыпцыя, адзін прыклад неудачы і прыметку па анулюванні змян перш чым расшырваць масштаб. Спрыяглядайце гэты роўнь як кантракт між вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задайце крытэрыя успеху і адмовіцеся ад беззвучнага частковага завершэння.
- research: Conducts multi-source web research with citation
- writer: Drafts long-form content matching house style
- sql_query: Runs read-only queries against the analytics warehouse
Чатыры сталпы — гэта той самы трук чатыры разы
Чатыры асаліны — гэта этап, апрацоўкі вхідных дадзенняў, адпаведальны за даны этапу і крэтыяры завершэння, якія трэба візначыць пры змены коду. Аператары должны магчымае перзапускаць даны этап з вядомай точкі контролю, не падозрываючы прыхованы статус. Запісваць час выканання і кост токенаў або запытаў праза функцыйнае рэзультат. Відкрытыя даныя пра косцы запобегаюць неспакоўным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя. Пры застосаванні грошэй або змены дадзенняў у працы трэба атрымваць затверджэнне чалавека. Праця ў час компілявання не абавесць цэлыснасцю бізнес-процэса.
Як насправдзе прабавіць гэта
Для этапу «Як насправды спробаваць» неабяжна пазначыць вхідныя даны, адміністратара крока і крытэрыя завершэння пры перадзеіснавленні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Конфігурацыю трэба залічыць пазнаходзяцца за межамі коду прыкладнення. Файлы сераўнавання, хранільнікі секрэтных даных і флагі функцыйяў павінны знаходзіцца ў адном месцы, якое аператары можаць пераглядаць, не чытаяўшы весь ланцуг задач. Неабяжна працаваць з апраўданнем чалавека для рэшэнняе, якія ведуць да выдаткаў грошаў або змян у продакшн-даных. Підключэння пад час компіляцыі не ёсць гарантыяй полнай адпаведнасці бізнес-процэсаў.
pip install deepagents
import os
from pathlib import Path
from deepagents import create_deep_agent
from deepagents.backends import FilesystemBackend
from tavily import TavilyClient
tavily = TavilyClient(api_key=os.environ["TAVILY_API_KEY"])def web_search(query: str, max_results: int = 5):
return tavily.search(query, max_results=max_results)workspace = Path("./workspace").resolve() # root_dir must be absolute
workspace.mkdir(exist_ok=True)agent = create_deep_agent(
model="anthropic:claude-3-5-sonnet-latest",
system_prompt="You are a senior analyst. Use web search to find sources, save the raw results to disk, then synthesize.",
tools=[web_search],
backend=FilesystemBackend(root_dir=str(workspace), virtual_mode=True),
)result = agent.invoke({"messages": [{"role": "user", "content": "Brief me on the current state of LLM agent frameworks"}]})print(result["messages"][-1].content)
Што дадаць даўжэй
У другій стадыі «Што дадаць» неабяжна практычна ваказваць інпуты, адміністратара крока і крэтырыя выходу пры перадзеіснаванні коду. Аператары павінны магчымаць перзапуск крока з вядомай точкі контролю без адгадванняя схованага стану. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Неабяжна застаўляць людзкую апраўдку для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны праўдзівай працы. Працэс кампілявання не ўзроўнаваецца з повнасцю бізнес-функцый. У другій стадыі «Што дадаць» неабяжна практычна ваказваць інпуты, адміністратара крока і крэтырыя выходу пры перадзеіснаванні коду. Аператары павінны магчымаць перзапуск крока з вядомай точкі контролю без адгадванняя схованага стану. Спрыймайце гэтую стадыю як кантракт межа інпутамі і апраўданымы выходамі. Даць назву артыфактам, ваказваць перакрыцці успеху і адмовіцца ад безгучнага частковага завершэння.
Дзе Deep Agents ўжо не падходзіць як інструмент
Калі працуеце на стадыі Where Deep Agents, спачатку запішыце умовы вікорыстання: неабяжлівыя даны, сігнал успеху і тое, што будзе адбывацца у разе частковага невыпання. Такі спіс дапамагае залішацца чыстым пад час пазнейшых змян у кодзе. Запісвайце час выканання і кост токеноў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая візуабельнасць костаў запобегае неспакойным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўсы. Запісвайце назву інструмента, хэш аргументаў, час затрымкі і рэзултат кожнага вызову. Без такога журналу дэбаггін цыклаў агента губіць гадзіны.
Вывык, які можна выкарыстоўваць, нават калі вы ніколі не будзеце працаваць з гэтай бібліятэкай
Калі працуеце над процэсам выкарыстоўвання, спачатку запішыце угоду: неабходныя даны, сігнал успеху і тое, што выканаецца у разе частковага невыпалення. Такі спіс пераканальвае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагаюце настройкі паза кодам прыемлі. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт без неабяжнага чытання всіх элементаў. Ствараюце контрольныя пункты пасля дорогіх крокаў. Сістэма вярнення не должна занова ставіць плату за той самы вызыв LLM, калі аператар перапрыяўляе працу да наступнага элемента.
Чэк-ліст для эксплуатацыі
Этап чэк-ліста для эксплуатацыі працюе найэфектывней, калі яго спрыяглядаць як мерыемую плошчу. Запісаўце адну ідэальную транскрыпцію, адзін прыклад невыпалення і прыметкі па вярненню да пачатковага стану, перш чым расшырваць сферу дзеяння.
Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выканаецца, прычына невыпалення должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач.
Зберагаюць стан графа ў простам і тыпаваным фармаце. Вкладаныя блобы маскуюць інфармацію пра тое, які вузел запісаў якое поле, і спакоююць працэзвалечэнне пасля перэрываў.
Калі дозволяе бюджэт, дадзіце тэст на перакананне, які працюе з крытычным шляхам у CI за дапамою фіксатываў, а не з рэальнымі платнымі API.
Спрыяйце цэй стадзіі як кантракту межа вхіднымі дадзеннямі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задзержыце перакананні на успех і адмовіцеся ад беззвучнага частковага завершэння.
Зберагаюць стан графа ў простам і тыпаваным фармаце. Вкладаныя блобы маскуюць інфармацію пра тое, які вузел запісаў якое поле, і спакоююць працэзвалечэнне пасля перэрываў.
Перш чым апранаваць стэк, заморозьце версіі, зафіксуйце ідэальны транскрыпт для крытычнага шляху і падтвердзіце крокі для абраткі. У спадзяльных сэрвісах патрабуецца наяўнасць лімітаваў швайна, перакананняў на прыналежнасць і чыстае відпаведальнае аб’екта для ротацыі секрэтных дадзенняў. Валіце надзейнасць працы над красавім разовым дэманстрацыйным прыкладам.
Запіска параграфу 8916e9958e68: не трэба кантрацеўваць ключы прадастоўніка ў рэпазітарыі, задаць максімальную кантроль на токены за сесію, а таксама зберагчы транскрыпціі праза фіксатуры адлічэння, каб пазнейшыя замены мадэляў заставалі пораўняннымі.
Калі працуеце над стадзіяй 0 запіскі пра зміцнэнне, спачатку запісайце контракт: неабходныя вхідныя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі чэк-ліст дапамагае заставаць пазнейшыя змены коду чыстымі. Валіце маленькія, тэставаныя елементы працы над кодам замест аб’емных скрыптав. Калі якісь крок не выйшае, прычына невыпання павінна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны працэс.
Дзеянне пра зміцнэнне 0/751: вы мерзіце час выканання, класыя ошыбак і вітрату токенав для гэтай запіскі, а пасля выявляеце, чы рашаце застаўіць змену на адной фіксованай сэтке пытанняў, а не на адной лячбе.