Esperar a que el contacto termine
Usa esta acción en una herramienta del agente cuando el mensaje de un contacto parece sin terminar, por ejemplo una frase cortada a la mitad o una lista que todavía se está escribiendo, y responder ahora sería responder solo la mitad. El agente no envía nada ahora, y la conversación se vuelve a mirar unos segundos después, con todo lo que llegó mientras tanto, como un solo mensaje.
Solo funciona en una herramienta que el agente llama durante una conversación. En cualquier otro lugar (un workflow, una preacción, un paso después de la respuesta) el paso falla.
En el editor
En el selector de acciones está en Agente y conversación, como "Solo en herramientas del agente: no envía nada y vuelve a mirar". En el flujo, el paso se lee así: No enviar nada ahora y volver a mirar en 20 segundos.
En Lo que hace hay una frase para completar:
- No enviar nada ahora y volver a mirar en … segundos: escribe los Segundos. Es obligatorio.
- Usar una expresión cambia la casilla por una expresión, por ejemplo un argumento de una herramienta. Usar un número vuelve al número.
Más de 0 y como máximo 60 segundos: una espera mayor cuenta como 60. El editor también dice lo que el paso hace con la ejecución:
- Este paso no detiene los pasos que le siguen. Cuando termina la llamada de herramienta del agente, la ejecución acaba sin respuesta del agente, y la conversación se vuelve a mirar después de la espera.
- Solo funciona en una herramienta que el agente llama durante una conversación, una vez por cada mensaje del contacto.
Los pasos siguientes pueden leer:
- Hora de reanudación (
deferredUntil): La fecha y la hora en que se vuelve a mirar la conversación, con lo que haya llegado durante la espera. - Espera (segundos) (
seconds): La espera que se usó de verdad, en segundos: 60 como máximo. - Pasó: Sí cuando este paso no falló.
Todo paso tiene también Este paso se ejecuta, Si este paso falla, la ejecución, Editar como campos, Ver como JSON y Listo: consulta El editor de pasos.
Mejor para
- Contactos que envían una sola idea en varios mensajes cortos, cuando el agente lo nota a mitad de la conversación
- Dejar que el agente decida, mensaje a mensaje, que todavía es pronto para responder
Campos principales
Los campos del propio paso, en Editar como campos y en la API y el MCP:
| Campo | Qué hace |
|---|---|
Segundos de espera antes de reanudar la conversación (0 a 60) (seconds) | Obligatorio. Expresión CEL que evalúa a la espera, en segundos. Debe ser mayor que 0; los valores por encima de 60 se limitan a 60 |
Qué pueden usar los pasos posteriores
| Salida | Significado |
|---|---|
deferredUntil | La fecha y la hora ISO-8601 en que la conversación se reanudará con lo que haya llegado durante la espera |
seconds | La espera que se usó de verdad, en segundos, después del límite de 60 |
Léelas con maps.get(workflow.step(N), 'deferredUntil') y maps.get(workflow.step(N), 'seconds'). Esta acción publica en la raíz del paso — no hay objeto data.
Qué pasa durante la espera
- El agente no envía nada de esta ejecución: ningún mensaje, ningún error.
- Cuando termina la espera, la conversación se reanuda. Si el contacto envió más, el agente responde a todo de una vez. Si no llegó nada, se reanuda igualmente y el agente responde a lo que ya tiene.
- Una espera por mensaje del contacto: la ejecución que inicia la reanudación no puede volver a esperar, y una segunda espera por el mismo mensaje se rechaza. El agente tiene entonces que responder con lo que tiene.
Consejos
- De 8 a 15 segundos es el rango útil; elige lo que la persona tarda en escribir, no el máximo.
- No sirve para "necesito más tiempo" o "todavía estoy trabajando": el contacto no ve nada de la ejecución que espera.
- Para que el agente espere después de cada mensaje de una conversación, y no una vez, usa Definir la espera antes de responder.
- El paso falla con un código en
workflow.step(N).executionContext.safeError.code:agent_wait_for_user_no_conversation(la ejecución no tiene conversación),agent_wait_for_user_no_run(fuera de la ejecución de un agente, por ejemplo un paso de workflow),agent_wait_for_user_invalid(no es un número de segundos mayor que 0),agent_wait_for_user_chained(una segunda espera por el mismo mensaje).