Bilet oluşturma ve yönetme

Bu kılavuz, biletlerin nasıl oluşturulacağını ve yönetileceğini gösterir.

Bilet oluşturma

Arayüzden

1. Çalışma alanı kenar çubuğunda Biletler’e tıklayın.
2. Yeni bilet’e basın.
3. Şunları doldurun:
   • Başlık — kısa özet. Tek zorunlu alan budur.
   • Açıklama — biçimlendirme araç çubuğuyla markdown.
   • Durum — Yapılacak (varsayılan) veya Backlog. Başlamış ve terminal durumlara yaşam döngüsü üzerinden ulaşılır, oluşturma anında değil.
   • Öncelik — yok, acil, yüksek, orta veya düşük.
   • Atanan — kendiniz veya çalışma alanındaki herhangi bir ajan.
   • Proje — isteğe bağlı gruplama.
4. Oluştur’a basın ya da hızlı giriş için iletişim penceresini açık tutmak üzere önce Daha fazla oluştur’u açın.

İletişim penceresinde sağlayıcı seçici yoktur. Bilet, çalışma alanının etkin bilet sağlayıcısına karşı oluşturulur.

Bir ajandan

Bir alandaki ajandan şunu isteyin:

Yavaş bağlantılarda oturum açma zaman aşımı sorununu düzeltmek için bir bilet oluştur.

Ajan, create_ticket MCP aracını çağırır. Bu araçtaki öncelik bir tamsayıdır, bir ad değil:

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

Değer	Öncelik
0	Yok
1	Acil
2	Yüksek
3	Orta
4	Düşük

Yalnızca workspace_id ve title zorunludur; description, priority, assignee (bir ajan kimliği) ve team_id isteğe bağlıdır. Araç, bir sağlayıcı eşitleme yazımı olarak sınıflandırılır ve çalışmadan önce onayınızı ister.

Bilet durumunu güncelleme

Biletler şu yaşam döngüsünü izler:

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

done, failed ve cancelled terminaldir. cancelled durumuna terminal olmayan her durumdan ulaşılabilir. done ve failed durumlarına inProgress veya inReview üzerinden ulaşılır; open doğrudan blocked durumuna da geçebilir. Arayüzdeki durum seçici failed dışındaki her durumu listeler — ajanlar bunu fail_ticket ile işaretler.

Değiştirmek için şunlardan herhangi birini kullanın:

• biletin özellikler bölmesindeki Durum satırı,
• listede bir biletin sağ tık menüsündeki Durum alt menüsü,
• birden çok bilet seçtikten sonra yüzen çubuktaki Durum çipi.

Yaşam döngüsü grafiği sizi değil, ajanları bağlar

Arayüzden yapılan her durum değişikliği zorla geçirilir ve grafik tümüyle atlanır — bir bileti seçicinin listelediği her duruma taşıyabilirsiniz; done, failed veya cancelled bir bileti yeniden açmak dahil. Seçici hedef olarak failed sunmaz. Yukarıdaki diyagram ajanları ve otomasyonu yönetir: bir MCP aracının ya da bir uzlaştırıcının denediği geçersiz bir geçiş günlüğe yazılır ve yok sayılır, uygulanmaz.

Durum değişiklikleri, pipeline’ları tetikleyebilen alan olayları (TicketStatusChanged, TicketCompleted ve diğerleri) yayımlar. Bkz. Pipeline tetikleyicileri kurma.

Bilet atama

1. Bileti açın.
2. Özellikler bölmesinde Atanan alanını ayarlayın — kendiniz, başka bir çalışma alanı üyesi ya da bir ajan.

Atama hiçbir işi başlatmaz

Atama sahipliği kaydeder, fazlasını değil. Hiçbir alan oluşturmaz, hiçbir durumu değiştirmez ve hiçbir ajanı göndermez — TicketAssigned, arkasında hiçbir gönderici olmayan saf bir denetim sinyalidir. Bir ajanı çalıştırmak için ona bir alanda ileti gönderin (bkz. Bir ajanla sohbet etme).

Tek istisna: TicketAssigned, bir pipeline tetikleyicisi bağlayabileceğiniz bir olay türüdür; böylece kendi şablonunuz bir atamaya tepki verebilir.

Etiket ekleme

Etiketler tek bir biletten değil, bilet listesinden toplu olarak uygulanır — özellikler bölmesinde etiket denetimi yoktur.

1. Bilet listesindeki bir satırın üzerine gelin ve onay kutusunu işaretleyin. İhtiyacınız kadarını işaretleyin; herhangi bir şey seçildiğinde yüzen bir çubuk belirir.
2. Bu çubukta Etiketler çipini açın.
3. Bir etiket seçin. Seçili olup bu etiketi barındırmayan her bilete eklenir; var olan etiketler asla silinmez. Etiketleri temizle hepsini kaldırır. Seçici, çalışma alanındaki bir bilette hâlihazırda bulunan etiketleri listeler. Ajanlar update_ticket ya da tickets.patch ile yeni bir ad ekleyebilir.

Biletleri ilişkilendirme

İlişkiler, özellikler bölmesindeki biletin İlişkiler kartında ya da listenin sağ tık menüsünde İlişkilendir’in arkasında bulunur.

1. Bileti açın ve İlişkiler kartını bulun.
2. Ekleme denetimine basın ve ilişkiyi seçin:

İlişki	Anlamı
Alt konusu…	Bu biletin üst öğesi diğeridir
Üst konusu…	Diğer bilet bunun alt öğesidir
Engelleyen…	Bu bilet diğeri tarafından engelleniyor
Engelliyor…	Bu bilet diğerini engelliyor
İlişkili…	Simetrik, yön belirtmez
Kopyası…	Bu bilet diğerinin kopyasıdır

3. Hedef bileti seçin.

Kopyaları kartta görünür ama seçicide görünmez — Kopyası ilişkisinin tersidir ve diğer biletten ayarlanır. Listelenen her ilişki, bağlı bileti açmak için tıklanabilir ve üzerine gelindiğinde kaldırılabilir.

Üst ve alt konu ilişkileri, bağlantı satırları olarak değil biletin kendisinde saklanır; bu yüzden bir üst öğenin silinmesi alt öğelerine zincirleme yansır (aşağıya bakın), engelleme ve ilişkili bağlantılar ise yansımaz.

İşbirlikçi ekleme

İşbirlikçiler bilet üzerindeki bir kadrodur — kimin, hangi sıfatla dahil olduğu.

1. Bileti açın.
2. İşbirlikçi ekle kartındaki kişi artı denetimine basın.
3. Bir ajan seçin.

Üç rol şunlardır: assignee, collaborator (varsayılan) ve reviewer. Arayüz seçicisi yalnızca çalışma alanı ajanlarını listeler ve her zaman varsayılan rolü yazar; insanlar satır olarak görünebilir ama o menüde sunulmaz. MCP add_ticket_collaborator aracı bir role kabul eder.

İşbirlikçi eklemek bir satır yazar ve hiçbir alan olayı yayımlamaz; hiçbir alan erişimi vermez. Bir ajanı bir konuşmaya koymak için onu bunun yerine alan başlığından katılımcı olarak ekleyin — bkz. Alanlar.

Bilet silme

Özellikler bölmesinin altındaki Bileti sil’i, sağ tık menüsünü ya da birden çok bilet seçtikten sonra yüzen çubuğun silme eylemini kullanın.

Silme yalnızca yereldir

Harici bir takip sisteminden gelen bir bilet orada silinmez — hiçbir sağlayıcı bunu desteklemez — bu yüzden bir sonraki eşitlemede yeniden ortaya çıkabilir. Silme ayrıca zincirleme yansır: biletin işbirlikçileri ve varsa alt biletleri de onunla birlikte gider.

İlgili kılavuzlar

• İşi ajanlara devretme
• İşleri projelerle düzenleme
• Bir ajanla sohbet etme
• Bilet yaşam döngüsü referansı

İlgili kavramlar

• Biletler
• Alan olayları