Agentes de IA que fazem perguntas de esclarecimento
e esperam a sua resposta
Quando o seu agente precisa de uma decisão, a pergunta não fica mais escondida no meio de uma resposta de 200 linhas. Ela aparece em um cartão logo acima do campo de entrada do agente: a pergunta, opções clicáveis e uma linha sobre o que cada opção implica. Você clica, e o agente segue com a sua escolha em vez de adivinhar.
O mesmo cartão no Codex, no Claude Code, no Cursor, no GitHub Copilot CLI e em qualquer CLI de agente compatível com MCP. Responda do computador, do app móvel do AgentsRoom ou com dois botões na tela de bloqueio.
Lendo o esquema do banco de dados
Duas formas de guardar as sessões. Vou perguntar a você.
Onde as sessões devem ficar? → Postgres
Adicionando a tabela de sessões
Onde as sessões devem ficar?
A sua resposta, ou o número de uma opção
O agente pergunta, o cartão espera acima do campo de entrada, um clique responde, e o agente abre a resposta dele relembrando a sua escolha.
Você passa uma tarefa para um agente e vai cuidar de outra coisa. Vinte minutos depois ele escreveu 300 linhas, e em algum ponto no meio da resposta dele há uma pergunta: Postgres ou Redis? Ou ele escolheu um e seguiu em frente, ou parou e a pergunta sumiu de vista com a rolagem. Nos dois casos, você descobre tarde.
As perguntas estruturadas resolvem isso do lado do agente. O AgentsRoom dá a cada agente a ferramenta ask_user e uma instrução curta na inicialização: quando precisar de uma decisão, de uma preferência ou de uma informação que falta, pergunte com a ferramenta e depois espere. A pergunta vira um cartão acoplado ao campo de entrada do agente, com opções clicáveis, uma linha embaixo de cada uma e uma maquete quando o agente compara layouts.
Nada de setas do teclado no terminal, nada de garimpar o histórico. O agente fica marcado como esperando por você, como qualquer agente que precisa de você: ponto vermelho, lista À espera de resposta, notificação push no celular. E você responde onde estiver: no painel, nessa lista no topo da janela, no app móvel ou direto da tela de bloqueio.
O que o cartão de pergunta faz
Tudo o que um agente precisa para fazer uma pergunta clara, e tudo o que você precisa para responder em dois segundos.
Uma pergunta de cada vez
Um cartão tem de uma a quatro perguntas, mostradas uma depois da outra. As etapas numeradas no cabeçalho levam você de volta a uma resposta anterior antes do envio.
Opções que se explicam
De duas a oito opções por pergunta, cada uma com uma linha sobre o que ela implica: custo, risco, efeito colateral. Em uma pergunta de escolha única, o seu clique é a resposta e a próxima pergunta aparece.
Várias escolhas quando faz sentido
Quando mais de uma resposta serve, as opções viram caixas de seleção. Marque o que quiser e depois Seguinte.
Com as suas próprias palavras
Nenhuma opção serve? Digite no próprio campo do cartão. Números também funcionam: 2 escolhe a segunda opção, 1, 3 escolhe duas de uma vez. Enter envia.
Maquetes lado a lado
Comparando layouts? O agente anexa uma maquete a cada opção, em texto simples ou ASCII, ou em HTML renderizado em uma área isolada. Passe o cursor sobre uma opção para vê-la.
Uma última palavra para o agente
No painel, todo cartão termina em Notas adicionais: acrescente a observação que nenhuma opção cobria, ou clique em Pular e enviar.
O terminal continua à vista
O cartão fica acima do campo de entrada e empurra o terminal para cima em vez de cobri-lo. Recolha-o em uma linha com a seta do cabeçalho: a pergunta continua aberta.
A decisão fica no histórico
As CLIs recolhem as chamadas de ferramenta, então o agente abre a resposta repetindo cada pergunta com a sua resposta. Volte no histórico amanhã e a decisão continua lá.
Como funciona uma pergunta estruturada
Quatro etapas, e o agente nunca avança com base em um palpite.
O agente chega a uma decisão
Ele precisa de uma escolha sua: qual banco de dados, qual texto, se mexe ou não na migração. Em vez de escrever a pergunta na resposta, ele chama ask_user, a ferramenta de perguntas do servidor MCP do AgentsRoom.
O cartão aparece acima do campo de entrada
A pergunta, as opções e o contexto do agente em uma ou duas linhas. O agente passa a esperar por você: ponto vermelho na aba dele, lista À espera de resposta, notificação push no celular.
Você responde
Clique em uma opção, marque várias e pressione Seguinte, ou digite a sua própria resposta no campo do cartão. No final, acrescente uma nota ou clique em Pular e enviar.
O agente segue com a sua resposta
Ele recebe as suas escolhas e a sua nota, repete tudo no início da resposta e continua com o que você decidiu.
Longe do computador? A pergunta espera por você
Nenhuma CLI mantém uma chamada de ferramenta aberta para sempre. O AgentsRoom contorna isso, então a sua resposta nunca se perde.
- O agente pergunta
- Pausa dentro de 0:17
- Em pausa, o cartão continua lá
- Você responde, mesmo uma hora depois
- Enviada como mensagem, o agente retoma
A espera acaba, a pergunta fica. Seja qual for a CLI, uma resposta atrasada chega ao agente como mensagem.
Toda CLI corta uma chamada de ferramenta depois de um tempo: o Codex para aos 60 segundos por padrão. Por isso o agente espera a resposta do cartão por um tempo definido, 45 segundos se você não mudar (de 10 a 600). O cabeçalho faz a contagem regressiva: Pausa dentro de 0:17.
No zero, o cartão não fecha. O agente entra em pausa, o cabeçalho mostra Em pausa e o agente continua marcado como esperando por você. Se você responder uma hora depois, a sua resposta é digitada para o agente como uma nova mensagem que começa com [AgentsRoom] Answer to your question, com cada pergunta relembrada. Ele retoma de onde parou.
O Claude Code e o Grok Build esperam o tempo que a sua configuração mandar. O Codex, e as CLIs cujo limite é desconhecido, entram em pausa depois de uns 50 segundos, seja qual for o valor: as chamadas de ferramenta delas são cortadas aos 60.
Responda de qualquer lugar
Um cartão é compartilhado por todas as telas da sua conta. A primeira resposta vale, e o cartão fecha nas outras telas.
Da lista À espera de resposta
A lista no topo da janela mostra a pergunta embaixo do nome do agente. Uma única pergunta de escolha única é respondida ali mesmo, em um clique. Para qualquer coisa mais elaborada, ela oferece Abrir o agente.
Do app móvel
O mesmo cartão fica acima do campo de entrada do agente no app do AgentsRoom: toque em uma opção ou digite no campo do cartão. Ele se recolhe em uma linha e nunca ocupa a tela inteira. As maquetes HTML ficam no computador, as maquetes em texto aparecem no celular.
Da tela de bloqueio
Uma única pergunta com duas opções curtas vira dois botões na Atividade ao Vivo do iPhone ou na notificação ao vivo do Android. Face ID primeiro no iPhone, celular desbloqueado no Android. Qualquer outro cartão mostra Abrir.
Nunca uma resposta para a pergunta errada
Cada resposta leva junto o cartão e a etapa para os quais foi dada. Se o cartão avançou nesse meio-tempo, a resposta é recusada em vez de cair em uma pergunta que você nunca viu.
Um só cartão para todas as CLIs de agente
A pergunta passa pelo AgentsRoom, não pela caixa de diálogo da própria CLI.
No Codex, uma pergunta muitas vezes cai no meio da resposta enquanto o agente segue em frente. O Claude Code tem a sua própria caixa de diálogo, respondida no terminal dele. As outras CLIs fazem cada uma do seu jeito. Com as perguntas estruturadas ativadas, todas perguntam da mesma forma: por meio de ask_user, uma ferramenta do servidor MCP do AgentsRoom que o AgentsRoom já conecta a cada agente que inicia.
Nada para instalar, nenhuma regra para adicionar ao AGENTS.md ou ao CLAUDE.md: o AgentsRoom lista a ferramenta e passa as instruções ao agente quando ele inicia. Só os agentes com a funcionalidade ativada chegam a ver a ferramenta, então os outros não gastam nem um token com ela.
Funciona com Claude, Codex, GitHub Copilot CLI, Cursor e outras 9 CLIs de agente, no macOS, no Windows e no Linux. O Aider é a exceção: ele não tem cliente MCP, então continua perguntando na conversa.
Para os agentes: o lado MCP
Um agente pergunta com ask_user: de uma a quatro perguntas, de duas a oito opções cada, múltipla escolha, uma maquete por opção. Ele também pode ativar ou desativar a funcionalidade para você com settings_set, quando você pede.
ask_usersettings_setAtivado por padrão, e você escolhe onde
As perguntas estruturadas vêm ativadas para todos os agentes. Desative em todo lugar, para um projeto, para um agente ou para uma única pergunta.
Pelo próprio cartão
O menu ⋯ de qualquer cartão: Deixar de perguntar através de cartões, depois Para este agente, Para este projeto ou Para todos os projetos. Uma mensagem diz onde reativar os cartões, com Desfazer.
Para todos os agentes
Configurações > Fornecedores de IA e contas > Perguntas estruturadas. No mesmo lugar, você define quanto tempo o agente espera antes de entrar em pausa e se as maquetes HTML são renderizadas.
Para um projeto
Configurações do projeto > Agentes padrão. Se você redefinir, o projeto volta a seguir a configuração global.
Para um agente
Editar agente > Opções avançadas: Como nas Configurações, Ativado: pergunta através de cartões, ou Desativado: pergunta na conversa.
Para uma única pergunta
Prefere conversar sobre isso? Responder na conversa em vez disso, no menu ⋯: o cartão fecha, o agente é avisado e pergunta de novo em texto simples.
Uma mudança vale a partir da próxima inicialização do agente, porque a lista de ferramentas e as instruções dele são definidas quando ele inicia. As configurações global e de projeto acompanham a sua conta em todos os seus computadores.
Perguntas que os agentes fazem de verdade
Cada cartão é uma decisão que o agente não deveria tomar sozinho.
Escolher uma stack
Onde as sessões devem ficar?
Postgres, Redis ou um cookie assinado, cada um com o seu custo em uma linha. Um clique, e a migração mira o armazenamento que você escolheu.
Escolher um layout
Qual layout para o cabeçalho?
Três maquetes ASCII. Você passa o cursor, compara, escolhe a segunda e acrescenta uma nota: logo menor.
Parar antes do irreversível
Apagamos a tabela antiga agora ou a mantemos por mais uma versão?
O agente para antes da etapa que não dá para desfazer, em vez de decidir por você.
Delimitar o trabalho
Quais outros atalhos devem ganhar um selo?
Seis opções, duas marcadas. O agente faz essas duas e deixa o resto como está.
Dar nome às coisas
Como essa configuração deve se chamar?
Quatro formulações, cada uma com o lugar onde aparece no app. Nenhuma serve? Você digita a sua.
Responder do trem
Fazemos o deploy em staging agora ou esperamos a revisão?
Duas opções curtas, dois botões na sua tela de bloqueio. Face ID, pronto.
Perguntas frequentes
Como faço o Codex fazer perguntas de esclarecimento antes de programar?
Rode o Codex no AgentsRoom com as perguntas estruturadas ativadas, que é o padrão. O agente Codex recebe a ferramenta ask_user e uma instrução na inicialização: perguntar com a ferramenta quando for preciso decidir algo, e depois esperar. As perguntas dele aparecem em um cartão com opções clicáveis acima do campo de entrada, e ele entra em pausa até você responder.
É a mesma coisa que o AskUserQuestion do Claude Code?
Mesma ideia, outro lugar. O AskUserQuestion é a caixa de diálogo do próprio Claude Code, respondida no terminal dele. As perguntas estruturadas são um cartão do AgentsRoom usado por todas as CLIs de agente com MCP, incluindo o Claude Code: até oito opções por pergunta, maquetes para comparar, uma nota no final, respostas pelo celular e pela tela de bloqueio. Com a funcionalidade ativada, o AgentsRoom pede ao Claude Code que use o cartão em vez da caixa de diálogo dele.
Com quais CLIs de agente funciona?
Claude, Codex, GitHub Copilot CLI, Cursor e outras 9 CLIs de agente: todas as CLIs que o AgentsRoom executa e que têm um cliente MCP. O Aider não tem, então continua perguntando na conversa. Uma etapa de um run do Agent Teams também não usa o cartão: ela pergunta pelo próprio run.
O que acontece se eu não responder a tempo?
Nada se perde. Depois da espera (45 segundos por padrão, uns 50 no máximo com o Codex), o agente entra em pausa e o cartão continua lá. Quando você responde, a sua resposta é digitada para o agente como uma mensagem que começa com [AgentsRoom] Answer to your question, com cada pergunta relembrada, e ele retoma dali.
Posso responder à pergunta de um agente pelo celular?
Sim. O cartão aparece acima do campo de entrada do agente no app móvel do AgentsRoom, com as mesmas opções e um campo de resposta próprio. Uma única pergunta com duas opções curtas também pode ser respondida pela tela de bloqueio: dois botões na Atividade ao Vivo do iPhone ou na notificação ao vivo do Android.
Posso digitar a minha própria resposta em vez de escolher uma opção?
Sim, no campo do cartão, abaixo das opções. As suas palavras chegam ao agente junto com as opções que você clicou. Números escolhem opções: 2 para a segunda, 1, 3 para duas delas. Enter envia.
O agente pode me mostrar maquetes antes de eu escolher?
Sim. Cada opção pode trazer uma maquete, em texto simples ou ASCII, ou em HTML renderizado em uma área isolada, sem acesso ao app nem aos seus arquivos. Passe o cursor sobre uma opção para ver a maquete dela. Desative a renderização HTML e você vê o código-fonte no lugar.
O cartão bloqueia o terminal ou o campo de entrada?
Não. Ele fica acima do campo de entrada e empurra o terminal para cima. Recolha-o em uma linha com a seta do cabeçalho. O campo de entrada continua enviando mensagens normais ao agente, e a pergunta continua aberta até você respondê-la no cartão.
Posso desativar para um só agente ou um só projeto?
Sim. Em qualquer cartão: ⋯ > Deixar de perguntar através de cartões > Para este agente, Para este projeto ou Para todos os projetos, com Desfazer. Ou em Editar agente > Opções avançadas, Configurações do projeto > Agentes padrão e Configurações > Fornecedores de IA e contas. A mudança vale a partir da próxima inicialização do agente.
Preciso instalar um servidor MCP ou adicionar uma regra ao AGENTS.md?
Não. A ferramenta fica no servidor MCP do AgentsRoom, que o AgentsRoom conecta a cada agente que inicia, e a instrução faz parte do que o agente recebe na inicialização. Nada para instalar, nada para escrever no AGENTS.md ou no CLAUDE.md.
Quantas perguntas e opções cabem em um cartão?
Até quatro perguntas, mostradas uma de cada vez, e até oito opções por pergunta. Uma pergunta também pode vir sem nenhuma opção: você simplesmente digita a resposta.
Gasta tokens quando está desativada?
Não. A ferramenta só é listada para os agentes que têm a funcionalidade ativada. Um agente com ela desativada nunca vê a ferramenta, e as instruções dele não a mencionam.
É grátis?
Sim. As perguntas estruturadas vêm com o AgentsRoom em todos os planos, inclusive o Free.
Respondi no computador e no celular ao mesmo tempo. Qual resposta vale?
A primeira. O cartão fecha na outra tela, e uma resposta enviada para uma pergunta que já avançou é recusada em vez de ser aplicada à pergunta errada.
Posso simplesmente ignorar uma pergunta?
Sim. Recolha o cartão ou, no menu ⋯ dele, escolha Responder na conversa em vez disso: o agente fica sabendo que você prefere conversar em texto simples. Se você deixar como está, o agente continua esperando, marcado como precisando de você.
Você também pode gostar
Agentes ao vivo
Todos os agentes na tela de bloqueio do iPhone, na Dynamic Island e no Apple Watch, com botões de resposta para o que está esperando.
Acompanhamento de status dos agentes
Trabalhando, esperando por você, concluído: o estado de cada agente num relance, em todos os projetos.
Controle remoto
Comande os terminais dos seus agentes pelo celular, inicie novos, rode o backlog.
Fila de mensagens
A direção contrária: você empilha as próximas mensagens acima do campo de entrada e elas saem na ordem.
Fork de agente e perguntas à parte
Faça uma pergunta à parte ao agente, sem interromper o trabalho dele.
AgentsRoom MCP
As ferramentas que o AgentsRoom dá a cada agente: backlog, comandos de dev, memória, navegador.
Deixe seus agentes perguntarem antes de adivinhar
Baixe o AgentsRoom, abra um projeto e dê a um agente uma tarefa que tenha uma escolha de verdade. O cartão aparece sozinho.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.