ask_user

Cuando un agente necesita que tomes una decisión, te pregunta con una tarjeta de pregunta: la pregunta, un botón por opción y espacio para una respuesta en texto libre. Respondes con un toque, desde cualquier dispositivo, y el agente sigue con tu respuesta.

Detrás de la tarjeta hay una herramienta que el agente llama. Cuál depende del proveedor: algunos traen su propia herramienta de pregunta, que OAR convierte en una tarjeta; para los demás, OAR aporta una llamada ask_user. Es la única herramienta de agente en la que los proveedores difieren en algo más que el nombre.

Lo que ves #

Una tarjeta en la conversación con la pregunta y sus opciones. Una opción responde con un clic.
Una pregunta que admite varias respuestas muestra casillas y un único botón Reply with selection (Responder con la selección). La respuesta enumera cada opción marcada, más lo que hayas escrito.
Una petición de varios valores a la vez se muestra como un formulario con un campo para cada uno.
Una notificación push, si las has activado para las preguntas.
El turn espera mientras la tarjeta está abierta. Un turn que espera a una tarjeta nunca se considera atascado.

Por proveedor #

Proveedor	La herramienta detrás de la tarjeta	Varias respuestas	Varias preguntas en una llamada
Claude, Claude Cloud	`AskUserQuestion`, la propia de Claude	sí	sí, una tarjeta tras otra
DeepSeek Nuevo en 0.9.17	`AskUserQuestion` de Claude Code, como en Claude	sí	sí, una tarjeta tras otra
GitHub Copilot y OpenAI, motor SDK	`ask_user` de OAR, en lugar de la integrada	sí, con `multi_select` Nuevo en 0.9.3, o cuando la pregunta dice «select all that apply»	no
GitHub Copilot y OpenAI, motor de extensión	`ask_user`, la propia de Copilot	no; solo un campo de formulario que admite una lista	formularios con varios campos
Cursor	`ask_user` de OAR	sí, con `multiSelect`	sí, de 1 a 4, una tarjeta tras otra
Grok	ninguna

Grok no tiene tarjetas de pregunta. Su protocolo de agente no tiene forma de preguntar al usuario, así que un agente de Grok solo puede preguntar en el texto de su respuesta y esperar tu siguiente mensaje.

En el motor SDK de Copilot, cada tarjeta con dos o más opciones tiene además un interruptor Select several (Seleccionar varias), para que puedas dar más de una respuesta aunque el agente no lo haya pedido.

Cuánto espera una tarjeta #

Una tarjeta espera una respuesta durante 8 horas; en el motor de extensión de Copilot, 2 horas. Después se le dice al agente que nadie respondió, y sigue según el modo del relay de la conversación.

Lo que se les dice a los agentes #

Que pregunten mediante la herramienta de pregunta, nunca como texto normal en una respuesta. Una pregunta en texto normal no muestra botones y termina el turn.
Que den una lista corta de opciones, y que las omitan solo cuando la respuesta tenga que ser texto libre.
Que pregunten incluso en autopilot (modo del relay) cuando de verdad necesitan tu respuesta.

Parámetros #

`ask_user` de OAR en el motor SDK de Copilot #

Parámetro	Tipo
`question`	texto, obligatorio	la pregunta
`choices`	lista de textos	un botón por opción; el relay conserva las 8 primeras y descarta el resto
`multi_select`	true \| false	puedes elegir varias; la respuesta enumera cada elección, separadas por `,`

{
  "question": "Which database should the new service use?",
  "choices": ["PostgreSQL", "SQLite", "Keep the current one"]
}

El agente recibe User selected: PostgreSQL, o User responded: … para una respuesta en texto libre.

`ask_user` de OAR en Cursor #

Parámetro	Tipo
`questions`	lista de 1 a 4 preguntas, obligatoria
`questions[].question`	texto, obligatorio	la pregunta
`questions[].header`	texto	una etiqueta breve sobre la pregunta
`questions[].options`	lista de 2 a 6, obligatoria	cada una con un `label` (obligatorio) y una `description`
`questions[].multiSelect`	true \| false, predeterminado false	puedes elegir varias

{
  "questions": [
    {
      "header": "Database",
      "question": "Which database should the new service use?",
      "options": [
        { "label": "PostgreSQL", "description": "What the other services use" },
        { "label": "SQLite", "description": "No server to run" }
      ]
    }
  ]
}

Siempre puedes responder en texto libre en lugar de elegir una opción. El agente recibe cada pregunta con su respuesta.

Las herramientas propias de los proveedores #

AskUserQuestion de Claude (que también usan los chats de DeepSeek, que ejecutan Claude Code) y el ask_user integrado de Copilot pertenecen a esos proveedores; sus parámetros los define cada proveedor y pueden cambiar con una actualización suya. OAR toma la pregunta tal como se la entrega el proveedor, muestra la tarjeta y devuelve tu respuesta en la forma que el proveedor espera.

Preguntas de otras sesiones #

Una tarjeta de pregunta también puede responderla otro agente, cuando permites que los agentes trabajen con otras sesiones: con answer_question de relay_tool. A los agentes se les dice que te pregunten primero, salvo que les hayas dicho que decidan ellos. Las tarjetas de aprobación propias de un relay (para iniciar sesiones, para vigilarlas y las aprobaciones de ask y plan) solo puedes responderlas tú.