// Documentação do Singularity
User Actions: quando o agente de IA te passa a vez
Uma User Action é um ticket destinado a um humano. O agente cria-a quando um passo exige uma pessoa — abrir uma conta, passar uma verificação 2FA, fornecer um ficheiro — e retoma sozinho assim que a marcas como concluída.
Porquê um ticket para o humano?
Um agente de IA não consegue fazer tudo: não cria uma conta Stripe que exige verificação de identidade, não gera uma chave de API protegida por autenticação de dois fatores e não desenha os sprites de um jogo. Em vez de falhar ou inventar uma solução alternativa, cria uma User Action: um ticket do tipo user-action que descreve com precisão o que tens de fazer.
A passagem de testemunho é explícita: a IA trabalha, tu tratas do passo que te cabe e depois a IA retoma. Ativa o plugin User Actions a partir do Marketplace; não tem interface própria e integra-se no board do Mission Control.
A coluna «User action»
As ações chegam a uma coluna dedicada, colocada logo a seguir a Todo, com um contador. Os seus cartões pulsam para chamar a atenção e não podem ser arrastados. A coluna desaparece quando está vazia.
Cada cartão mostra o seu ticket pai — o agente que a pediu — e o chip blocks F-20 indica que trabalho está à espera. Uma ação cujo pré-requisito ainda não esteja concluído ou integrado fica em Pending em vez de entrar na coluna.
Instruções redigidas pelo agente
Abre uma ação para ler as suas instruções. Os prompts do Singularity impõem um formato: o que já está feito, porquê tu, os passos numerados com as contas, menus e campos exatos e, por fim, o critério de conclusão observável. Um segredo nunca é pedido no ticket: o agente indica onde o introduzir, por exemplo nos segredos do projeto.
O detalhe mostra também o projeto em causa, o ticket pai e as dependências. Os passos e os critérios não são campos estruturados: tudo passa pelo texto das instruções.
O agente bloqueado pela ação
O agente cria a ação com a ferramenta MCP user_action_create: título, instruções, prioridade de low a critical e a opção blocking. A ação fica associada ao ticket do agente e aguarda a tua validação.
Com blocking: true, o ticket do agente depende da ação: o seu cartão mostra blocked by F-24 e uma barra 0/1 done. O agente chama depois orchestration_wait_for_ticket e a sua execução fica em pausa, sem consumir quota. A ferramenta user_action_list permite-lhe encontrar as ações do workspace. Consulta as dependências.
Criar a tua própria ação: o agente «Human»
Também podes registar tu mesmo uma tarefa humana. Em New ticket, escolhe o agente Human: o ticket é criado com o tipo user-action, sem modelo nem nível de raciocínio, e nunca é enviado a uma IA. Entra na coluna tal como as ações dos agentes.
A pesquisa do board também filtra esta coluna, por título, descrição ou número.
Encontrar uma ação
Escreve algumas letras na barra de pesquisa do Mission Control: só os cartões correspondentes ficam visíveis, incluindo na coluna User action. Limpa a pesquisa para voltares a ver o board completo.
Marcar como concluída: o agente retoma
Depois de realizares o passo, clica no botão verde Mark as done por baixo do cartão. A ação passa a done e o pré-requisito do agente fica satisfeito: a barra passa a 1/1 done e, quando todas as suas dependências estão concluídas, o scheduler relança o ticket do agente, que volta a In progress.
Uma ação sem agente também pode ser confiada a uma IA com Set agent…, e responder ao ticket passa-o para em curso e lança o agente atribuído. Na app Horizon para iPhone, a coluna e a criação de uma ação «Human» estão disponíveis; o botão de conclusão ainda não.
Perguntas frequentes
Uma User Action pode ser lançada por uma IA?
Não automaticamente. O scheduler, a pré-qualificação e a retoma automática ignoram os tickets user-action. Podes, no entanto, confiar explicitamente uma ação a um agente com «Set agent…» ou respondendo ao ticket.
O que acontece ao agente enquanto eu ajo?
Com uma ação bloqueante, o ticket do agente depende da ação e a sua execução fica em pausa. Quando todas as suas dependências estão concluídas, o scheduler relança-o com o respetivo contexto.
É preciso um plugin?
Sim. As User Actions são fornecidas pelo plugin User Actions, a ativar a partir do Marketplace. Sem ele, a coluna e as ferramentas MCP correspondentes não aparecem.