Choice step

Choice step that evaluates conditions and routes execution to different branches, supporting if/then/else logic and nested rules.

A choice step evaluates conditions and routes execution to different branches based on the result.

Configuration

Field	Type	Description
conditions	array	List of condition objects, evaluated in order
defaultNext	string	Step ID to execute if no conditions match

Each condition has:

Field	Type	Description
field	string	Value to evaluate (supports template variables)
operator	string	Comparison operator
value	any	Value to compare against
next	string	Step ID to execute if this condition is true

Operators

Operator	Description
equals	Exact match
not_equals	Does not match
greater_than	Numeric greater than
less_than	Numeric less than
contains	String contains substring
not_contains	String does not contain substring

Example

{
  "id": "check-order-value",
  "type": "choice",
  "conditions": [
    {
      "field": "{{payload.total_amount}}",
      "operator": "greater_than",
      "value": 10000,
      "next": "high-value-flow"
    },
    {
      "field": "{{payload.total_amount}}",
      "operator": "greater_than",
      "value": 5000,
      "next": "medium-value-flow"
    }
  ],
  "defaultNext": "standard-flow"
}

Conditions are evaluated top to bottom. The first matching condition determines the branch. If none match, defaultNext is used.

Next steps

• App action step. Execute an action after branching
• Data access. See choice steps used in real agent examples