Створювати й керувати тікетами

Цей посібник показує, як створювати тікети та керувати ними.

Створити тікет

З інтерфейсу

Натисніть Тікети на бічній панелі робочого простору.
Натисніть Новий тікет.
Заповніть:
- Назва — короткий опис. Це єдине обов’язкове поле.
- Опис — markdown, з панеллю форматування.
- Статус — До виконання (типово) або Беклог. Розпочаті й термінальні стани досягаються через життєвий цикл, а не під час створення.
- Пріоритет — немає, терміновий, високий, середній або низький.
- Виконавець — ви самі або будь-який агент у робочому просторі.
- Проєкт — необов’язкове групування.
Натисніть Створити або спершу увімкніть Створити ще, щоб діалог залишався відкритим для швидкого введення.

У діалозі немає вибору провайдера. Тікет створюється в активному провайдері тікетів робочого простору.

Через агента

Попросіть агента в просторі:

Створи тікет, щоб виправити проблему з тайм-аутом входу на повільних з’єднаннях.

Він викликає інструмент MCP create_ticket. Пріоритет у цьому інструменті — ціле число, а не назва:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

Значення	Пріоритет
`0`	Немає
`1`	Терміновий
`2`	Високий
`3`	Середній
`4`	Низький

Обов’язкові лише workspace_id і title; description, priority, assignee (ідентифікатор агента) і team_id — необов’язкові. Інструмент належить до класу запису в зовнішній трекер і перед запуском запитує ваше схвалення.

Оновити статус тікета

Тікети проходять такий життєвий цикл:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done, failed і cancelled — термінальні. cancelled досяжний з будь-якого нетермінального статусу. done і failed досяжні з inProgress або inReview; open також може перейти напряму в blocked. Селектор статусу в інтерфейсі перелічує всі статуси, крім failed, — агенти позначають його через fail_ticket.

Щоб змінити статус, скористайтеся одним із способів:

рядком Статус на панелі властивостей тікета,
підменю Статус в контекстному меню тікета у списку,
чіпом Статус на плаваючій панелі після вибору кількох тікетів.

Кожна зміна статусу з інтерфейсу застосовується примусово й повністю обминає граф — ви можете перевести тікет у будь-який статус зі списку селектора, зокрема відкрити заново done, failed чи cancelled. Селектор не пропонує failed як цільовий статус. Діаграма вище керує агентами й автоматизацією: недозволений перехід, який спробує інструмент MCP або узгоджувач, записується в журнал і ігнорується, а не застосовується.

Зміни статусу породжують доменні події (TicketStatusChanged, TicketCompleted та інші), які можуть запускати конвеєри. Див. Налаштувати тригери конвеєра.

Призначити тікет

Відкрийте тікет.
На панелі властивостей задайте Виконавець — себе, іншого учасника робочого простору або агента.

Додати мітки

Мітки застосовують масово зі списку тікетів, а не з окремого тікета — на панелі властивостей немає елемента керування мітками.

Наведіть курсор на рядок у списку тікетів і позначте його прапорець. Позначте стільки, скільки потрібно; щойно щось вибрано, з’являється плаваюча панель.
На цій панелі відкрийте чіп Мітки.
Виберіть мітку. Її додано до кожного вибраного тікета, який її не має; наявні мітки ніколи не стираються. Очистити мітки прибирає їх усі. Селектор перелічує мітки, які вже є на тікетах робочого простору. Агенти можуть додати нову назву через update_ticket або tickets.patch.

Пов’язати тікети

Зв’язки живуть на картці Зв’язки на панелі властивостей тікета або за пунктом Пов’язати з у контекстному меню списку.

Відкрийте тікет і знайдіть картку Зв’язки.
Натисніть її елемент додавання й виберіть зв’язок:

Зв’язок	Значення
Підзадача для…	Батьківський тікет для цього — інший
Батьківський для…	Інший тікет — дочірній для цього
Заблоковано…	Цей тікет заблоковано іншим
Блокує…	Цей тікет блокує інший
Пов’язано з…	Симетрично, напрямок не мається на увазі
Дублікат…	Цей тікет дублює інший

Виберіть цільовий тікет.

Дубльовано з’являється на картці, але не в селекторі — це обернена сторона Дублікат, і її задають із боку іншого тікета. Кожен з перелічених зв’язків можна натиснути, щоб відкрити пов’язаний тікет, і видалити, навівши на нього курсор.

Зв’язки «батько — підзадача» зберігаються в самому тікеті, а не як рядки зв’язків, тож видалення батьківського тікета каскадно видаляє його дочірні тікети (див. нижче), а блокувальні та пов’язані посилання — ні.

Додати співавторів

Співавтори — це реєстр на тікеті: хто задіяний і в якій якості.

Відкрийте тікет.
Натисніть елемент із силуетом людини й плюсом на картці Додати співавтора.
Виберіть агента.

Три ролі: assignee, collaborator (типова) і reviewer. Селектор в інтерфейсі перелічує лише агентів робочого простору й завжди записує типову роль; люди можуть з’являтися як рядки, але в цьому меню їх не пропонують. Інструмент MCP add_ticket_collaborator приймає role.

Додавання співавтора записує рядок і не публікує доменної події; воно не надає доступу до простору. Щоб увести агента в розмову, додайте його як учасника із заголовка простору — див. Використовувати простори.

Видалити тікет

Скористайтеся Видалити тікет унизу панелі властивостей, контекстним меню або дією видалення на плаваючій панелі після вибору кількох тікетів.