Inputs, outputs and variables
Open Inputs & outputs in the workflow editor. It has three tabs.
Inputs
Section titled “Inputs”Values the agent supplies when it calls the workflow. The agent sees each input’s name and description, so describe what you expect.
Choose Add input, then fill in:
- Field name: letters, numbers, underscores or dollar signs. Steps read it as
input.<name>. - Value type: Text, Number, Integer, Boolean, Object or List.
- Required: the agent must supply this value.
- Description: what the value means and what format it takes.
- Default value: used when the agent leaves the input out. It must match the type.
- Allowed values: optional. Limits the input to a fixed list.
Use this field as moves a field between tabs. Input and result makes the same field both an input and an output.
Outputs
Section titled “Outputs”What the workflow returns to the agent when it finishes. The agent reads these to explain the result.
Required applies to inputs only. An output can come back empty, for example when the step that sets it didn’t run on that path.
Variables
Section titled “Variables”Working values the workflow keeps while it runs. The agent never sees them.
- Entire workflow: every step can read and change it.
- Current step only: only the running step uses this copy. Other steps see the workflow value.
Steps read a variable by its name: total, not input.total.
Renaming and removing
Section titled “Renaming and removing”Renaming a field offers to update every reference to it. Text you typed is left exactly as written. Removing a field lists the references you’ll need to fix.
Changing an input or output changes what the agent sees the next time the Blueprint is published.
What each step produces
Section titled “What each step produces”A step’s Outputs tab lists what later steps can read from it, with the type of each. Each output has a reference chip, like Transform › Customer. Copy it with the button beside it and paste it into another step’s field.
A step on a different branch may not have run, so its outputs can be empty. The editor warns when you use one.
Save an output to a variable
Section titled “Save an output to a variable”Each output on a step’s Outputs tab has Save output to variable:
- Choose a variable of a matching type, or
- New variable… to create one there.
The variable is set only if the step succeeds, before the next step starts.