Crear y gestionar tickets

Esta guía te muestra cómo crear y gestionar tickets.

Crear un ticket

Desde la interfaz

Haz clic en Tickets en la barra lateral del espacio de trabajo.
Pulsa Nuevo ticket.
Rellena:
- Título — resumen breve. Es el único campo obligatorio.
- Descripción — markdown, con una barra de formato.
- Estado — Por hacer (el valor predeterminado) o Backlog. Los estados ya iniciados y los terminales se alcanzan mediante el ciclo de vida, no en el momento de la creación.
- Prioridad — ninguna, urgente, alta, media o baja.
- Asignado a — tú mismo o cualquier agente del espacio de trabajo.
- Proyecto — agrupación opcional.
Pulsa Crear, o activa antes Crear más para mantener abierto el cuadro de diálogo e introducir tickets rápidamente.

En el cuadro de diálogo no hay selector de proveedor. El ticket se crea con el proveedor de tickets activo del espacio de trabajo.

Desde un agente

Pide a un agente en un espacio:

Crea un ticket para arreglar el problema de tiempo de espera de inicio de sesión en conexiones lentas.

Llama a la herramienta MCP create_ticket. La prioridad en esa herramienta es un entero, no un nombre:

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

Valor	Prioridad
`0`	Ninguna
`1`	Urgente
`2`	Alta
`3`	Media
`4`	Baja

Solo workspace_id y title son obligatorios; description, priority, assignee (un id de agente) y team_id son opcionales. La herramienta está clasificada como escritura de sincronización con el proveedor y solicita tu aprobación antes de ejecutarse.

Cambiar el estado de un ticket

Los tickets siguen este ciclo de vida:

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

done, failed y cancelled son estados terminales. Se puede llegar a cancelled desde cualquier estado no terminal. Se puede llegar a done y failed desde inProgress o inReview; open también puede pasar directamente a blocked. El selector de estado de la interfaz lista todos los estados excepto failed: los agentes marcan ese con fail_ticket.

Para cambiarlo, usa cualquiera de estos:

la fila Estado en la barra de propiedades del ticket,
el submenú Estado del menú contextual de un ticket en la lista,
el chip Estado de la barra flotante tras seleccionar varios tickets.

Los cambios de estado emiten eventos de dominio (TicketStatusChanged, TicketCompleted y otros) que pueden disparar pipelines. Consulta Configurar disparadores de pipeline.

Asignar un ticket

Abre el ticket.
En la barra de propiedades, define Asignado a — tú mismo, otro miembro del espacio de trabajo o un agente.

Añadir etiquetas

Las etiquetas se aplican en bloque desde la lista de tickets, no desde un ticket individual: la barra de propiedades no tiene ningún control de etiquetas.

Pasa el cursor sobre una fila de la lista de tickets y marca su casilla. Marca tantas como necesites; en cuanto haya algo seleccionado, aparece una barra flotante.
En esa barra, abre el chip Etiquetas.
Elige una etiqueta. Se añade a todos los tickets seleccionados que no la tengan; las etiquetas existentes nunca se borran. Borrar etiquetas las quita todas. El selector lista las etiquetas que ya hay en algún ticket del espacio de trabajo. Los agentes pueden añadir un nombre nuevo mediante update_ticket o tickets.patch.

Vincular tickets

Las relaciones viven en la tarjeta Relaciones del ticket, en la barra de propiedades, o detrás de Relacionar con en el menú contextual de la lista.

Abre el ticket y busca la tarjeta Relaciones.
Pulsa su control de añadir y elige la relación:

Relación	Significado
Subtarea de…	El padre de este ticket es el otro
Padre de…	El otro ticket es hijo de este
Bloqueado por…	Este ticket está bloqueado por el otro
Bloquea…	Este ticket bloquea al otro
Relacionado con…	Simétrica, sin dirección implícita
Duplicado de…	Este ticket duplica al otro

Elige el ticket de destino.

Duplicado por aparece en la tarjeta pero no en el selector: es la inversa de Duplicado de y se define desde el otro ticket. Cada relación listada se puede pulsar para abrir el ticket vinculado y se puede quitar al pasar el cursor por encima.

Las relaciones de padre y subtarea se guardan en el propio ticket, no como filas de vínculo, así que eliminar un padre se propaga en cascada a sus hijos (consulta más abajo), mientras que los vínculos de bloqueo y de relación no.

Añadir colaboradores

Los colaboradores son un listado del ticket: quién participa y con qué rol.

Abre el ticket.
Pulsa el control de persona con signo más de la tarjeta Añadir colaborador.
Elige un agente.

Los tres roles son assignee, collaborator (el predeterminado) y reviewer. El selector de la interfaz solo lista agentes del espacio de trabajo y siempre escribe el rol predeterminado; las personas pueden aparecer como filas, pero no se ofrecen en ese menú. La herramienta MCP add_ticket_collaborator acepta un role.

Añadir un colaborador escribe una fila y no publica ningún evento de dominio; no concede acceso a ningún espacio. Para meter a un agente en una conversación, añádelo como participante desde la cabecera del espacio: consulta Espacios.

Eliminar un ticket

Usa Eliminar ticket en la parte inferior de la barra de propiedades, el menú contextual o la acción de eliminar de la barra flotante tras seleccionar varios tickets.