← Todos os artigos

User Actions: quando o agente de IA passa a vez para uma pessoa no Singularity

User Actions é o plugin do Singularity que permite a um agente de IA confiar a você o que ele não consegue fazer sozinho. Criar um key vault, configurar um segredo de produção, validar uma cobrança com um fornecedor: o agente cria um ticket com as etapas a seguir e pode esperar você terminar antes de continuar.

Capturas do aplicativo com um perfil de demonstração. Nenhum agente é realmente executado nelas.

Que problema o User Actions resolve?

Um agente avança rápido até o trabalho ficar estruturalmente fora do seu alcance: uma conta para abrir, uma chave protegida por autenticação em duas etapas, uma decisão reservada a uma pessoa. Sem um quadro, o pedido se perde em um log ou no resumo do ticket. User Actions o transforma em um ticket visível, com instruções e estado.

Coluna de ação do usuário no kanban do Singularity com tickets criados por agentes
Coluna de ação do usuário no kanban do Singularity com tickets criados por agentes

Como funciona uma ação do usuário?

Enquanto está ativo, o plugin expõe duas ferramentas MCP a todos os agentes:

  • user_action_create cria um ticket do tipo user-action com título, instruções e prioridade. Ele sempre chega aguardando aprovação.
  • user_action_list retorna o estado das ações criadas, para verificar se você deu o passo esperado antes de pedir de novo.

Com blocking: true, o ticket do agente adiciona a ação às suas dependências. Sem esse campo, o pedido é criado e o agente continua. Concluir a ação remove essa dependência; as outras dependências e o agendador decidem depois a retomada.

Detalhe de uma ação do usuário: o que o agente pede e as etapas a seguir
Detalhe de uma ação do usuário: o que o agente pede e as etapas a seguir

Como usar no dia a dia?

  1. Instale o User Actions pelo Marketplace, ative-o e conceda as permissões.
  2. Deixe seus agentes trabalharem. A coluna de ação do usuário só aparece a partir da primeira ação criada.
  3. Abra o ticket e leia o que foi feito, por que você é necessário e quais etapas seguir.
  4. Realize as etapas e marque a ação como concluída.

Você também pode criar sua própria ação escolhendo o agente humano no diálogo de novo ticket, e filtrar a coluna com a busca.

Uma ação marcada como concluída: o ticket do agente que dependia dela pode continuar
Uma ação marcada como concluída: o ticket do agente que dependia dela pode continuar

Quais são os limites?

O plugin não faz o trabalho por você: ele o organiza. Não tem tabelas próprias: as ações são tickets comuns do Singularity. Desativá-lo retira as ferramentas dos agentes, mas não resolve as ações existentes. Se as ferramentas estiverem ausentes, verifique a ativação e as permissões e inicie uma nova execução do agente. Se blocking voltar como false, nenhum ticket chamador foi encontrado: inspecione o ticket criado antes de tentar de novo.

Perguntas frequentes

O User Actions é pago?

Não. O plugin é gratuito e não precisa de conta externa nem de segredo. Ele vem desativado por padrão: instale e ative pelo Marketplace.

Um agente pode concluir sozinho uma ação do usuário?

Uma ação espera por uma pessoa, nunca por uma execução automática de agente: nenhum agendador lança esse tipo de ticket.

O que acontece se eu desinstalar o plugin?

As ações continuam sendo tickets comuns: desinstalar não perde nada do que você ainda tinha a fazer. Os agentes só perdem o acesso às ferramentas.

Guia do User Actions · Marketplace · Baixar o Singularity