Мульти-агентная архитектура

Мульти-агентная архитектура позволяет создавать команды агентов, где каждый специализируется на своей области. Агенты могут передавать управление друг другу (handoff), обеспечивая сложные сценарии обработки запросов.

Роли агентов

Самостоятельный (Standalone)

Роль по умолчанию. Агент работает независимо и не участвует в мульти-агентном взаимодействии. Выберите эту роль, если:

Агент решает все задачи самостоятельно.
Нет необходимости в делегировании.
Нужна максимально простая конфигурация.

Оркестратор (Orchestrator)

Главный координатор команды. Оркестратор:

Принимает запросы от пользователей.
Анализирует, какой специалист лучше подходит для решения задачи.
Передаёт управление (handoff) нужному специалисту.
Получает управление обратно, когда специалист завершил работу.

Специалист (Specialist)

Агент, специализирующийся на определённой области:

Получает задачи от оркестратора.
Выполняет работу в рамках своей специализации.
Возвращает управление оркестратору или передаёт другому специалисту.

Как работает делегирование (Handoff)

Механизм делегирования реализован по паттерну Swarm:

Пользователь отправляет сообщение оркестратору.
Оркестратор анализирует запрос и определяет нужного специалиста.
Оркестратор вызывает инструмент transfer_to_colleague, указывая:
- target_agent_id — ID агента, которому передаётся управление.
- transfer_summary — краткое описание контекста: что хочет пользователь и что уже обсуждалось.
Специалист получает полную историю разговора и контекст передачи.
Специалист отвечает пользователю или передаёт управление дальше.

Примечание

При передаче управления специалист получает автоматическую секцию «TRANSFER CONTEXT» в своём промпте, содержащую краткое описание от предыдущего агента. Это позволяет специалисту продолжить разговор, не заставляя пользователя повторять информацию.

Каталог коллег

Каждый агент с коллегами получает в своём промпте секцию «DELEGATION CAPABILITIES» с каталогом доступных коллег:

Available colleagues:
- target_agent_id="agt_abc123" → Менеджер по продажам: Помогает с заказами и ценами
- target_agent_id="agt_def456" → Техническая поддержка: Решает технические вопросы

Агент использует этот каталог для выбора, кому передать управление. Поле «описание» каждого коллеги критически важно для правильной маршрутизации.

Возврат управления

Специалист всегда может вернуть управление главному агенту. Если оркестратор не включён в список коллег специалиста, платформа автоматически добавляет его в каталог как «Main Agent / Supervisor» с описанием «Return control to the main agent».

Защита от рекурсии

Максимальная глубина вложенности передач — 5 уровней.
Максимальное количество коллег — 10 агентов на одного агента.
Счётчик передач сбрасывается при каждом новом сообщении пользователя.

Настройка мульти-агентной системы

Шаг 1: Создайте агентов-специалистов

Для каждой области ответственности создайте отдельного агента:

Создайте нового агента.
Задайте роль Специалист.
Напишите инструкции, чётко определяющие область компетенций.
Заполните поле Описание — оно будет видно оркестратору.
Подключите необходимые инструменты.

Совет

Описание специалиста должно быть кратким и информативным. Например: «Отвечает на вопросы о ценах, скидках, наличии товаров и оформлении заказов» — лучше, чем просто «Продажи».

Шаг 2: Создайте оркестратора

Создайте нового агента.
Задайте роль Оркестратор.
Напишите инструкции для маршрутизации запросов. Пример:

Ты — главный ассистент компании. Определи тему запроса
и передай его подходящему специалисту.

Не пытайся отвечать на специализированные вопросы самостоятельно —
всегда делегируй специалисту.

В секции Коллеги добавьте созданных специалистов.

Шаг 3: Настройте коллег

На странице оркестратора найдите поле Коллеги (появляется при выборе роли «Оркестратор» или «Специалист»).
Выберите агентов-специалистов из выпадающего списка.
В списке доступны все текстовые агенты текущего проекта.
Для обновления списка нажмите кнопку обновления.

Шаг 4: Протестируйте

Откройте чат оркестратора.
Отправьте сообщение из области одного из специалистов.
Наблюдайте в чате за вызовом transfer_to_colleague.
Убедитесь, что специалист подхватывает контекст и отвечает корректно.

Пример команды агентов

Рассмотрим пример интернет-магазина с тремя агентами:

Оркестратор

Роль: Оркестратор Инструкции:

Ты — главный ассистент магазина электроники "TechStore".
Определи тему вопроса клиента и передай его нужному специалисту.
Если вопрос общий (приветствие, благодарность) — отвечай сам.

Коллеги: Менеджер по продажам, Техническая поддержка.

Менеджер по продажам

Роль: Специалист Описание: Помогает с выбором товаров, ценами, наличием и оформлением заказов. Инструкции:

Ты — менеджер по продажам магазина "TechStore".
Помогай клиентам с выбором товаров и оформлением заказов.
Используй базу знаний для поиска информации о товарах.
Когда задача выполнена — верни управление главному агенту.

Техническая поддержка

Роль: Специалист Описание: Решает технические вопросы, помогает с настройкой и ремонтом. Инструкции:

Ты — специалист технической поддержки "TechStore".
Помогай клиентам с техническими вопросами по приобретённым товарам.
Когда задача выполнена — верни управление главному агенту.