// Documentación de Singularity
User Actions: cuando el agente de IA te pasa el relevo
Una User Action es un ticket destinado a una persona. El agente la crea cuando un paso requiere a alguien —abrir una cuenta, superar una 2FA, aportar un archivo— y retoma el trabajo por sí solo en cuanto la marcas como terminada.
¿Por qué un ticket para una persona?
Un agente de IA no puede hacerlo todo: no crea una cuenta de Stripe que exige una verificación de identidad, no genera una clave de API protegida por doble autenticación ni dibuja los sprites de un juego. En lugar de fallar o inventar un atajo, crea una User Action: un ticket de tipo user-action que describe con precisión lo que tienes que hacer.
El relevo es explícito: la IA trabaja, tú te ocupas del paso que te corresponde y luego la IA continúa. Activa el plugin User Actions desde el Marketplace; no tiene interfaz propia y se integra en el tablero de Mission Control.
La columna «User action»
Las acciones llegan a una columna dedicada, situada justo después de Todo, con un contador. Sus tarjetas parpadean para llamar la atención y no se pueden arrastrar. La columna desaparece cuando está vacía.
Cada tarjeta recuerda su ticket padre —el agente que la pidió— y la etiqueta blocks F-20 indica qué trabajo está esperando. Una acción cuyo requisito previo aún no está terminado o integrado se queda en Pending en lugar de pasar a la columna.
Instrucciones redactadas por el agente
Abre una acción para leer sus instrucciones. Los prompts de Singularity imponen un formato: lo que ya está hecho, por qué tú, los pasos numerados con las cuentas, menús y campos exactos y, por último, el criterio de finalización observable. Nunca se pide un secreto en el ticket: el agente indica dónde introducirlo, por ejemplo en los secretos del proyecto.
El detalle muestra también el proyecto afectado, el ticket padre y las dependencias. Los pasos y criterios no son campos estructurados: todo va en el texto de las instrucciones.
El agente bloqueado por la acción
El agente crea la acción con la herramienta MCP user_action_create: título, instrucciones, prioridad de low a critical y opción blocking. La acción queda vinculada al ticket del agente y espera tu validación.
Con blocking: true, el ticket del agente depende de la acción: su tarjeta muestra blocked by F-24 y una barra 0/1 done. A continuación, el agente llama a orchestration_wait_for_ticket y su ejecución se pone en pausa, sin consumir cuota. La herramienta user_action_list le permite encontrar las acciones del espacio de trabajo. Consulta las dependencias.
Crear tu propia acción: el agente «Human»
También puedes anotar tú mismo una tarea humana. En New ticket, elige el agente Human: el ticket se crea con el tipo user-action, sin modelo ni nivel de razonamiento, y nunca se envía a una IA. Se suma a la columna igual que las acciones de los agentes.
La búsqueda del tablero también filtra esta columna, por título, descripción o número.
Encontrar una acción
Escribe unas letras en la barra de búsqueda de Mission Control: solo quedan visibles las tarjetas que coinciden, también en la columna User action. Borra la búsqueda para volver a ver el tablero completo.
Marcar como terminada: el agente continúa
Una vez realizado el paso, haz clic en el botón verde Mark as done bajo la tarjeta. La acción pasa a done y el requisito previo del agente queda satisfecho: la barra pasa a 1/1 done y, cuando todas sus dependencias están terminadas, el scheduler relanza el ticket del agente, que vuelve a In progress.
Una acción sin agente también puede confiarse a una IA con Set agent…, y responder al ticket lo pasa a en curso y lanza el agente asignado. En la app de iPhone Horizon están disponibles la columna y la creación de una acción «Human»; el botón de finalización todavía no.
Preguntas frecuentes
¿Puede una IA iniciar una User Action?
No, no automáticamente. El scheduler, la precualificación y la reanudación automática ignoran los tickets user-action. Sin embargo, puedes confiar explícitamente una acción a un agente con «Set agent…» o respondiendo al ticket.
¿Qué le pasa al agente mientras actúo?
Con una acción bloqueante, el ticket del agente depende de la acción y su ejecución se pone en pausa. Cuando todas sus dependencias están terminadas, el scheduler lo relanza con su contexto.
¿Hace falta un plugin?
Sí. Las User Actions las proporciona el plugin User Actions, que se activa desde el Marketplace. Sin él, la columna y las herramientas MCP correspondientes no aparecen.