Twórz i zarządzaj zgłoszeniami

Ten poradnik pokazuje, jak tworzyć zgłoszenia i zarządzać nimi.

Twórz zgłoszenie

Z interfejsu

Kliknij Zgłoszenia na pasku bocznym obszaru roboczego.
Naciśnij Nowe zgłoszenie.
Wypełnij:
- Tytuł — krótkie podsumowanie. To jedyne wymagane pole.
- Opis — markdown, z paskiem narzędzi formatowania.
- Status — Do zrobienia (domyślnie) lub Backlog. Stany rozpoczęte i końcowe osiąga się przez cykl życia, a nie przy tworzeniu.
- Priorytet — brak, pilny, wysoki, średni lub niski.
- Osoba przypisana — Ty lub dowolny agent w obszarze roboczym.
- Projekt — opcjonalne grupowanie.
Naciśnij Utwórz albo najpierw włącz Utwórz kolejne, aby okno dialogowe pozostało otwarte przy szybkim wprowadzaniu.

W oknie dialogowym nie ma selektora dostawcy. Zgłoszenie powstaje w oparciu o aktywnego dostawcę zgłoszeń obszaru roboczego.

Od agenta

Poproś agenta w przestrzeni:

Utwórz zgłoszenie dotyczące naprawy problemu z przekroczeniem limitu czasu logowania na wolnym łączu.

Wywoła to narzędzie MCP create_ticket. Priorytet w tym narzędziu jest liczbą całkowitą, a nie nazwą:

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

Wartość	Priorytet
`0`	Brak
`1`	Pilny
`2`	Wysoki
`3`	Średni
`4`	Niski

Wymagane są tylko workspace_id i title; description, priority, assignee (identyfikator agenta) oraz team_id są opcjonalne. Narzędzie jest zaklasyfikowane jako zapis synchronizacji z dostawcą i przed uruchomieniem prosi o Twoje zatwierdzenie.

Zmieniaj status zgłoszenia

Zgłoszenia przechodzą przez następujący cykl życia:

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

Statusy done, failed i cancelled są końcowe. Status cancelled jest osiągalny z dowolnego niekońcowego statusu. Statusy done i failed są osiągalne ze stanu inProgress lub inReview; open może też przejść bezpośrednio do blocked. Selektor statusu w interfejsie wymienia każdy status poza failed — agenci oznaczają go przez fail_ticket.

Aby go zmienić, możesz użyć:

wiersza Status w panelu właściwości zgłoszenia,
podmenu Status w menu podręcznym zgłoszenia na liście,
przycisku Status na pływającym pasku po zaznaczeniu wielu zgłoszeń.

Zmiany statusu emitują zdarzenia domenowe (TicketStatusChanged, TicketCompleted i inne), które mogą wyzwalać potoki. Zobacz Skonfiguruj wyzwalacze potoków.

Przypisuj zgłoszenie

Otwórz zgłoszenie.
W panelu właściwości ustaw Osobę przypisaną — siebie, innego członka obszaru roboczego albo agenta.

Dodawaj etykiety

Etykiety nadaje się zbiorczo z listy zgłoszeń, a nie z pojedynczego zgłoszenia — panel właściwości nie ma kontrolki etykiet.

Najedź kursorem na wiersz na liście zgłoszeń i zaznacz jego pole wyboru. Zaznacz tyle, ile potrzebujesz; gdy tylko coś zostanie zaznaczone, pojawia się pływający pasek.
Na tym pasku otwórz przycisk Etykiety.
Wybierz etykietę. Zostanie dodana do każdego zaznaczonego zgłoszenia, które jej nie ma; istniejące etykiety nigdy nie są usuwane. Wyczyść etykiety usuwa je wszystkie. Selektor wymienia etykiety już przypisane do zgłoszeń w obszarze roboczym. Agenci mogą dodać nową nazwę przez update_ticket lub tickets.patch.

Powiązuj zgłoszenia

Powiązania znajdują się na karcie Powiązania w panelu właściwości zgłoszenia albo pod Powiąż z w menu podręcznym listy.

Otwórz zgłoszenie i znajdź kartę Powiązania.
Naciśnij jej kontrolkę dodawania i wybierz powiązanie:

Powiązanie	Znaczenie
Podzgłoszenie…	Zgłoszeniem nadrzędnym tego jest tamto
Nadrzędne wobec…	Tamto zgłoszenie jest podrzędne względem tego
Blokowane przez…	To zgłoszenie jest blokowane przez tamto
Blokuje…	To zgłoszenie blokuje tamto
Powiązane z…	Symetryczne, bez wskazania kierunku
Duplikat…	To zgłoszenie jest duplikatem tamtego

Wybierz zgłoszenie docelowe.

Zduplikowane przez pojawia się na karcie, ale nie w selektorze — to odwrotność Duplikat… i ustawia się ją z drugiego zgłoszenia. Każde wymienione powiązanie można kliknąć, aby otworzyć powiązane zgłoszenie, i usunąć, najeżdżając na nie kursorem.

Powiązania nadrzędne i podzgłoszeniowe są przechowywane w samym zgłoszeniu, a nie jako wiersze łączy, więc usunięcie zgłoszenia nadrzędnego kaskadowo usuwa jego zgłoszenia podrzędne (zobacz poniżej), podczas gdy łącza blokowania i powiązania tego nie robią.

Dodawaj współpracowników

Współpracownicy to lista na zgłoszeniu — kto jest zaangażowany i w jakiej roli.

Otwórz zgłoszenie.
Naciśnij kontrolkę dodawania osoby na karcie Dodaj współpracownika.
Wybierz agenta.

Dostępne są trzy role: assignee, collaborator (domyślna) i reviewer. Selektor w interfejsie wymienia tylko agentów obszaru roboczego i zawsze zapisuje rolę domyślną; ludzie mogą pojawiać się jako wiersze, ale nie są oferowani w tym menu. Narzędzie MCP add_ticket_collaborator przyjmuje parametr role.

Dodanie współpracownika zapisuje wiersz i nie publikuje żadnego zdarzenia domenowego; nie przyznaje dostępu do przestrzeni. Aby wprowadzić agenta do rozmowy, dodaj go zamiast tego jako uczestnika z nagłówka przestrzeni — zobacz Używaj przestrzeni.

Usuwaj zgłoszenie

Użyj Usuń zgłoszenie na dole panelu właściwości, w menu podręcznym albo akcji usuwania na pływającym pasku po zaznaczeniu wielu zgłoszeń.