Schema
PlanStep
Individual step in an AI-generated execution plan. Each step describes a discrete action the task will perform, with enough detail for human review before approval.
| Field | Type | Description |
|---|---|---|
orderrequired | integer | Execution order of this step (1-indexed) |
actionrequired | string | Plain English description of the action to be performed |
inputs | string[] | List of input data/resources this step will use |
expected_outputs | string[] | List of expected outputs/artifacts from this step |
is_write_operation | boolean | Whether this step performs write operations to external systems |
estimated_duration_seconds | integer | null | Estimated time to complete this step in seconds |
risk_level | "low" | "medium" | "high" | Risk level classification for plan steps.
Used to communicate the potential impact of each step to users,
especially for write operations that modify external systems.lowmediumhigh |
target_system | string | null | External system this step interacts with (e.g., 'xero', 'quickbooks', 'email') |
requires_confirmation | boolean | Whether this specific step requires user confirmation before proceeding |