Human Tasks
Human Tasks allow a workflow to pause execution and wait for a person to review, approve, reject, or provide additional information before continuing. This enables human-in-the-loop workflows, where AI automation and human judgment work together. Human Tasks are essential for business processes that require oversight, compliance, or manual decision-making.What is a Human Task?
A Human Task temporarily pauses workflow execution. Conceptually:Why Use Human Tasks?
Not every decision should be made automatically. Examples include:- approving payments
- reviewing legal documents
- validating AI-generated content
- approving customer refunds
- reviewing security alerts
- confirming sensitive operations
Workflow Lifecycle
A Human Task changes the normal execution flow.Human Task Object
When a Human Task node executes, it creates a task object. A typical task contains:- task identifier
- workflow instance identifier
- node identifier
- creation time
- completion status
- result
Waiting State
After creating the task, the workflow enters a waiting state.Completing a Task
A user or external application completes the task.Approval Example
A document approval workflow might look like this.AI + Human Collaboration
Human Tasks work naturally with AI agents.Workflow Context
Human Tasks may store results inside the workflow context. Example:Forms
Human Tasks may reference forms or user interfaces. Conceptually:Assignment
Tasks may be assigned to:- individual users
- roles
- departments
- external systems
Human Tasks vs Conditions
These components serve different purposes.
Often they are used together.
Long-Running Workflows
Human Tasks make long-running workflows possible.Best Practices
- Use Human Tasks only where human judgment adds value.
- Keep task descriptions clear and concise.
- Store important decisions in workflow variables.
- Separate workflow logic from user interface implementation.
- Provide meaningful task identifiers for tracking.
- Monitor outstanding tasks to avoid workflows remaining paused indefinitely.
Common Use Cases
Human Tasks are commonly used for:- approval workflows
- document review
- compliance verification
- financial authorization
- security validation
- quality assurance
- customer service escalation
