Головна / Статті

Багатоагентні системи ШІ з LangChain: створення

Багатоагентні системи ШІ з LangChain: що таке багатоагентна система, коли кілька агентів перемагають одного агента на основі LLM, та як створювати та поєднувати ролі.

Видавець: REACTAPP.TOP11 хв читання2636 слів

Джерела: Multi-Agent AI Systems with LangChain: Building an Orchestrator That Delegates Work

Наведені нижче примітки описують практичний підхід до розробки «Багатоагентних систем ШІ з 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. Приклад: два спеціалізовані агенти

Для 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 The Important Part“ необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Краще використовувати невеликі, перевірювані одиниці коду замість об’ємних скриптів. Коли крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на складну структуру процесу. Аутентифікуйтеся біля шлюзу та знову авторизуйтесь на рівні обробки даних. Один лише токен не є межею окремого сервісу. На етапі „4 The Important Part“ необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Чітке бачення витрат заздалегідь запобігає несподіваним рахункам під час переходу від демо-середовищ до спільних.

@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. Створення оркестратора

Під час виконання 5 етапу «Створення оркестратора» спочатку запишіть умови використання: необхідні вхідні дані, сигнал про успіх та наслідки часткової невдачі. Такий перелік допоможе зберегти чесність подальших змін у коді. Зберігайте конфігурацію окремо від коду додатку. Файли середовища, сховища конфіденційних даних та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь граф. Робіть контрольні пункти після дорогих операцій. Функція відновлення не повинна знову стягувати плату за той самий виклик 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. Концепція багатьох агентів не означає наявності кількох LLM

Методологія 8 Multi-Agent Does Not працює найкраще, якщо її розглядати як вимірювану поверхню. Зберігайте один ідеальний зразок виконання, один випадок невдачі та примітки щодо скасування дій перед розширенням обсягу завдань. Тримайте конфігурацію поза кодом додатку. Файли середовища, сховища конфіденційних даних та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код. Встановіть ліміти кількості токенів на раунд та сесію. Інструменти агентів активно розширюють контекст; жорсткі обмеження запобігають тому, що демонстрації перетворюються на несподівані рахунки.

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“ функціонує найкраще, якщо його розглядати як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування дій перед розширенням обсягу роботи. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Чітке бачення витрат заздалегідь запобігає несподіваним витратам під час переходу від демо-версії до спільних середовищ.

Послідовний робочий процес

Для етапу послідовного робочого процесу необхідно визначити вхідні дані, відповідальну особу за крок та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Конфігурацію слід тримати окремо від коду додатку. Файли середовища, сховища конфіденційних даних та флаги функціоналу мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь алгоритм. Встановіть людське схвалення для дій, які призводять до витрат грошей чи змінюють дані у продакшені. Підключення на етапі компіляції не є гарантією повноти бізнес-функціоналу.

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

Оркестрована багатоагентна система

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

                     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

Чек-лист для експлуатації