Многопроцессорные ИИ-системы с LangChain: создание
Многоагентные системы ИИ с LangChain: что такое многоагентная система, когда несколько агентов превосходят одного агента на основе LLM, и как создавать и связывать роли.
Источники: 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. Важная часть» необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед внесением изменений в код. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Лучше использовать небольшие, тестируемые единицы кода вместо обширных скриптов. При сбое шага причина должна быть связана с конкретной функцией, а не с запутанной структурой обработки данных. Аутентификация происходит на входе, а повторная авторизация — на уровне обработки данных. Одного только токена недостаточно для определения границ использования ресурсов. На этапе «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. Создание оркестратора
При работе над этапом 5 «Создание оркестратора» сначала запишите условия работы: необходимые входные данные, сигнал о успешном выполнении и действия при частичной неудаче. Такой список поможет сохранять честность при последующих изменениях кода. Храните конфигурацию отдельно от кода приложения. Файлы с настройками окружения, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь граф выполнения. Создавайте контрольные точки после дорогостоящих операций. Функция возобновления выполнения не должна повторно взимать плату за один и тот же вызов большой языковой модели, когда оператор пытается выполнить следующий узел заново.
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. Что происходит?» сначала запишите условия работы: необходимые входные данные, сигнал о успешном выполнении и действия при частичной неудаче. Такой чек-лист поможет сохранять честность при последующих изменениях кода. Документируйте одновременно успешный и восстановительный сценарии работы. Повторные попытки, проверки со стороны оператора и обработка некорректных сообщений являются частью продукта, а не элементами последующей доработки. Выполняйте контрольные точки после дорогостоящих операций. Система возобновления работы не должна снова взимать плату за один и тот же вызов большой языковой модели, если оператор пытается выполнить последующий этап заново.
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. Какова роль большой языковой модели?
При работе над этапом «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 «Модель с несколькими агентами — это не несколько LLM» работает наилучшим образом, когда его рассматривают как измеримую структуру. Сначала соберите один идеальный пример работы, один случай сбоя и запись о возврате к предыдущему состоянию, прежде чем расширять объём задачи. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь код. Установите лимит токенов на один ход и на сессию. Инструменты агентов активно расширяют контекст; жёсткие ограничения предотвращают появление неожиданных счетов.
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