Pular para o conteúdo principal
Atualizado em Nov 16, 2026

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:

  1. Não enviar nada agora e olhar de novo em … segundos: digite os Segundos. É obrigatório.
  2. 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:

CampoO 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ídaSignificado
deferredUntilA data e a hora ISO-8601 em que a conversa será retomada com o que tiver chegado durante a espera
secondsA 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).