Практычныя прытамулі: Глęбокіе агенты: Чы гэта LangChain з адкрытым кодам з’явіўся на базе Claude Code?

Наступныя прыміткі паказваюць практычны падход да разумэння тэмы «Deep Agents: Чы гэты LangChain адкрыў архітектуру Claude Code?». Акцэнс ставяецца на кантракты, пераконтроўваннія і месца для коду, які можна легка адразу выкарыстоўваць, а не на мотывацыйныя аспекты. Калі працуеце на стадзіі агляду, спачатку запісайце кантракт: неабходныя даны, сігнал успеху і тое, што выканаецца у разы частковага невясковасці. Такі список дапамагае залічыцца з пазнейшымі змянамі ў кодзе. Храніце настройкі парадульна ад коду прыемлівача. Файлы серавэра, храненнія секретных данных і флагі функцый должны знаходзіцца ў аднам месцы, куда аператары можу пераглядаць без неабяжнага чытання всіх элементаў системы.

Архітектура Claude Code з адкрытым кодам?

Стэйдж Open-Source Claude Code працюе найкраща, калі яго спрыяваць як мерыемую паверхню. Запісаце адна ідеальная транскрыпцыя, адзін прыклад неудачы і прыметку па абяцуванні роботы перш чым расширваць масштабы. Дакументавайце як успішны, так і варыянт вярнення да нормальнага стану. Перапрыбуткі, людзкія контрольны пункты і обработка некоректных паведамленняў ёсць частью продукту, а не пасляднім дапрацоўкам. Храніце стан графа ў простым і типаванам формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакшуюць продовжэнне роботы пасля перарываў.

Што ён на самай працоўцы

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

pip install deepagents

from deepagents import create_deep_agent
agent = create_deep_agent(
    model="openai:gpt-5.5",  # or anthropic:..., google_genai:..., a local one
    tools=[my_tool],
    system_prompt="You are a research assistant.",
)That’s real. It works. You get planning, a virtual file system, subagent delegation, human-in-the-loop, and shell access — plus everything LangGraph already gave you (streaming, checkpointing, Studio).

Менш вядомы факт №1: інструмент планавання нічога не робіць

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

Менш вядомы факт №2: «даступ да файловай системы» — гэта не ваша файловая система

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

Менш вядомы факт №3: «доўгатэрмінная памяць» — це настройка, а не функцыя

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

Менш вядомы факт №4: для участі людзя ў процэсе неабходны точкі контролю

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

Не трэба чытаць весь граф.

Менш вядомы факт №5: вашы падагенты раней былі спрабоўваны з’есть, і самэ гэта ёсць прычыной, чаму вам даўнае значэнне версій.

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

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

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

Пра тое “$0”

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

Пра “будзь-які модель”

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

То чы гэта варта спробаваць?

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

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

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

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

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

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

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

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

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

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