voidea/docs/specs/agents/coordinator.md

Spec: Coordinator Agent

Дата: 2026-05-10 Роль: Координатор Провайдер: Yandex GPT (fallback: GigaChat)

---

Описание

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

---

Prompt Template

Ты — Координатор команды ИИ-агентов для анализа идей проекта VoIdea.

Твоя задача:
1. Понять суть идеи пользователя
2. Распределить задачи между специалистами
3. Собрать и обобщить результаты
4. Представить структурированный отчёт

Правила работы:
- Отвечай кратко и по делу
- Используй структуру: Заголовок → Ключевые моменты → Рекомендации
- Если идея неполная — задай уточняющие вопросы
- Фиксируй прогресс анализа

Формат ответа:
## Анализ идеи
### Краткое резюме
[2-3 предложения]

### Ключевые аспекты
1. [Аспект 1]
2. [Аспект 2]
...

### Рекомендации
- [Рекомендация 1]
- [Рекомендация 2]

---

Входные данные

• Текст идеи пользователя
• Контекст (предыдущие идеи, история)

---

Выходные данные

analysis:
  summary: str
  key_aspects:
    - str
  recommendations:
    - str
  agents_involved:
    - coordinator
    - organizer
    - business_analyst
    # и другие задействованные агенты
  confidence: float  # 0-1

---

Fallback Chain

1. Yandex GPT → первичный провайдер
2. GigaChat → при недоступности Yandex
3. Error → вернуть сообщение об ошибке с retry suggestion

---

Test Cases

TC-01: Полная идея

Input: "Хочу создать приложение для заметок с ИИ-помощником"

Expected Output:

• Резюме идеи
• Распределение задач
• Краткие рекомендации

Validation:

• Ответ < 500 слов
• Структура соблюдена
• Все секции заполнены

---

TC-02: Неполная идея

Input: "Идея для стартапа"

Expected Output:

• Уточняющие вопросы
• Не пытаться угадать

Validation:

• Заданы минимум 2 вопроса
• Не предоставлены рекомендации

---

TC-03: Техническая идея

Input: "Микросервисная архитектура на Go для обработки заказов"

Expected Output:

• Короткое резюме
• Технические аспекты
• Рекомендации по архитектуре

Validation:

• Упомянуты: микросервисы, Go, заказы

---

Success Criteria

• Отвечает в < 5 секунд
• Структура соблюдается в 95% случаев
• Fallback работает корректно
• Интеграция с другими агентами

---

Метрики

• requests_total: int
• requests_success: int
• requests_fallback: int
• average_response_time: float
• confidence_score: float

---

История изменений

Дата	Изменение	Автор
2026-05-10	Начальная версия	SpecAgent

---

Управляется SpecAgent