Skip to main content

Capability DSL

The capability DSL is the canonical authoring format. A capability declares its goal, examples, resources, and executable behavior graph.

Supported behavior types​

TypePurpose
collectGather and validate datapoints
actionInvoke a configured integration action
choicePresent options and route from the selection
confirmRequire an explicit checkpoint before continuing
guideProvide goal-oriented guided instructions
investigateRun read actions and route from findings
generateGenerate conversational, artifact, or file content
sayEmit exact template-capable text without a model call
ifRoute using an explicit condition
gotoJump to another stable behavior slug
doneComplete the journey
escalateHand the conversation to a human queue

Routing​

Routes may continue, complete, escalate, or target another stable step slug. Missing targets are invalid and should remain visible during authoring rather than silently routing elsewhere.

Step names are user-facing. Slugs are internal route identifiers and should be stable when explicitly authored or referenced.

Round-tripping​

Visual authoring must preserve advanced fields such as conditions, constraints, retries, error handling, change handling, fallbacks, templates, outputs, review, presentation, and notifications even when a visual control is not available.

Use the editor's schema validation and autocomplete for the exact field-level contract supported by the deployed version.