Skip to content
SurogateDocs

Node kinds and their settings

Every node of a stage’s flow, with each setting its panel holds in Keel Builder. The pages Steps and Decisions, rules, waits and parallel paths explain them in full; the process node is under Processes.

A step is work that waits for its performer. On the board it is a card; it ends with one of its outcomes.

SectionSettings
When it is offeredOptional actions only: Condition, Stages.
Done byAn agent: Agent, Raised hands go to. A person or a queue: A queue or A person, Decided by a vote with Votes needed and Out of. An agent with a person: Agent, Raised hands go to, Finished by or A person. A system: Connection, Method, Path, Query, Headers, Body, Outputs, Accept statuses, Timeout (seconds), When it fails for good.
ReceivesThe fields it reads.
May useAgent steps only: Tools, MCP servers, Knowledge, each everything or narrowed.
Must returnThe fields it writes, each required or not. Edit form.
ChecksEach a Condition and a Message.
Allowed outcomesEach a Label, where it Leads to, and the fields it Requires.
Maker-checkerThe steps whose doers may not do this one.
AuthorityAmount field and Scope.
Service levelGoal, Deadline, Count business time, Past the deadline, escalate to.
PerformerIts work opens asWho completes it
An agentAn agent sessionThe agent; people in its raised-hands queue if it fails or is off
A person or a queueA work item for the person or the queueThe person, a member who claims it, or every member for a vote
An agent with a personAn agent session and the person’s work itemThe person, with the agent’s draft
A systemA call to the connectionKeel’s own call; people in the failure queue, if one is set

Automatic. Takes the first branch whose condition holds.

SectionSettings
BranchesEach a Condition, a Label and Goes to.
OtherwiseGoes to and Label, for when no branch holds.

Automatic. Runs a decision table or scorecard and writes its results.

SectionSettings
RuleOne of the project’s rules.
AssignmentsEach a Result of the rule and the Field it goes to.
ThenWhere the case goes next.

Holds the case until something happens.

SectionSettings
Waits forA time (How long), An event (Event) or A condition (Condition); and At most, a limit.
Waiting onThe client, A third party or Inside the bank.
OutcomesOne per trigger: Elapsed, Arrived, Met and Deadline, each with a Label and where it Leads to.

Automatic. Starts in parallel: the places each path starts.

Automatic. Waits for every path leading to it, then goes to Then.

Starts one of the project’s BPMN processes, and waits for it to end or goes on at once.

SectionSettings
ProcessOne of the project’s processes: those published, and those the open draft adds.
WaitsWaits until the process ends or Goes on at once.
Passes inEach variable the process declares, and the field that fills it, or Not passed.
ReceivesNodes that wait only: each Field and the Variable it receives. Add a field adds one.
OutcomesEnded and Failed, or Started, each with a Label and where it Leads to.
WaitsLeaves byWhen
Waits until the process endsEndedThe process completes or ends.
Waits until the process endsFailedThe process fails, is cancelled or cannot start.
Goes on at onceStartedAt once, when Keel is asked to start the process.
ChoiceMeaning
A node’s nameThat node, in the same stage.
Next stage: name / DoneThe next primary stage; after the last one, or after an alternate stage, the case closes as completed.
Stage: / Alternate stage: nameThe start of that stage.
End of this pathThis path stops; other paths go on.
Action: nameStarts an optional action.
Closed: resolution / Close as…Closes the case with that resolution.

An optional action’s outcomes can also lead to a node of any stage. A case event that interrupts can lead to a node, the next stage, a stage or a close; one that does not interrupt starts an optional action.