Scenarios
Worked recipes for the jobs teams ship first. Each names the pieces involved and how to verify it end to end.
Every scenario follows the same shape: goal → pieces (agent, tool, component, rule, SDK) → steps → verify. They build on the Acme Shop sample, which every new workspace gets, so you can follow them before you connect your own API.
| Scenario | What the user experiences | Main pieces |
|---|---|---|
| Product search with cards | “running shoes under 2000” → tappable product cards from your catalogue | tool, custom component, prompt |
| Order tracking with a map | “where is my order?” → status, ETA, courier, live map | tool, built-in blocks |
| Cancel an order with confirmation | The assistant asks before calling a destructive API | tool with confirmation |
| Flight search and selection | Flights list → tap to select → the model continues with the choice | tool, agent actions |
| Store offer on geofence entry | App enters a store geofence → banner → chat opens with a code | track, rule with notify and turn |
| Abandoned cart nudge | Idle cart → the assistant speaks first with quick replies | track, rule with turn, frequency cap |
| Payment failed alert | Payment declined → modal with a Retry button that reopens checkout | track, rule with alert and local action |
| Order shipped push | Order ships while the app is closed → OS notification → tap opens the chat | secret key, system channel, FCM |
| Agent navigates the app | “open the trail runner” → the app navigates to the product page | app_command, local action |
| Hand off to a human | “talk to a person” → the assistant steps back, your team continues | handoff tool, Conversations page |
| Signed-in users and per-user tools | The assistant only sees the user’s own orders | host JWT, act as user |
| Sales dashboard in chat | “show me this month’s sales” → a chart | tool, chart block |
| Branded theme and dark mode | The chat looks like your app | Settings → Widget branding, KletsoTheme |
| Live cart total in a surface | A card shows the cart’s progress to free shipping without sending it to the server | host data bindings, progress block |
If your scenario is not here, the Concepts pages explain the building blocks; most jobs are a tool plus a prompt line plus a component.