Core concepts

The mental model. Read this once and the rest of the docs will click.

Agents

An agent is a single bot with one identity, one knowledge base, one personality, and one public URL. You can own many. Each agent has a unique slug (its URL) and a kind: either chat or try-on.

The two kinds

Chat agent

A conversational bot. Visitors type, the agent answers. Answers come from your Knowledge (PDFs, URLs, pasted text) interpreted through your Personality (system prompt). Optional Tools let it take actions like searching the web.

Try-on bot

A visual product try-on. Customer uploads a selfie, the bot composites your product (a wig, hat, helmet, hair piece, garment) onto them and returns a photoreal image. Try-on bots are locked to allow-listed store domains so no one else can pipe your catalog into their store.

The editor tabs

Every agent in the dashboard has the same tabs along the top:

  • Profile — identity (name, slug, avatar, description).
  • Personality — system prompt that shapes voice and rules.
  • Knowledge — the source material it answers from.
  • Tools — actions it can take during a conversation.
  • Memory — facts it remembers across sessions.
  • Data — transcripts, usage, analytics.
  • Styling — colors, fonts, welcome message.
  • Publish — share link, embed snippet, custom domain, visibility.

Public URL vs embed

Every agent has both:

  • A public page at askthe.bot/a/your-slug — a standalone full-screen chat or try-on. Share the URL anywhere (email, DMs, QR code, social bio).
  • An embed snippet — a one-line <script> tag that drops a floating chat bubble (or try-on button) onto any page of your own website.

Most merchants use both: the page for marketing links, the embed for the actual storefront experience.

Visibility

Three modes, set in the Publish tab:

  • Public — discoverable, shareable, indexable.
  • Unlisted — works only via direct link.
  • Private — only the owner can access. Useful for staging.

Custom domains

You can host your bot on your own subdomain — e.g. chat.acme.com or tryon.brand.com. Add the domain in the Publish tab, paste the DNS records into your DNS provider, and the bot lives there in a few minutes.

Pricing model

Chat usage is metered in messages. Try-on usage is metered in renders (each composited image). Plans bundle a monthly allowance plus overage. See Pricing.