Skip to main content

Capabilities

A Capability is a goal based, deterministic journey that executes a business outcome. It is an executable contract, not just a script, and it produces an auditable trail.

What A Capability Contains​

  • Trigger: when to activate (goal, examples, priority)
  • Journey: ordered steps that guide the conversation
  • Knowledge: collections or documents for answering questions
  • Fallback: what to do when the journey cannot proceed

Trigger Example​

trigger:
  goal: Check order status
  examples:
    - where is my order
    - track my package
  priority: 5
  requires:
    - customAttributes.account_id

Journey Steps​

A journey is a list of steps. Common steps include:

  • collect to gather required data
  • action to call an integration
  • choice to present options
  • confirm before sensitive changes
  • done to finish successfully
  • escalate for handoff

Example Capability​

name: Check Order Status
trigger:
  goal: Check order status
  examples:
    - where is my order
journey:
  - collect: [order_id]
  - action:
      call: orders.get-status
      as: order
      outcomes:
        not_found:
          - done: "Order not found"
  - done: "Order {{variables.order.id}} is {{variables.order.status}}"

Best Practices​

  • Keep one capability per goal
  • Start with the happy path
  • Add error handling and escalation
  • Use 5 to 10 trigger examples