Build your first agent

1. Create an agent

In Studio, create an agent and define its name, description, persona, tone, and guardrails.

2. Add a capability

Create a capability for one user goal. Add a clear trigger goal and realistic trigger examples.

3. Design the journey

Use visual authoring for common steps or YAML for the full capability DSL. Typical journeys collect information, invoke actions, branch, confirm sensitive changes, generate content, provide guidance, finish, or escalate to a human.

4. Connect resources

Configure the datapoints, integrations, actions, and knowledge the capability needs. Keep business state in the owning system and call it through explicit actions.

5. Test

Use Playground to exercise the happy path, missing information, action errors, branching, structured cards, and human escalation. Switch between visual and YAML modes to confirm the journey round-trips correctly.

6. Activate and integrate

Save and activate the capability, then connect a channel through the runtime SDK or supported runtime HTTP contract.

Continue with the Capability DSL reference.