Skip to main content

Agents and capabilities

Agents​

An agent defines the experience presented to a user: identity, description, tone, instructions, connected knowledge, and the capabilities it can use.

Keep an agent focused on one coherent experience. Product behavior belongs in capabilities and external actions rather than being hidden in persona text.

Capabilities​

A capability represents one supported goal and contains:

  • a trigger goal and examples;
  • a sequence or graph of executable steps;
  • referenced datapoints, actions, and knowledge;
  • routing, retry, error, and escalation behavior;
  • optional structured card presentation.

The YAML DSL is the source of truth. Visual mode is an authoring surface over that DSL and must preserve constructs it cannot edit directly.

Use deterministic steps for exact output and business transitions. Use models for language understanding or generation only where probabilistic behavior is appropriate.

See the Capability DSL reference.