Bixby Developer Center

Defines an explicit order in which to collect the inputs.

By default during the collect phase, Bixby evaluates inputs in the same order that they are defined in the action file (from top to bottom). However, with this special keyword, you can override this behavior so that Bixby evaluates all inputs with an explicit order first, going from the lowest explicit order to the highest explicit order. More concretely, Bixby evaluates an input with order(1) first before an input with order(2). Bixby then evaluates all inputs without explicit order in the order they are defined (from top to bottom).

Example

Let's say that you have an action to find recipes that accepts many inputs.

action (FindRecipes) {
  collect {
    input (dish) {
      ...
    }
    input (cuisine) {
      ...
    }
    input (meal) {
      ...
    }
    input (diet) {
      ...
    }
  ...
}

The default evaluation order is top to bottom, so if users don't provide any inputs, Bixby looks for dish, then cuisine, then meal, then diet.

You can use an explicit order to instead look for the input in a different order (meal, cuisine, dish, diet):

action (FindRecipes) {
  collect {
    input (dish) {
      ...
    }
    input (cuisine) {
      order (2)
      ...
    }
    input (meal) {
      order (1)
      ...
    }
    input (diet) {
      ...
    }
  ...
}