Combiner Node
TLDR: Combiner nodes wait for multiple agents and assemble them into one. Use Batch mode to collect any N items, or Recipe mode to wait for specific parts defined in a bill of materials.
How to Combine
The first section shows two toggle cards to choose the combine mode:
| Mode | Behavior | Use When |
|---|---|---|
| Batch | Collect any N agents, release as one | Merging parallel paths, collecting identical items |
| Recipe | Wait for specific parts to assemble | Manufacturing assembly, kitting, order fulfillment |
Batch Mode
When "Batch" is selected, a number stepper appears:
Batch Size: [number stepper] PCS
The Combiner waits until this many agents arrive (any type), then releases one combined agent.
A help note reads: "Assembly is instant. Add a Processor after for service time."
Recipe Mode
When "Recipe" is selected, the Bill of Materials section appears below.
Bill of Materials
Only visible in Recipe mode.
The recipe visualizer shows what parts are needed to assemble one output. Each recipe item displays:
- A colored badge for the agent type
- An optional attribute constraint (e.g., "material: oak")
- A count (e.g., "× 4")
- A remove button
Use the "Add to Recipe" form to add parts:
- Select an agent type from the dropdown
- Set the count (how many of this type are needed)
- Optionally select "With attribute" to require a specific attribute value (e.g., only "oak" legs, not "pine")
- Click Add
An arrow divider (↓) separates the inputs from the output badge showing "Combined".
The Combiner itself takes zero time — it just waits for parts. If your assembly process takes time, place a Processor node after the Combiner.
Path Control
Only visible when 2 or more outgoing connections exist.
Same routing options as other nodes: Random, Custom Split, Shortest Queue, Priority, or Conditional.
If one part arrives much faster than others, it piles up in the Combiner's buffer. This reveals supply imbalances — check the analytics to see which part is the bottleneck.