Эксперт по организации агентов

---
name: agent-organization-expert
description: Навык оркестрации нескольких агентов для формирования команд, декомпозиции задач, оптимизации рабочих процессов и разработки стратегий координации с целью оптимальной производительности команды и использования ресурсов.
---

# Организация агентов

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

## Конфигурация

- **Количество агентов**: ${agent_count:3}
- **Тип задачи**: ${task_type:general}
- **Шаблон оркестрации**: ${orchestration_pattern:parallel}
- **Максимальная параллельность**: ${max_concurrency:5}
- **Тайм-аут в секундах**: ${timeout_seconds:300}
- **Количество повторных попыток**: ${retry_count:3}

## Основной процесс

1. **Проанализируй требования**: пойми объём задачи, ограничения и критерии успеха.
2. **Сопоставь возможности**: соотнеси доступных агентов с необходимыми навыками.
3. **Спроектируй рабочий процесс**: создай план выполнения с зависимостями и контрольными точками.
4. **Организуй выполнение**: координируй ${agent_count:3} агентов и отслеживай прогресс.
5. **Постоянно оптимизируй**: адаптируйся на основе обратной связи о производительности.

## Декомпозиция задачи

### Анализ требований
- Разбей сложные задачи на отдельные подзадачи.
- Определи требования к входным и выходным данным каждой подзадачи.
- Оцени сложность и потребности в ресурсах каждого компонента.
- Определи ясные критерии успеха для каждой единицы работы.

### Отображение зависимостей
- Задокументируй ограничения порядка выполнения задач.
- Выяви зависимости по данным между подзадачами.
- Определи требования к совместному использованию ресурсов.
- Выяви потенциальные узкие места и конфликты.

### Планирование сроков
- Выстрой последовательность задач с учётом зависимостей.
- Определи возможности распараллеливания: до ${max_concurrency:5} одновременных задач.
- Предусмотри запас времени для компонентов с высоким риском.
- Определи контрольные точки для проверки прогресса.

## Выбор агентов

### Сопоставление возможностей
Выбирай агентов на основе:
- Соответствия необходимых навыков специализациям агентов.
- Предыдущих результатов в аналогичных задачах.
- Текущей доступности и способности принять нагрузку.
- Экономической эффективности для данной сложности задачи.

### Приоритет критериев выбора
1. **Соответствие возможностей**: агент должен обладать необходимыми навыками.
2. **История результатов**: предпочитай агентов с доказанным успехом.
3. **Доступность**: достаточные возможности для своевременного завершения.
4. **Стоимость**: оптимизируй использование ресурсов в пределах ограничений.

### Резервное планирование
- Определи альтернативных агентов для критических ролей.
- Определи условия переключения на резерв и процедуры передачи работы.
- Поддерживай резервирование для задач, являющихся единственной точкой отказа.

## Формирование команды

### Принципы состава
- Обеспечь полное покрытие навыков для всех подзадач.
- Сбалансируй нагрузку между ${agent_count:3} участниками команды.
- Минимизируй издержки коммуникации.
- Предусмотри резервирование критических функций.

### Назначение ролей
- Сопоставляй агентов с подзадачами на основе сильных сторон.
- Чётко определи владельцев задач и ответственность.
- Установи каналы коммуникации между зависимыми ролями.
- Задокументируй пути эскалации блокеров.

### Размер команды
- Меньшие команды для тесно связанных задач.
- Большие команды для распараллеливаемых нагрузок.
- Учитывай затраты на координацию при выборе размера.
- Динамически масштабируй команду по мере прогресса.

## Шаблоны оркестрации

### Последовательное выполнение
Используй, когда у задач строгие требования к порядку:
- Задаче B нужен результат задачи A.
- Состояние должно быть согласованным между шагами.
- Обработка ошибок требует упорядоченного отката.

### Параллельная обработка
Используй, когда задачи независимы (${orchestration_pattern:parallel}):
- Между задачами нет зависимостей по данным.
- Раздельные требования к ресурсам.
- Результаты можно объединить после завершения.
- Максимум ${max_concurrency:5} одновременных операций.

### Конвейерный шаблон
Используй для потоковой или непрерывной обработки:
- Каждый этап обрабатывает и передаёт результаты дальше.
- Позволяет одновременно выполнять разные этапы.
- Снижает общую задержку многошаговых процессов.

### Иерархическое делегирование
Используй для сложных задач, требующих подчинённой оркестрации:
- Ведущий агент координирует подкоманды.
- Каждая подкоманда отвечает за предметную область.
- Результаты агрегируются вверх по иерархии.

### Map-Reduce
Используй для крупномасштабной обработки данных:
- Фаза Map распределяет работу между агентами.
- Каждый агент обрабатывает свою часть.
- Фаза Reduce объединяет результаты.

## Проектирование рабочего процесса

### Структура процесса
1. **Точка входа**: проверка входных данных и инициализация состояния.
2. **Фазы выполнения**: упорядоченные группы задач.
3. **Контрольные точки**: точки сохранения состояния и проверки.
4. **Точка выхода**: объединение результатов и очистка.

### Управляющий поток
- Определи условия ветвления для альтернативных путей.
- Укажи политики повторных попыток при временных сбоях: максимум ${retry_count:3} повторов.
- Установи пороги тайм-аутов для каждой фазы: по умолчанию ${timeout_seconds:300} с.
- Предусмотри корректное снижение функциональности при частичных сбоях.

### Поток данных
- Задокументируй преобразования данных между этапами.
- Укажи форматы данных и правила проверки.
- Предусмотри сохранение данных в контрольных точках.
- Обработай очистку данных после завершения.

## Стратегии координации

### Шаблоны коммуникации
- **Прямая**: от агента к агенту при тесной связанности.
- **Широковещательная**: от одного ко многим для обновлений статуса.
- **На основе очереди**: асинхронная для слабо связанных задач.
- **Событийная**: реакция на изменения состояния.

### Синхронизация
- Определи точки синхронизации зависимых задач.
- Реализуй механизмы ожидания с тайм-аутами: ${timeout_seconds:300} с.
- Корректно обрабатывай завершение не по порядку.
- Поддерживай согласованное состояние между агентами.

### Разрешение конфликтов
- Установи правила приоритетов при конкуренции за ресурсы.
- Определи механизмы арбитража конфликтов.
- Задокументируй процедуры отката при взаимных блокировках.
- Предотвращай конфликты тщательным планированием расписания.

## Оптимизация производительности

### Балансировка нагрузки
- Распределяй работу в соответствии с возможностями агентов.
- Отслеживай загрузку и динамически перераспределяй её.
- Избегай перегрузки высокопроизводительных агентов.
- Для задач с интенсивной обработкой данных учитывай расположение агента относительно данных.

### Управление узкими местами
- Выявляй медленные этапы через мониторинг.
- Увеличивай мощности ограничивающих ресурсов.
- Перестраивай процессы для уменьшения зависимостей.
- Кешируй промежуточные результаты, когда это полезно.

### Эффективность ресурсов
- Объединяй общие ресурсы агентов в пулы.
- Своевременно освобождай ресурсы после использования.
- Выполняй похожие операции пакетно для уменьшения накладных расходов.
- Отслеживай нерациональное использование ресурсов и оповещай о нём.

## Мониторинг и адаптация

### Отслеживание прогресса
- Отслеживай статус завершения каждой задачи.
- Сопоставляй затраченное время с оценками.
- Выявляй задачи, которым грозит задержка.
- Сообщай заинтересованным сторонам сводный прогресс.

### Показатели производительности
- Доля завершения задач и задержка.
- Загрузка агентов и пропускная способность.
- Частота ошибок и время восстановления.
- Потребление ресурсов и стоимость.

### Динамическая корректировка
- Перераспределяй агентов в зависимости от прогресса.
- Корректируй приоритеты с учётом блокеров.
- Меняй размер команды в зависимости от нагрузки.
- Изменяй рабочий процесс на основе полученных знаний.

## Обработка ошибок

### Обнаружение сбоев
- Отслеживай сбои задач и тайм-ауты: порог ${timeout_seconds:300} с.
- Быстро выявляй недоступность агентов.
- Выявляй закономерности каскадных сбоев.
- Оповещай об аномальном поведении.

### Процедуры восстановления
- Повторяй операции при временных сбоях с увеличением интервала: до ${retry_count:3} попыток.
- При необходимости переключайся на резервных агентов.
- При критическом сбое откатывайся к последней контрольной точке.
- Передавай на более высокий уровень проблемы, которые невозможно устранить.

### Предотвращение
- Проверяй входные данные до выполнения.
- Проверяй доступность агента до назначения.
- Проектируй систему с возможностью корректного снижения функциональности.
- Встраивай резервирование в критические пути.

## Обеспечение качества

### Контрольные проверки
- Проверяй результаты в каждой контрольной точке.
- Перекрёстно проверяй результаты параллельных задач.
- Проверяй окончательные объединённые результаты.
- Подтверждай выполнение критериев успеха.

### Стандарты производительности
- Целевая точность выбора агентов: >${agent_selection_accuracy:95}%.
- Целевая доля завершения задач: >${task_completion_rate:99}%.
- Целевое время ответа: <${response_time_threshold:5} секунд.
- Использование ресурсов: оптимальный диапазон ${utilization_min:60}-${utilization_max:80}%.

## Лучшие практики

### Планирование
- Уделяй время тщательному анализу задач.
- Документируй предположения и ограничения.
- Заранее планируй сценарии сбоев.
- Определяй ясные показатели успеха.

### Выполнение
- Начинай с минимально жизнеспособной команды: ${agent_count:3} агентов.
- Масштабируйся на основе наблюдаемых потребностей.
- Поддерживай ясные каналы коммуникации.
- Отслеживай прогресс относительно контрольных этапов.

### Обучение
- Сохраняй данные о производительности для анализа.
- Выявляй закономерности успехов и неудач.
- Совершенствуй стратегии выбора и координации.
- Используй полученные знания при последующих оркестрациях.