Шаблоны отряда

Заранее созданные композиции отрядов — выберите шаблон, получите лидера и агентов команды готовыми к работе.

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

Доступные шаблоны

AACWorkflow поставляется с пятью стартовыми шаблонами, каждый оптимизирован для разного вида работы:

Шаблон	Роль	Члены	Вариант использования
Frontend Squad	Создатель фронтенда (лидер)	Исполнитель, Рецензент	Создавать UI-функции полностью
Backend Squad	Создатель бэкенда (лидер)	Специалист по БД, Рецензент API	Реализовать серверные функции
QA Squad	QA-лидер (лидер)	Писатель тестов, Исследователь ошибок	Тестовое покрытие и сортировка ошибок
Fullstack Squad	Архитектор полного стека (лидер)	Создатель фронтенда, Создатель бэкенда, Рецензент кода	Сложные функции по всему стеку
Research Squad	Лидер исследования (лидер)	Писатель документации, Агент анализа	Глубокое исследование и анализ

Каждый шаблон поставляется с описанием, предпросмотром членов и инструкциями по умолчанию, которые направляют сотрудничество отряда.

Создание отряда из шаблона

Через пользовательский интерфейс

Перейдите на Отряды и нажмите + Новый отряд
В модальном окне прокрутите до раздела Начать с шаблона
Нажмите на карточку шаблона (название, описание, список членов)
Либо:
- Нажмите Применить шаблон для создания в один клик, ЛИБО
- Настройте имя отряда и членов в форме ниже, затем нажмите Создать
Вы перенаправлены на новую страницу отряда

Отряд создаётся с:

Лидер: лидер шаблона (например, «Создатель фронтенда»)
Члены: члены шаблона (например, «Исполнитель», «Рецензент»)
Инструкции: инструкции сотрудничества по умолчанию шаблона

Через API

curl -X POST https://aacworkflow.example.com/api/squads/from-template \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "frontend_squad",
    "name": "My UI Team"  # опционально; автогенерируется, если опущено
  }'

Возвращает:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My UI Team",
  "workspace_id": "...",
  "leader_id": "550e8400-e29b-41d4-a716-446655440001",
  "members": [
    {
      "agent_id": "550e8400-e29b-41d4-a716-446655440002",
      "role": "implementer"
    },
    {
      "agent_id": "550e8400-e29b-41d4-a716-446655440003",
      "role": "reviewer"
    }
  ],
  "instructions": "Coordinate UI work: implement, then review before done.",
  "created_at": "2025-06-22T15:30:00Z"
}

Структура шаблона

Каждый шаблон определяется как JSON в каталоге встроенных AACWorkflow:

{
  "id": "frontend_squad",
  "name": "Frontend Squad",
  "description": "Ships UI features end to end",
  "leader": {
    "agent_template_id": "frontend-builder",
    "role": "leader"
  },
  "members": [
    {
      "agent_template_id": "frontend-builder",
      "role": "implementer"
    },
    {
      "agent_template_id": "code-reviewer",
      "role": "reviewer"
    }
  ],
  "default_instructions": "Coordinate UI work: implement, then review before done."
}

При применении шаблона:

Шаблон агента лидера материализуется (создаётся новый агент из него)
Каждый шаблон агента члена материализуется
Создаётся отряд с материализованным лидером и членами
Применяются инструкции по умолчанию

Настройка

После создания шаблона

Как только отряд создан из шаблона, вы можете:

Переименовать отряд — нажмите на название отряда для редактирования
Изменить инструкции — перейдите на Параметры отряда → Инструкции и редактируйте
Добавить/удалить членов — перейдите на Члены и управляйте составом
Изменить лидера — повысьте члена или пригласите нового агента в качестве лидера

Отряд теперь независим от шаблона. Изменение шаблона (в будущей версии AACWorkflow) не повлияет на существующие отряды.

Настройка шаблона (будущее)

В будущих версиях вы сможете:

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

Как создаются агенты шаблона

Когда вы применяете шаблон, AACWorkflow:

Разрешает шаблон по ID (должен существовать во встроенном каталоге)
Для каждого упоминаемого шаблона агента (лидер + члены) вызывает CreateAgentFromTemplate
Создаёт отряд с материализованным лидером
Добавляет каждого материализованного члена в отряд
Устанавливает инструкции по умолчанию

Все UUID — это внутренние циклические переходы. Ввод пользователя — это только template_id (проверенный по каталогу) и опциональный squad_name.

Каждый раз, когда вы применяете шаблон, создаются новые экземпляры агентов. Применение шаблона "Frontend Squad" дважды создаёт двух отдельных агентов frontend-builder.

Список доступных шаблонов

Через пользовательский интерфейс

Перейдите на Отряды → Новый отряд. Модальное окно отображает все доступные шаблоны.

Через API

curl https://aacworkflow.example.com/api/squad-templates \
  -H "Authorization: Bearer <token>"

Возвращает:

[
  {
    "id": "frontend_squad",
    "name": "Frontend Squad",
    "description": "Ships UI features end to end",
    "member_preview": [
      { "agent_template_id": "frontend-builder", "role": "implementer" },
      { "agent_template_id": "code-reviewer", "role": "reviewer" }
    ]
  },
  {
    "id": "backend_squad",
    "name": "Backend Squad",
    "description": "Implement server-side features",
    "member_preview": [...]
  }
]

Получить детали шаблона

curl https://aacworkflow.example.com/api/squad-templates/frontend_squad \
  -H "Authorization: Bearer <token>"

Возвращает:

{
  "id": "frontend_squad",
  "name": "Frontend Squad",
  "description": "Ships UI features end to end",
  "leader": {
    "agent_template_id": "frontend-builder",
    "role": "leader"
  },
  "members": [
    {
      "agent_template_id": "frontend-builder",
      "role": "implementer"
    },
    {
      "agent_template_id": "code-reviewer",
      "role": "reviewer"
    }
  ],
  "default_instructions": "Coordinate UI work: implement, then review before done."
}

Локализация

Названия и описания шаблонов локализованы на всех поддерживаемых языках (английский, русский, корейский, китайский).

Когда вы создаёте отряд через пользовательский интерфейс, название и описание шаблона отображаются на настроенном языке вашего рабочего пространства. default_instructions остаются на английском (по замыслу — они вводятся в подсказки агентов).

Безопасность

ID шаблонов проверяются по встроенному каталогу перед любой записью
Созданные агенты и отряды работают в рамках вашего рабочего пространства
Создание отряда из шаблона требует тех же разрешений, что и ручное создание
Специальные разрешения не требуются; любой член рабочего пространства может создать отряд

Устранение неполадок

«Шаблон не найден» при применении

ID шаблона может измениться или быть удалён. Проверьте доступные шаблоны через API:

curl https://aacworkflow.example.com/api/squad-templates

«Некоторые агенты не создались»

Если создание агента не удаётся на полпути применения шаблона, отряд не создаётся (атомарно). Исправьте основную проблему (например, превышена квота) и попробуйте снова.

«Отряд создан, но не имеет ожидаемых членов»

Проверьте страницу отряда:

Перейдите на Отряды → название отряда
Нажмите на Члены и проверьте список
Если членов нет, вручную добавьте их или пересоздайте отряд

Связанные

Шаблоны агентов — см. как работают шаблоны агентов в Справочник по агентам
Делегирование отряда — см. как отряды координируют работу в Аудит делегирования отряда

Содержание