Crear y administrar tickets

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

Crear un ticket

Desde la interfaz

Haz clic en Tickets en la barra lateral del espacio de trabajo.
Presiona Nuevo ticket.
Completa:
- Título — resumen breve. Es el único campo obligatorio.
- Descripción — Markdown, con una barra de herramientas de formato.
- Estado — Por hacer (el predeterminado) o Backlog. Los estados iniciados y los terminales se alcanzan mediante el ciclo de vida, no al crear el ticket.
- Prioridad — ninguna, urgente, alta, media o baja.
- Asignado a — tú mismo o cualquier agente del espacio de trabajo.
- Proyecto — agrupación opcional.
Presiona Crear, o activa antes Crear más para mantener el diálogo abierto y crear varios seguidos.

En el diálogo no hay ningún selector de proveedor. El ticket se crea contra el proveedor de tickets activo del espacio de trabajo.

Desde un agente

Pídele a un agente en un espacio:

Crea un ticket para corregir 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 una escritura de sincronización con el proveedor y pide tu aprobación antes de ejecutarse.

Actualizar 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 terminales. A cancelled se llega desde cualquier estado no terminal. A done y failed se llega 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 lo marcan con fail_ticket.

Para cambiarlo, usa cualquiera de estas opciones:

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, establece Asignado a: tú mismo, otro miembro del espacio de trabajo o un agente.

Agregar etiquetas

Las etiquetas se aplican en bloque desde la lista de tickets, no desde un solo ticket: 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; la barra flotante aparece en cuanto haya algo seleccionado.
En esa barra, abre el chip Etiquetas.
Elige una etiqueta. Se agrega a cada ticket seleccionado que no la tenga; las etiquetas existentes nunca se borran. Borrar etiquetas las quita todas. El selector lista las etiquetas que ya están en algún ticket del espacio de trabajo. Los agentes pueden agregar un nombre nuevo con 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.
Presiona su control de agregar 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étrico, 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 establece desde el otro ticket. Cada relación de la lista se puede pulsar para abrir el ticket vinculado y se puede quitar al pasar el cursor.

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

Agregar colaboradores

Los colaboradores son una lista de personas del ticket: quién participa y con qué rol.

Abre el ticket.
Presiona el control de persona con signo más en 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.

Agregar un colaborador escribe una fila y no publica ningún evento de dominio; tampoco otorga acceso a ningún espacio. Para meter a un agente en una conversación, agrégalo como participante desde el encabezado del espacio: consulta Espacios.

Eliminar un ticket

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