Практычныя прытамулкі: LangGraph проты Google ADK у 2026 годзе. Частка 1: Два разныя падходы

Наступныя прытамлівкі восстанавляюць практычны маршрут, які адпавядае тэме «LangGraph проты Google ADK у 2026 годзе. Частка 1: Два разныя падходы да розумення оркестраціі агентаў». Акцэнт ставяецца на контрактах, пераканальных процедурах і месцах для коду, які можна легка адключыць, а не на мотывацыйным падходзе. Калі працуеце над стадіяй агульнага аналізу, спачатку запісайце контракт: неабяжныя даны, сігнал успеху і тое, што выканаецца у разы частковай нявыполненасці. Такі список контроля дапамагае залишыцца чыстым пад час пазнейшых змян у кодзе. Документавайце як шлях успеху, так і шлях вярнення да нормы. Перапрыбуткі, людзкія контрольныя пункты і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазнейш.

Пачатак: LangGraph і ADK стаюць бліжэй

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

Спосаб, якім вы спакульваныя пра LangGraph

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

State
  ↓
Node
  ↓
Decision
 ↙   ↘
A     B
↓     ↓
Tool  Agent
 \     /
  ↓   ↓
 Validation
     ↓
    End

Спосаб працы з Google ADK

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

Coordinator
├── Specialist Agent
├── Specialist Agent
├── Specialist Agent
└── Specialist Agent

Найважнейшыя архітектурныя пытанні: хто кантролюець процес работы?

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

У пераважна дэтэрміністычным формате

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

Receive request
→ validate
→ retrieve information
→ classify
→ call service
→ validate result
→ human approval if necessary
→ respond

У большайшай меры — рабочы процес, кіраўнуемы агентамі

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

ш.

User goal
   ↓
Coordinator
   ↓
Which specialist is needed?
   ↓
Delegate
   ↓
Maybe call another specialist
   ↓
Synthesize

Сяроджысць LangGraph: Явны стан

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

What has already happened?What did the previous agent produce?Which tools were executed?What has been validated?What still needs approval?Where should execution resume?What should the next node actually see?

Сяродзейная сіла ADK: склад агентаў

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

                Coordinator
                      │
        ┌─────────────┼─────────────┐
        ↓             ↓             ↓
    Research       Domain        Action
     Agent          Agent         Agent
        │             │             │
        └─────────────┼─────────────┘
                      ↓
                  Validation

Мнагае агенты не павінна автаматычна значыць лепшае

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

1 agent = simple
5 agents = sophisticated
20 agents = extremely sophisticated

Частка 1: Галоўныя выводы

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

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

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

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

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

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

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

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

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

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