---
name: yougile-commands
description: Справочник команд бота и API YouGile. Показывает доступные команды, кнопки и API-паттерны.
user_invocable: true
---

# Команды бота YouGile

## Кнопки Telegram (ReplyKeyboard)

| Кнопка | Что делает | AI токены |
|--------|-----------|-----------|
| 📋 Активные задачи | Задачи из "Надо сделать", "В работе", "На согласовании" | 0 (чистый API) |
| ➕ Новая задача | Режим создания: текст/голос/аудио | 0 / по запросу |
| 📊 Отчёт | Выполненные задачи за 3/7/14/30 дней | 0 (чистый API) |
| 🎯 Приоритизация | AI расставляет приоритеты | ~5 токенов/задача |
| 🔄 Сброс | Очистка чата и состояния | 0 |

## Slash-команды

| Команда | Аналог кнопки |
|---------|--------------|
| /start | Приветствие + меню |
| /tasks | 📋 Активные задачи |
| /report | 📊 Отчёт |
| /prioritize | 🎯 Приоритизация |
| /reset | 🔄 Сброс |

## Способы создания задач

| Способ | Процесс | AI |
|--------|---------|-----|
| Текст < 200 символов | → задача в YouGile напрямую | 0 |
| Текст > 200 символов | → AI извлекает задачи из текста | MODELS_TASK |
| Голосовое сообщение | → AI транскрибирует → задача | MODELS_AUDIO |
| Аудиофайл (.mp3/.m4a) | → AI транскрибирует → задачи | MODELS_AUDIO |
| Файл .txt | → AI извлекает задачи | MODELS_TASK |

## API-паттерны (оптимизированные)

### Минимум запросов
```
Активные задачи:
  1x GET /columns (кэш board_id)
  3x GET /task-list (по активным колонкам)
  = 4 запроса, 0 AI токенов

Отчёт за период:
  1x GET /columns (кэш)
  8x GET /task-list (все колонки)
  = 9 запросов, 0 AI токенов
  + N x GET /tasks/{id} для подзадач (только если есть)
  + N x GET /chats/{id}/messages для комментов (только если есть)

Создание задачи (текст):
  1x POST /task-list
  = 1 запрос, 0 AI токенов (если короткий текст)

Приоритизация:
  4 запроса структуры + N задач x (1 AI + 1 PUT)
```

### Кэширование
- project_id, board_id: глобальные переменные, один раз
- column_ids: не кэшируются (могут меняться), но запрос лёгкий
- users: кэш в _users_cache, один раз за сессию

### Где AI НЕ нужен
- Список задач → чистый API + форматирование в коде
- Отчёт → чистый API + фильтрация completed/completedTimestamp
- Поиск задач → GET /task-list?title=...
- Создание задачи из короткого текста → прямой POST

### Где AI нужен
- Чат (Вася) → MODELS_CHAT (бесплатные)
- Извлечение задач из длинного текста → MODELS_TASK ($0.03/M)
- Транскрипция аудио → MODELS_AUDIO ($0.075/M)
- Приоритизация → MODELS_TASK ($0.03/M, 5 токенов/задача)
- Анализ/саммари большого объёма → MODELS_SMART ($0.32/M, редко)