Crea e gestisci i ticket

Questa guida mostra come creare e gestire i ticket.

Crea un ticket

Dall’interfaccia

1. Fai clic su Ticket nella barra laterale dello spazio di lavoro.
2. Premi Nuovo ticket.
3. Compila:
   • Titolo — breve riepilogo. È l’unico campo obbligatorio.
   • Descrizione — markdown, con una barra degli strumenti di formattazione.
   • Stato — Da fare (quello predefinito) o Backlog. Gli stati già avviati e quelli terminali si raggiungono tramite il ciclo di vita, non in fase di creazione.
   • Priorità — nessuna, urgente, alta, media o bassa.
   • Assegnatario — te stesso o qualsiasi agente dello spazio di lavoro.
   • Progetto — raggruppamento facoltativo.
4. Premi Crea oppure attiva prima Crea altri per mantenere aperta la finestra di dialogo e inserire più ticket rapidamente.

Nella finestra di dialogo non c’è alcun selettore di fornitore. Il ticket viene creato sul fornitore di ticket attivo dello spazio di lavoro.

Da un agente

Chiedi a un agente in uno spazio:

Crea un ticket per correggere il problema di timeout di accesso sulle connessioni lente.

Chiama lo strumento MCP create_ticket. La priorità di quello strumento è un intero, non un nome:

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

Valore	Priorità
0	Nessuna
1	Urgente
2	Alta
3	Media
4	Bassa

Solo workspace_id e title sono obbligatori; description, priority, assignee (un id di agente) e team_id sono facoltativi. Lo strumento è classificato come scrittura di sincronizzazione con il fornitore e richiede la tua approvazione prima di essere eseguito.

Aggiorna lo stato di un ticket

I ticket seguono questo ciclo di vita:

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

done, failed e cancelled sono stati terminali. Si può raggiungere cancelled da qualsiasi stato non terminale. Si può raggiungere done e failed da inProgress o inReview; open può anche passare direttamente a blocked. Il selettore di stato dell’interfaccia elenca tutti gli stati tranne failed: gli agenti lo impostano con fail_ticket.

Per cambiarlo, usa uno dei seguenti elementi:

• la riga Stato nella barra delle proprietà del ticket,
• il sottomenu Stato del menu contestuale di un ticket nella lista,
• il chip Stato sulla barra flottante dopo aver selezionato più ticket.

Il grafo del ciclo di vita vincola gli agenti, non te

Ogni cambio di stato fatto dall’interfaccia viene forzato: il grafo viene bypassato del tutto, quindi puoi spostare un ticket su qualsiasi stato elencato nel selettore, incluso riaprirne uno done, failed o cancelled. Il selettore non offre failed come destinazione. Il diagramma qui sopra governa gli agenti e l’automazione: una transizione non consentita tentata da uno strumento MCP o da un riconciliatore viene registrata e ignorata, non applicata.

I cambi di stato emettono eventi di dominio (TicketStatusChanged, TicketCompleted e altri) che possono attivare le pipeline. Vedi Configura i trigger delle pipeline.

Assegna un ticket

1. Apri il ticket.
2. Nella barra delle proprietà, imposta Assegnatario — te stesso, un altro membro dello spazio di lavoro o un agente.

Assegnare non avvia alcun lavoro

L’assegnazione registra la responsabilità e nient’altro. Non crea alcuno spazio, non cambia alcuno stato e non invia alcun agente: TicketAssigned è un puro segnale di audit, senza alcun dispatcher dietro. Per far lavorare un agente, scrivigli in uno spazio (vedi Chatta con un agente).

Unica eccezione: TicketAssigned è un tipo di evento a cui puoi collegare un trigger di pipeline, così un modello tuo può reagire a un’assegnazione.

Aggiungi etichette

Le etichette si applicano in blocco dalla lista dei ticket, non da un singolo ticket: la barra delle proprietà non ha alcun controllo per le etichette.

1. Passa il cursore su una riga della lista dei ticket e seleziona la sua casella. Selezionane quante ne servono; non appena c’è qualcosa di selezionato compare una barra flottante.
2. In quella barra, apri il chip Etichette.
3. Scegli un’etichetta. Viene aggiunta a ogni ticket selezionato che non la possiede; le etichette esistenti non vengono mai rimosse. Rimuovi etichette le elimina tutte. Il selettore elenca le etichette già presenti su un ticket dello spazio di lavoro. Gli agenti possono aggiungere un nuovo nome tramite update_ticket o tickets.patch.

Collega i ticket

Le relazioni si trovano nella scheda Relazioni del ticket, nella barra delle proprietà, oppure dietro Collega a nel menu contestuale della lista.

1. Apri il ticket e trova la scheda Relazioni.
2. Premi il suo controllo di aggiunta e scegli la relazione:

Relazione	Significato
Sotto-attività di…	Il ticket padre è l’altro
Padre di…	L’altro ticket è figlio di questo
Bloccato da…	Questo ticket è bloccato dall’altro
Blocca…	Questo ticket blocca l’altro
Correlato a…	Simmetrica, senza direzione implicita
Duplicato di…	Questo ticket duplica l’altro

3. Scegli il ticket di destinazione.

Duplicato da compare nella scheda ma non nel selettore: è l’inverso di Duplicato di e si imposta dall’altro ticket. Ogni relazione elencata è cliccabile per aprire il ticket collegato e rimovibile al passaggio del cursore.

Le relazioni padre e sotto-attività sono memorizzate nel ticket stesso, non come righe di collegamento, quindi eliminare un padre si propaga a cascata ai suoi figli (vedi sotto), mentre i collegamenti di blocco e correlati no.

Aggiungi collaboratori

I collaboratori sono un elenco sul ticket: chi è coinvolto e con quale ruolo.

1. Apri il ticket.
2. Premi il controllo con la persona e il segno più sulla scheda Aggiungi collaboratore.
3. Scegli un agente.

I tre ruoli sono assignee, collaborator (quello predefinito) e reviewer. Il selettore dell’interfaccia elenca solo gli agenti dello spazio di lavoro e scrive sempre il ruolo predefinito; le persone possono comparire come righe, ma non vengono offerte in quel menu. Lo strumento MCP add_ticket_collaborator accetta un role.

Aggiungere un collaboratore scrive una riga e non pubblica alcun evento di dominio; non concede alcun accesso allo spazio. Per inserire un agente in una conversazione, aggiungilo invece come partecipante dall’intestazione dello spazio: vedi Usa gli spazi.

Elimina un ticket

Usa Elimina ticket in fondo alla barra delle proprietà, il menu contestuale oppure l’azione di eliminazione della barra flottante dopo aver selezionato più ticket.

L’eliminazione è solo locale

Un ticket proveniente da un sistema di tracciamento esterno non viene eliminato lì — nessun fornitore lo supporta — quindi può ricomparire alla sincronizzazione successiva. L’eliminazione si propaga anche a cascata: i collaboratori del ticket e tutti i ticket figli vanno con esso.

Guide correlate

• Delega il lavoro agli agenti
• Organizza il lavoro con i progetti
• Chatta con un agente
• Ciclo di vita dei ticket

Concetti correlati

• Ticket e delega
• Eventi di dominio