Wait
Wait node for Builder — introduce a timed pause into an AI agent workflow, delaying execution by a specified duration before passing control to the next node.
🎯 Purpose
Section titled “🎯 Purpose”Delays workflow execution for a specified duration. This allows for throttling and synchronization before continuing to the next node.
📥 Inputs
Section titled “📥 Inputs”-
Duration — A numeric value indicating how long to wait.
-
Unit — A dropdown selection specifying the time scale:
- Milliseconds
- Seconds
- Minutes
📤 Outputs
Section titled “📤 Outputs”- Passes on its input to the next node after waiting the specified amound of time. No data is transformed or generated. The output simply continues workflow execution after the pause.
📘 Best Practices
Section titled “📘 Best Practices”- Use Short Delays When Testing: Long waits can make debugging slower.
- Avoid Unnecessary Pauses: Only insert waits where timing control is required.
- Combine With External Checks: Use the Wait Node before polling APIs or checking for file availability.
🧪 Test Cases
Section titled “🧪 Test Cases”- Given:
Duration Value = 500,Time Unit = millisecondsExpected: Workflow resumes after 0.5 seconds. - Given:
Duration Value = 5,Time Unit = secondsExpected: Workflow resumes after 5 seconds. - Given:
Duration Value = 1,Time Unit = minutesExpected: Workflow resumes after 60 seconds. - Given: Invalid or negative duration Expected: Error: invalid wait duration
🗂️ Real-World Use Cases
Section titled “🗂️ Real-World Use Cases”- Rate Limiting: Prevent exceeding API rate limits between requests.
- Synchronization: Ensure external services complete actions before the next node runs.
- Timed Triggers: Delay execution to align with scheduled processes or intervals.
✅ Step-by-Step (Quick Start)
Section titled “✅ Step-by-Step (Quick Start)”- Add Wait Node to your workflow.
- Enter a numeric value in Duration.
- Select a time unit from the Unit dropdown.
- Connect the Wait Node to the next step in your workflow.
- Run the workflow and verify that it resumes after the specified duration.
- Save and deploy.