Галоўная / Артыкулы

Шматагентныя AI-сістэмы на LangChain

Шматагентныя AI-сістэмы на LangChain: што такое шматагентная сістэма, калі некалькі агентаў лепшыя за аднаго LLM-агента і як пабудаваць і звязаць ролі.

Выдавец: REACTAPP.TOP11 хв чытання2636 слоў

Крыніцы: Multi-Agent AI Systems with LangChain: Building an Orchestrator That Delegates Work

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

1. Чаму ёсць сістэма з калькольнікарамі?

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

User
  |
  v
Single Agent
  |
  +-- Search
  +-- Analyze
  +-- Calculate
  +-- Generate Report
                         User
                           |
                           v
                    +--------------+
                    | Main Agent   |
                    | Orchestrator |
                    +------+-------+
                           |
              +------------+------------+
              |                         |
              v                         v
       +-------------+           +-------------+
       | Math Agent  |           | Search Agent|
       +-------------+           +-------------+
              |                         |
          square()                  search()

2. Чаму вікорыстоўваць калькі агента?

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

Database queries
Security analysis
Documentation search
Report generation
"I have a database question → call database agent."
"I have a security question → call security agent.""I need documentation → call documentation agent."

Адны агент

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

                    LLM
                     |
       +-------------+-------------+
       |             |             |
    Database       Search       Security
       |             |             |
       +-------------+-------------+

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

Калькольнік агентаў

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

                      Main Agent
                    /     |      \
                   /      |       \
                  v       v        v
             DB Agent  Search   Security
                        Agent      Agent

3. Прыклад: Два спецыялізаваныя кальманаў

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

Calculate the square of a number
Calculate the square root of a number
@tool
def square_root(x: float) -> float:
    """Calculate the square root of a number"""
    return x ** 0.5
@tool
def square(x: float) -> float:
    """Calculate the square of a number"""
    return x ** 2
subagent_square_root = create_agent(
    model=llm,
    tools=[square_root]
)
subagent_square = create_agent(
    model=llm,
    tools=[square]
)
square_root()
square()

4. Важлівая частка: ператварэнне агентаў у інструменты

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

@tool
def call_subagent_square_root(x: float) -> float:
    """Call subagent 1 in order to calculate
    the square root of a number"""
    response = subagent_square_root.invoke(
        {
            "messages": [
                HumanMessage(
                    content=f"Calculate the square root of {x}"
                )
            ]
        }
    )    return response["messages"][-1].content
@tool
def call_subagent_square(x: float) -> float:
    """Call subagent 2 in order to calculate
    the square of a number"""
    response = subagent_square.invoke(
        {
            "messages": [
                HumanMessage(
                    content=f"Calculate the square of {x}"
                )
            ]
        }
    )    return response["messages"][-1].content
Main Agent
     |
     +-- call_subagent_square_root()
     |
     +-- call_subagent_square()

5. Стварэнне Orchestratorа

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

main_agent = create_agent(
    model=llm,
    tools=[
        call_subagent_square_root,
        call_subagent_square
    ],
    system_prompt=
        "You are a helpful assistant who can call "
        "subagents to calculate the square root or "
        "square of a number."
)
                         User
                           |
                           |
                           v
                  +----------------+
                  |   Main Agent    |
                  |  Orchestrator   |
                  +-------+--------+
                          |
                 Tool selection
                    /          \
                   /            \
                  v              v
        +----------------+  +----------------+
        | Square Root    |  | Square         |
        | Subagent       |  | Subagent       |
        +-------+--------+  +-------+--------+
                |                  |
                v                  v
          square_root()        square()

6. Што выканаецца, калі корыстнік задае запітанне?

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

What is the square root of 456?
response = main_agent.invoke(
    {
        "messages": [
            HumanMessage(
                content="What is the square root of 456?"
            )
        ]
    }
)
call_subagent_square_root(x=456)
Calculate the square root of 456
square_root()
21.3541565
The square root of 456 is approximately 21.35.
User
 |
 | "What is the square root of 456?"
 v
Main Agent
 |
 | selects call_subagent_square_root
 v
Square Root Subagent
 |
 | invokes square_root(456)
 v
21.3541565
 |
 v
Main Agent
 |
 v
"The square root of 456 is approximately 21.35."

7. Дзе месца LLM?

Калі працуеце над этапам «7 Where Does the», спачатку запісайце умовы працы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі спіс дапамагае заліцварваць будучыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выходзіць, неудача должна адносіцца да конкрэтнай адпаведальнасці, а не да заплутанага ланца задач. Зберагайце інструкціі стабільной сістэмы і схемы інструментоў у кэшы. Перадзесланне ідэнтычных даных — частая прычына зайвых вітрацэў. Калі працуеце над этапам «7 Where Does the», спачатку запісайце умовы працы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі спіс дапамагае заліцварваць будучыя змены ў кодзе. Запісвайце час выканання і вартасьць токена або запыту разам з функцыйнальнымі рэзультатамі. Відразувая візуабілізацыя вартасцей запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя сераўы.

llm = ChatOllama(
    model="llama3.2:latest",
    base_url="http://localhost:11434",
    temperature=0,
)
                Ollama / Llama
                     |
          +----------+----------+
          |                     |
          v                     v
     Main Agent            Subagents
     Orchestrator          Specialized
Main Agent       → powerful reasoning model
Security Agent   → security-specialized modelCoding Agent     → coding modelSimple Agent     → smaller/cheaper model

8. Канцэпцыя «Мнагае агентства» не значыць наявнасць калькольнікаў мовы

Метод «8. Канцэпцыя „Мнагае агентства“ не значыць наявнасць калькольнікаў мовы“ працуе наявнасць лепшая, калі яго розглядаць як мерыемую паверхню. Перш чым расшырваць масштаб, зафіксавайце адна ідэальная транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану. Храніце настройкі за межамі коду прыемлівача. Файлы сераўнавальнага сяродовішча, базы секрэтных даных і флагі функцый павінны знаходзіцца ў адном месцы, куды аператары можаць адбавляць контроль, не чытаючы весь граф. Задаце ліміты токенав на рунд і на сесію. Інструменты агентства агрэсывна расшырваюць кантэкст; строгі ліміты не дазволяюць дэманстрацыям ператварацца на неспакоўныя рахункі.

Model A
  |
  +-- Agent 1
  +-- Agent 2
  +-- Agent 3
Model A → Agent 1
Model B → Agent 2
Model C → Agent 3
Agent =
    Model
  + Instructions
  + Tools
  + State/Context
  + Decision-making

9. Чаму проста не дасці всіх інструментоў аднаму агенту?

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

                         Orchestrator
                              |
          +-------------------+-------------------+
          |                   |                   |
          v                   v                   v
    Database Agent       Security Agent      Research Agent
          |                   |                   |
       PostgreSQL          SIEM/Security       Web/MCP
                              |
                              v
                       Report Generator

10. Рабочы працэс з калькамі агентаў проты секвэнцыйнага

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

Парадоксальны прабег задач

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

Step 1
  ↓
Step 2
  ↓
Step 3
  ↓
Step 4
Retrieve documents
      ↓
Analyze documents
      ↓
Generate report
      ↓
Send email

Сістэма з многамі агентамі

Для этапы Orchestrated multi-agent system неабяжна ўзначыць вхідныя даны, абавесця крока і крэтыры завершэння пры перадзеі коду. Аперацыйныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не падозрываючы схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцці і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не яго пазнейшай дапрацоўкі. Неабяжна застаўляць людзкую затверджэнне для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны праўлення. Працэс складання коду не ёсць адпаведнікам пачынковай готовасці продукту для эксплуатацыі.

                     Orchestrator
                    /     |      \
                   /      |       \
               Agent A  Agent B  Agent C
Workflow = predefined control flow
Multi-Agent =
LLM-driven delegation between specialized agents

11. Архітэктура праўлення

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

User
                           |
                           v
                 +-------------------+
                 | Orchestrator      |
                 | Agent             |
                 +---------+---------+
                           |
          +----------------+----------------+
          |                |                |
          v                v                v
    +-----------+    +-----------+    +-----------+
    | Research  |    | Security  |    | Database  |
    | Agent     |    | Agent     |    | Agent     |
    +-----+-----+    +-----+-----+    +-----+-----+
          |                |                |
          v                v                v
       Web/MCP          SIEM/APIs       PostgreSQL
          |                |                |
          +----------------+----------------+
                           |
                           v
                  +----------------+
                  | Final Response |
                  | / Report Agent |
                  +----------------+
Research Agent
    → web search
    → document retrieval
    → RAG
Security Agent
    → SIEM
    → vulnerability database
    → security APIsDatabase Agent
    → SQL
    → analyticsReport Agent
    → summarize
    → format
    → email

12. Галоўныя выводы

1. Спецыялізаваць агенты

Agent → one domain / capability

2. Абгортваць падагенты як інструменты

Main Agent
    |
    +-- Subagent Tool

3. Дазволіць оркестрабісту дэлегаваць задачы

4. Залічваць інтэрфейсы простымі

Tool name
Description
Arguments
Result

5. Пачынаць проста

AI Orchestrator
                         |
        +----------------+----------------+
        |                |                |
    Research          Coding          Security
      Agent            Agent            Agent
        |                |                |
       MCP             GitHub          Security APIs
       RAG             Tools           SIEM

Заключэнне

User
  ↓
Main Agent
  ↓
Tool representing a subagent
  ↓
Specialized Subagent
  ↓
Domain-specific Tool
  ↓
Result
  ↓
Main Agent
  ↓
User

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