Data, and the commerce objects, on the web widget and WhatsApp. Each page holds the complete code in six files or fewer, compiled against lua-cli 3.33.0, and ends with ways to make it yours.
Customer support
Answer from a help center, open Zendesk tickets, follow up. Skill, webhook, job, Data.
E-commerce shopping agent
Search the catalog, build a cart, check out, track orders. Products, Baskets, Orders.
Healthcare portal
Book appointments and read FHIR records behind a consent preprocessor and a disclaimer postprocessor.
Door access over WhatsApp
Unlock a door for guests with a booking, identified by their WhatsApp number, with an audit log.
Greenhouse relay control
Switch a grow light and a fan on a Raspberry Pi from chat, with a nightly lights-out job.
Running any example
1
Create a project
Copy the example’s files into
src/ of a project from lua init; its src/index.ts replaces the scaffold’s.2
Set the variables it reads
Each page lists the
env('KEY') names it uses. lua env sandbox writes .env, which lua test reads and lua chat -e sandbox uploads with each sandbox version; lua env production sets what the live agent reads.3
Compile and test one tool
lua test runs the tool’s execute function locally with no model involved; --name is the tool name, not the skill name.Output
4
Talk to it in the sandbox
lua chat -e sandbox uploads your compiled code and .env values as sandbox versions and lets the platform run the conversation with the model. Run it twice the first time: the first run registers primitives and may answer without them.5
Release
Push every primitive, snapshot an agent version, and promote it; the pushed persona is served at once, everything else on promote. Release an agent to production explains each command and how to roll back.
Tool patterns in the Build guides
The single-tool patterns are the canonical samples in the Build guides.- Call an external API with a key from
env(): Call your API - Read and write the end user’s profile: Identify users
- Store, filter, and semantically search JSON: Store and search data
- Create a job from inside a tool: Schedule a job
- Message someone outside a conversation: Send proactive messages
- Push a card to your own inbox: Add human handoff
- Catalog, cart, and order objects:
Products,Baskets,Orders