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.