Платформа
Яндекс Трекер
Очереди, задачи, спринты, учёт времени и изменения через агента.
Яндекс Трекер
Приложение Яндекс Трекер подключает задачи организации к Promto. Агент ищет задачи, собирает сводки по очередям, читает связи и комментарии, анализирует трудозатраты и после подтверждения создаёт или изменяет задачи.
Назначение
Трекер помогает:
- разбирать очередь, просроченные задачи и нагрузку;
- искать задачи по языку запросов Трекера;
- читать описание, связи, комментарии и допустимые переходы;
- создавать задачу из обсуждения;
- менять поля и переводить задачу в другой статус;
- добавлять комментарии;
- читать и записывать рабочее время.
Подключение
Подключить и отключить Трекер может владелец рабочего пространства. До начала подключения понадобится идентификатор организации из раздела Трекера Администрирование → Организации.
- Откройте Яндекс Трекер → Настройки.
- Вставьте ID организации.
- Нажмите Получить код подтверждения.
- На странице Яндекса войдите под аккаунтом, которому доступна эта организация.
- Введите код и разрешите чтение и изменение задач.
- Дождитесь появления списка очередей.
Promto сам проверяет, относится организация к Яндекс 360 или Yandex Identity Hub, и сохраняет подходящий служебный заголовок.
При ручном подключении создайте приложение Яндекс OAuth с правами tracker:read и tracker:write, получите токен и укажите его вместе с ID организации. С одним tracker:read агент сможет читать задачи, но не изменять их.
Интерфейс
На Главной находятся сценарии разбора очереди, создания задачи, итогов спринта, цепочек блокировок, трудозатрат и пакетного перехода.
В Настройках показываются:
- маска токена и подключённый логин;
- ID и тип организации;
- наличие лицензии Трекера;
- доступные очереди, их ключи, названия и руководители;
- состояние токена и кнопка отключения.
Если hasLicense=false, подключённый аккаунт может работать только в пределах прав, которые отдаёт Трекер.
Возможности агента
Основной агент использует promto_yatracker.
| Задача | Действия |
|---|---|
| Аккаунт и очереди | whoami, list_queues |
| Поиск и чтение | search_issues, get_issue, list_comments |
| Создание и правка | create_issue, update_issue, add_comment |
| Статусы | list_transitions, transition |
| Трудозатраты | worklog |
| Дополнительные методы API | request |
Агент сначала получает точный ключ очереди или задачи. Ключ очереди чувствителен к регистру, например TREK; ключ задачи выглядит как TREK-123.
Сценарии
Разобрать очередь
Укажите очередь и период. Агент покажет открытые и просроченные задачи, элементы без исполнителя и распределение нагрузки.
Создать задачу из обсуждения
Агент подготовит очередь, заголовок, описание, исполнителя, приоритет и срок. Создание начнётся только после проверки черновика и вашего подтверждения.
Найти блокировки и трудозатраты
Попросите проследить связи между задачами или собрать worklog за период. Агент вернёт исходные ключи задач и отдельно отметит отсутствующие данные.
Ограничения и безопасность
- Права токена не шире прав подключённого пользователя. Если пользователь не видит очередь в Трекере, агент тоже её не увидит.
- Создание, правка, переход, комментарий и изменение worklog видны команде. Перед записью проверьте задачу, поля и точный текст.
- Статус меняется только разрешённым переходом: сначала
list_transitions, затемtransition. - При правке Promto использует версию задачи, чтобы не затереть параллельное изменение коллеги.
- Для worklog длительность передаётся в ISO 8601, например
PT3H; рабочий день Трекера равен 8 часам, неделя — 5 дням. - Запрос через универсальное действие
requestс изменением данных дополнительно требует явного разрешения на мутацию. - Токен хранится на сервере, действия журналируются.
Если что-то не работает
Организация не найдена. Сверьте ID в Администрирование → Организации. Эта ошибка может появиться до проверки токена.
Очередь не видна. Проверьте права подключённого пользователя и точный регистр ключа очереди.
Изменение статуса отклонено. Получите актуальный список переходов для этой задачи; допустимые переходы зависят от очереди и текущего статуса.
Правка конфликтует с чужим изменением. Перечитайте свежую версию задачи и повторно согласуйте результат вместо принудительной перезаписи.
Токен истёк или отозван. Отключите Трекер и подключите аккаунт заново.