Skip to main content

Keen — Developer Quick-Start

The Keen ecosystem operates via isolated sandboxes tailored for specific functions:

  1. ADMIN — the central management interface where AI Spaces and Agents are configured, linked, and assigned. Example URL: https://sandbox-001.keenbot.ai/org
  2. CHAT — the client-facing surface used to interact with and verify your agents in a live conversational environment. Example URL: https://sandbox-001.keenbot.ai

You will hop into /org several times while you are coding to create or update a record, then come back to your editor. The structure below mirrors that natural flow rather than front-loading all the admin steps.

What you will do, in order​

  1. Get access to the sandbox
  2. Set up your local environment — extension, project files, npm install
  3. Wire your project to a Space — creates the Space in /org and pastes its code snippets back into your project
  4. Build your first agent — interleaves the canvas work with creating the Agent record in /org
  5. Deploy your code to the sandbox
  6. Verify in the Chat — creates a Consumer in /org, signs in, and chats with the agent
  7. Debug
  8. Customize the Chat UI
  9. Advanced — manual chat I/O via Script Nodes

If anything mismatches what is on screen, stop and check — the most common failure mode is a name that does not match between /org and the flow file. Section 4 explains the four-name contract that ties code to admin.