Core Concepts

Workflow nodes

The node types PIILOT uses to build workflow graphs.

Nodes are the functional units of a PIILOT automation. Each node has an id, kind, label, description, optional app and operation metadata, approval requirements, ports, and configuration.

Edges connect nodes through ports. Branch nodes can expose multiple output paths, while terminal stop nodes end paths intentionally.

Supported node kinds

trigger: starts a workflow from an external event.
input: collects or receives workflow input.
ai: summarizes, classifies, extracts, decides, or generates structured output.
branch: routes the workflow based on rules or AI-derived conditions.
transform: reshapes data before a later step.
approval: pauses execution for human review.
connector_action: performs a tool action through a connected integration.
validation: checks data, state, or workflow assumptions.
log: records an operational event.
stop: ends a workflow path.

Typical node path

flowchart TD
  A[Trigger]
  A --> B[AI node]
  B --> C[Branch]
  C --> D{Needs approval?}
  D -- Yes --> E[Approval]
  D -- No --> F[Connector action]
  E --> F
  F --> G[Log]
  G --> H[Stop]