Quickstart Preview
Run the Cogwheel Cycles adapter, load its Domain Pack, get a first answer and pass a first golden case.
This feature is in preview. Its contract may change before general availability. Changes are announced in the Changelog.
- 1Get a DomainKey
- 2Download the example
- 3Run the adapter
- 4Load the Domain Pack
- 5Ask for a repair quote
- 6Run a golden case
Cogwheel Cycles is a fictional chain of bicycle repair shops with two Partners, Riverside and Old Town. Its agents book repairs, move bookings and answer questions about the shops. See every file.
Step 1 — Get a DomainKey
In the console, open Settings → API Keys and create a key. It is shown once. Keep it in your shell, with the id of the Partner you will test with (the console’s Partners page shows it).
export WISA_DOMAIN_KEY=<your DomainKey>
export PARTNER_ID=<the Riverside Partner's id>
Step 2 — Download the example
The example holds the Domain Pack and two reference adapters, one in TypeScript and one in Python. They behave the same.
git clone https://github.com/wisa-ai/docs
cd docs/examples/cogwheel-cycles
ls
✓ You see adapter-ts, adapter-py, seed and scripts.
Step 3 — Run the adapter
Start one adapter. It keeps bookings in memory, so every restart begins empty. Expose port 8080 over HTTPS with any tunnel.
cd adapter-ts
npm install
ADAPTER_SECRET=choose-a-long-secret npm start
cd adapter-py
ADAPTER_SECRET=choose-a-long-secret python -m adapter
✓ The terminal shows Cogwheel Cycles adapter listening on :8080, and curl https://<your-tunnel>/ping answers {"status":"ok"}.
Step 4 — Load the Domain Pack
The pack is the folder seed/ai-manifest: Operations, agents, intents, rules, tools, pipelines and golden cases. The platform also needs your adapter’s address and the secret it expects.
There is no command-line upload of a Domain Pack yet. Send the seed folder, your tunnel’s HTTPS address and your adapter secret to your wisa.ai contact, who loads it for your Domain and assigns the pipelines to your Partners.
✓ In the console, AI Manifest lists the agents agent@booking-agent, agent@shop-info-agent and agent@repair-quoter, and Partners shows both shops.
Step 5 — Ask for a repair quote
operation@repair-quote is a single-turn Operation: one request in, one answer out. Call it with your DomainKey.
curl https://api.wisa.live/mcp/v1/runs \
-H "content-type: application/json" \
-H "x-api-key: $WISA_DOMAIN_KEY" \
-d '{
"partnerId": "'"$PARTNER_ID"'",
"operationKey": "operation@repair-quote",
"input": { "job": "job@repair-quote", "query": "My rear brakes squeal. What does a brake service cost?" }
}'
✓ The answer gives a range, not a final price, and result.data is { "service": "brake-service", "priceRange": [25, 40], "currency": "EUR" }.
Step 6 — Run a golden case
A golden case plays a simulated contact against your agents and checks the result. Open Analytics, choose Run test, pick the pipeline cw-service-desk and the case book-brake-service.
✓ The verdict is Passed. Your adapter’s log shows a find_slots call, then a book_repair call.