Aguardar o contato terminar
Use esta ação em uma ferramenta do agente quando a mensagem de um contato parece inacabada, por exemplo uma frase cortada no meio ou uma lista que ainda está sendo digitada, e responder agora seria responder só metade dela. O agente não envia nada agora, e a conversa é olhada de novo alguns segundos depois, com tudo o que chegou nesse meio-tempo, como uma só mensagem.
Ela só funciona em uma ferramenta que o agente chama durante uma conversa. Em qualquer outro lugar (um workflow, uma pré-ação, uma etapa depois da resposta) a etapa falha.
No editor
No seletor de ações, fica em Agente e conversa, como "Só em ferramenta do agente: não envia nada e olha de novo logo". No fluxo, a etapa aparece assim: Não enviar nada agora e olhar de novo em 20 segundos.
Em O que ela faz há uma frase para completar:
- Não enviar nada agora e olhar de novo em … segundos: digite os Segundos. É obrigatório.
- Usar uma expressão troca a caixa por uma expressão, por exemplo um argumento de uma ferramenta. Usar um número volta ao número.
Mais de 0 e no máximo 60 segundos: uma espera maior conta como 60. O editor também diz o que a etapa faz com a execução:
- Esta etapa não interrompe as etapas depois dela. Quando a chamada de ferramenta do agente termina, a execução acaba sem resposta do agente, e a conversa é olhada de novo depois da espera.
- Só funciona em uma ferramenta que o agente chama durante uma conversa, uma vez para cada mensagem do contato.
As etapas seguintes podem ler:
- Horário da retomada (
deferredUntil): A data e a hora em que a conversa é olhada de novo, com o que tiver chegado durante a espera. - Espera (segundos) (
seconds): A espera de fato usada, em segundos: 60 no máximo. - Passou: Sim quando esta etapa não falhou.
Toda etapa também tem Esta etapa roda, Se esta etapa falhar, a execução, Editar como campos, Ver como JSON e Concluir: veja O editor de etapas.
Melhor para
- Contatos que enviam um único pensamento em várias mensagens curtas, quando o agente percebe isso no meio da conversa
- Deixar o agente decidir, mensagem a mensagem, que ainda é cedo para responder
Campos principais
Os campos da própria etapa, em Editar como campos e na API e no MCP:
| Campo | O que faz |
|---|---|
Segundos de espera antes de retomar a conversa (0 a 60) (seconds) | Obrigatório. Expressão CEL que avalia para a espera, em segundos. Precisa ser maior que 0; valores acima de 60 são limitados a 60 |
O que as etapas seguintes podem usar
| Saída | Significado |
|---|---|
deferredUntil | A data e a hora ISO-8601 em que a conversa será retomada com o que tiver chegado durante a espera |
seconds | A espera de fato usada, em segundos, depois do limite de 60 |
Leia com maps.get(workflow.step(N), 'deferredUntil') e maps.get(workflow.step(N), 'seconds'). Esta ação publica na raiz da etapa — não há objeto data.
O que acontece durante a espera
- O agente não envia nada desta execução: nenhuma mensagem, nenhum erro.
- Quando a espera termina, a conversa é retomada. Se o contato enviou mais, o agente responde a tudo de uma vez. Se nada chegou, ela é retomada mesmo assim e o agente responde ao que já tem.
- Uma espera por mensagem do contato: a execução iniciada pela retomada não pode esperar de novo, e uma segunda espera pela mesma mensagem é recusada. O agente então precisa responder com o que tem.
Dicas
- De 8 a 15 segundos é a faixa útil; escolha o tempo que a pessoa leva para digitar, não o máximo.
- Não é para "preciso de mais tempo" ou "ainda estou trabalhando": o contato não vê nada da execução que espera.
- Para o agente esperar depois de toda mensagem de uma conversa, e não uma vez, use Definir a espera antes de responder.
- A etapa falha com um código em
workflow.step(N).executionContext.safeError.code:agent_wait_for_user_no_conversation(a execução não tem conversa),agent_wait_for_user_no_run(fora da execução de um agente, por exemplo uma etapa de workflow),agent_wait_for_user_invalid(não é um número de segundos acima de 0),agent_wait_for_user_chained(uma segunda espera pela mesma mensagem).