Tickets maken en beheren

Deze gids laat je zien hoe je tickets maakt en beheert.

Een ticket aanmaken

Vanuit de UI

Klik op Tickets in de zijbalk van de werkruimte.
Druk op Nieuw ticket.
Vul in:
- Titel — korte samenvatting. Het is het enige verplichte veld.
- Beschrijving — markdown, met een opmaakwerkbalk.
- Status — Te doen (de standaard) of Backlog. Gestarte en eindtoestanden bereik je via de levenscyclus, niet bij het aanmaken.
- Prioriteit — geen, urgent, hoog, gemiddeld of laag.
- Toegewezen aan — jezelf of een agent in de werkruimte.
- Project — optionele groepering.
Druk op Aanmaken, of zet eerst Meer aanmaken aan om het dialoogvenster open te houden voor snel achter elkaar invoeren.

Er is geen leverancierskeuzelijst in het dialoogvenster. Het ticket wordt aangemaakt bij de actieve ticketleverancier van de werkruimte.

Vanuit een agent

Vraag het aan een agent in een ruimte:

Maak een ticket om het time-outprobleem bij het inloggen op trage verbindingen op te lossen.

Hij roept de MCP-tool create_ticket aan. Prioriteit is bij die tool een geheel getal, geen naam:

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

Waarde	Prioriteit
`0`	Geen
`1`	Urgent
`2`	Hoog
`3`	Gemiddeld
`4`	Laag

Alleen workspace_id en title zijn verplicht; description, priority, assignee (een agent-id) en team_id zijn optioneel. De tool is geclassificeerd als een schrijfactie voor leverancierssynchronisatie en vraagt je goedkeuring voordat hij wordt uitgevoerd.

De status van een ticket bijwerken

Tickets volgen deze levenscyclus:

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

done, failed en cancelled zijn eindtoestanden. cancelled is bereikbaar vanuit elke niet-eindtoestand. done en failed zijn bereikbaar vanuit inProgress of inReview; open kan ook rechtstreeks naar blocked. De statuskeuzelijst in de UI toont elke status behalve failed — agents zetten die met fail_ticket.

Gebruik een van deze manieren om de status te wijzigen:

de rij Status in het eigenschappenpaneel van het ticket,
het submenu Status in het rechtermuisknopmenu van een ticket in de lijst,
de chip Status op de zwevende balk nadat je meerdere tickets hebt geselecteerd.

Statuswijzigingen zenden domeingebeurtenissen uit (TicketStatusChanged, TicketCompleted en andere) die pipelines kunnen starten. Zie Pipeline-triggers instellen.

Een ticket toewijzen

Open het ticket.
Stel in het eigenschappenpaneel Toegewezen aan in — jezelf, een ander lid van de werkruimte of een agent.

Labels toevoegen

Labels worden in bulk toegepast vanuit de ticketlijst, niet vanuit één ticket — het eigenschappenpaneel heeft geen bediening voor labels.

Beweeg de muis over een rij in de ticketlijst en vink het selectievakje aan. Vink er zoveel aan als je nodig hebt; zodra er iets is geselecteerd, verschijnt er een zwevende balk.
Open in die balk de chip Labels.
Kies een label. Het wordt toegevoegd aan elk geselecteerd ticket dat het nog niet heeft; bestaande labels worden nooit gewist. Labels wissen verwijdert ze allemaal. De keuzelijst toont labels die al op een ticket in de werkruimte staan. Agents kunnen een nieuwe naam toevoegen via update_ticket of tickets.patch.

Tickets koppelen

Relaties staan op de kaart Relaties van het ticket in het eigenschappenpaneel, of achter Koppelen aan in het rechtermuisknopmenu van de lijst.

Open het ticket en zoek de kaart Relaties.
Druk op de toevoegknop en kies de relatie:

Relatie	Betekenis
Subtaak van…	Het bovenliggende ticket van dit ticket is het andere
Bovenliggend van…	Het andere ticket is een kindticket van dit ticket
Geblokkeerd door…	Dit ticket wordt geblokkeerd door het andere
Blokkeert…	Dit ticket blokkeert het andere
Gerelateerd aan…	Symmetrisch, geen richting
Duplicaat van…	Dit ticket is een duplicaat van het andere

Kies het doelticket.

Gedupliceerd door verschijnt op de kaart maar niet in de keuzelijst — het is het omgekeerde van Duplicaat van en wordt vanaf het andere ticket ingesteld. Elke vermelde relatie kun je aanklikken om het gekoppelde ticket te openen en bij hover verwijderen.

Ouder- en subtaakrelaties worden op het ticket zelf opgeslagen in plaats van als koppelrijen, dus het verwijderen van een ouder werkt door naar de kindtickets (zie hieronder), terwijl blokkeer- en gerelateerd-koppelingen dat niet doen.

Medewerkers toevoegen

Medewerkers vormen een lijst op het ticket — wie erbij betrokken is en in welke hoedanigheid.

Open het ticket.
Druk op de persoon-plusknop op de kaart Medewerker toevoegen.
Kies een agent.

De drie rollen zijn assignee, collaborator (de standaard) en reviewer. De keuzelijst in de UI toont alleen agents van de werkruimte en schrijft altijd de standaardrol; mensen kunnen als rij voorkomen, maar worden niet in dat menu aangeboden. De MCP-tool add_ticket_collaborator accepteert een role.

Een medewerker toevoegen schrijft een rij en publiceert geen domeingebeurtenis; het verleent geen toegang tot een ruimte. Wil je een agent in een gesprek zetten, voeg hem dan toe als deelnemer via de ruimtekop — zie Ruimtes gebruiken.

Een ticket verwijderen

Gebruik Ticket verwijderen onderaan het eigenschappenpaneel, in het rechtermuisknopmenu, of de verwijderactie op de zwevende balk nadat je meerdere tickets hebt geselecteerd.