// Documentation Singularity
User Actions : quand l’agent IA vous passe la main
Une User Action est un ticket destiné à un humain. L’agent la crée quand une étape exige une personne — ouvrir un compte, franchir une 2FA, fournir un fichier — puis reprend seul dès que vous la marquez comme terminée.
Pourquoi un ticket pour l’humain ?
Un agent IA ne peut pas tout faire : il ne crée pas un compte Stripe qui exige une vérification d’identité, ne génère pas une clé d’API derrière une double authentification et ne dessine pas les sprites d’un jeu. Plutôt que d’échouer ou d’inventer un contournement, il crée une User Action : un ticket de type user-action qui décrit précisément ce que vous devez faire.
Le relais est explicite : l’IA travaille, vous intervenez sur l’étape qui vous revient, puis l’IA reprend. Activez le plugin User Actions depuis le Marketplace ; il n’a pas d’interface propre et s’intègre au board de Mission Control.
La colonne « Action utilisateur »
Les actions arrivent dans une colonne dédiée, placée juste après À faire, avec un compteur. Leurs cartes pulsent pour attirer l’attention et ne se déplacent pas par glisser-déposer. La colonne disparaît lorsqu’elle est vide.
Chaque carte rappelle son ticket parent — l’agent qui l’a demandée — et la chip bloque F-20 indique quel travail attend. Une action dont un prérequis n’est pas encore terminé ou intégré reste dans En attente au lieu de rejoindre la colonne.
Des instructions rédigées par l’agent
Ouvrez une action pour lire ses instructions. Les prompts de Singularity imposent un format : ce qui est déjà fait, pourquoi vous, les étapes numérotées avec les comptes, menus et champs exacts, puis le critère de fin observable. Un secret n’est jamais demandé dans le ticket : l’agent indique où le saisir, par exemple dans les secrets du projet.
Le détail montre aussi le projet concerné, le ticket parent et les dépendances. Les étapes et critères ne sont pas des champs structurés : tout passe par le texte des instructions.
L’agent bloqué par l’action
L’agent crée l’action avec l’outil MCP user_action_create : titre, instructions, priorité de low à critical et option blocking. L’action est rattachée au ticket de l’agent et attend votre validation.
Avec blocking: true, le ticket de l’agent dépend de l’action : sa carte affiche bloqué par F-24 et une barre 0/1 terminé. L’agent appelle ensuite orchestration_wait_for_ticket et son exécution se met en pause, sans consommer de quota. L’outil user_action_list lui permet de retrouver les actions du workspace. Voir les dépendances.
Créer votre propre action : l’agent « Humain »
Vous pouvez aussi noter une tâche humaine vous-même. Dans Nouveau ticket, choisissez l’agent Humain : le ticket est créé de type user-action, sans modèle ni niveau de réflexion, et n’est jamais envoyé à une IA. Il rejoint la colonne comme les actions des agents.
La recherche du board filtre aussi cette colonne, par titre, description ou numéro.
Retrouver une action
Tapez quelques lettres dans la barre de recherche de Mission Control : seules les cartes correspondantes restent visibles, y compris dans la colonne Action utilisateur. Effacez la recherche pour retrouver le board complet.
Marquer comme terminé : l’agent reprend
Une fois l’étape réalisée, cliquez sur le bouton vert Marquer comme terminé sous la carte. L’action passe à done et le prérequis de l’agent est satisfait : la barre passe à 1/1 terminé et, quand toutes ses dépendances sont terminées, le scheduler relance le ticket de l’agent, qui revient En cours.
Une action sans agent peut aussi être confiée à une IA avec Définir l’agent…, et répondre au ticket la passe en cours et lance l’agent assigné. Sur l’app iPhone Horizon, la colonne et la création d’une action « Humain » sont disponibles ; le bouton de fin ne l’est pas encore.
Questions fréquentes
Une User Action peut-elle être lancée par une IA ?
Non, pas automatiquement. Le scheduler, la préqualification et la reprise automatique ignorent les tickets user-action. Vous pouvez cependant confier explicitement une action à un agent avec « Définir l’agent… » ou en répondant au ticket.
Que se passe-t-il pour l’agent pendant que j’agis ?
Avec une action bloquante, le ticket de l’agent dépend de l’action et son exécution se met en pause. Quand toutes ses dépendances sont terminées, le scheduler le relance avec son contexte.
Faut-il un plugin ?
Oui. Les User Actions sont fournies par le plugin User Actions, à activer depuis le Marketplace. Sans lui, la colonne et les outils MCP correspondants n’apparaissent pas.