Собрать команду агентов

Это руководство показывает, как создать команду, назначить ей лидера и направлять ей работу.

Команда — это именованная группа агентов внутри одного рабочего пространства, в которой один агент назначен её лидером. Когда вы назначаете команде тикет, лидер просыпается, разбивает работу на части и делегирует её участникам; когда запуск участника завершается, лидер просыпается снова, чтобы решить, что делать дальше.

Создавайте команды, переименовывайте их и пополняйте состав в разделе Настройки → Рабочее пространство → Агенты → Команды. Направить работу команде можно одним из двух способов: агент вызывает assign_ticket с team_id этой команды, либо узел конвейера Team dispatch запускает команду (без назначения тикета). В списке выбора исполнителя тикета указаны вы и отдельные агенты.

Создать команду

Откройте Настройки → Рабочее пространство → Агенты (/settings/workspace/agents).
Нажмите Команды в верхней части страницы.
Нажмите Добавить команду.
Введите название (например, «backend» или «review squad») и необязательное описание, затем нажмите Создать.

Команда создана и выбрана, а её редактор открывается в правой панели.

Назначить лидера

Именно от этого шага зависит вся функция. В редакторе команды:

В разделе Лидер выберите агента. Текст подсказки описывает его точно: «Координатор, который получает работу команды и делегирует подходящему участнику».
При необходимости заполните Рабочие инструкции — произвольный текст, который передаётся лидеру вместе с каждым направленным тикетом.

Когда вы назначаете агента лидером, он также становится участником, если ещё им не был. Команда, оставленная в состоянии Без лидера, бездействует: при направлении ей работы ничего не запускается, а если убрать текущего лидера из списка участников, команда снова остаётся без лидера.

Добавить участников

В том же редакторе используйте карточку участников, чтобы добавлять агентов из рабочего пространства и удалять их. Участники — это состав, по которому лидер делегирует работу.

Команды привязаны к рабочему пространству: вступить могут только агенты из этого рабочего пространства.

Выделить команде пространство

Автоматического пространства для команды не создаётся. Если оно вам нужно, создайте обычное пространство в разделе Пространства и добавьте в него агентов команды. Сущность Team содержит имя, описание, лидера, инструкции и участников — привязки к пространству у неё нет.

Линии подчинённости — отдельная тема

У каждого агента также есть поле Руководитель, которое задаётся в разделе Настройки → Рабочее пространство → Агенты. Оно формирует дерево подчинённости рабочего пространства, которое можно посмотреть по кнопке Оргсхема на странице агентов.

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

Что делает направленный тикет

Когда тикет действительно несёт назначение на команду:

Лидер команды запускается вместе с тикетом, своими рабочими инструкциями и составом участников.
Лидер делегирует работу участникам и фиксирует свою оценку инструментом record_team_activity — action (делегировано), no_action (делать больше нечего, что останавливает дальнейшие повторные срабатывания) или failed.
Каждый завершённый запуск участника снова будит лидера, ограниченный защитной проверкой no-action.

Узел конвейера Team dispatch — это вторая точка входа. Он принимает идентификатор команды, промпт и режим диспетчеризации:

allParallel — по одной задаче на участника в общий скрытый разговор, приостановка до завершения всех запусков, при этом вывод каждого участника собирается под выходным ключом узла
manager — запускается только лидер, который координирует работу в разговоре