The site assistant is the reader-facing **Ask AI** built into every published Doxbrix site. Instead of forcing readers to skim pages hunting for an answer, it le...
The site assistant is the reader-facing **Ask AI** built into every published Doxbrix site. Instead of forcing readers to skim pages hunting for an answer, it le...
The site assistant is the reader-facing Ask AI built into every published Doxbrix site. Instead of forcing readers to skim pages hunting for an answer, it lets them ask a question in plain language and get a direct, accurate response drawn from your documentation — with citations they can click to verify. When it can't help, it hands off to your support team with full context.
What readers experience
Readers open the assistant from the Ask AI entry point on the published site. They type a question and get a streamed answer:
- The answer is written in clear prose, with citations linking to the source pages.
- A welcome message and starter questions greet them before they type.
- Follow-up questions are remembered, so readers can refine without re-explaining.
- If the docs don't cover it, the assistant offers a support handoff.
It's an agent, not just search
The assistant doesn't just match keywords — it reasons and uses tools to construct an answer:
It answers only from your published documentation, so it doesn't hallucinate generic answers — and every response links to the exact pages it used. On a private site, it only answers from content the signed-in reader can access.
Configuring the assistant
Tune the reader assistant in Settings → Project → Assistant (/settings/project). The settings are grouped:
Availability & status
- Reader assistant — show the assistant to visitors on the published site.
- Assistant status — Active, Inactive, or Maintenance.
Identity & greeting
- Assistant name — the name shown in the widget.
- Welcome message — the greeting before the first question.
- Starter questions — one per line; up to six suggested questions are shown.
Answers & behavior
- Assistant engine — Spark (fast) or Atlas (deeper reasoning).
- Response length — Brief, Balanced, or Detailed.
- Fallback mode — Answer with fallback, Deflect only, or Custom message (with a Fallback message) for questions the docs can't resolve.
- Show citations — display the source links with each answer.
Support handoff
- Support email, Show help button, Help button label, Help button action (Email or URL), and Help button URL. See Support handoff.
Limits
- Approval mode, Monthly budget, and Rate limit per IP to keep usage and cost in check.
Where it's available
- On your published site (the Ask AI entry point on every page).
- Embedded in your own app or marketing site.
- On private sites, scoped to what each reader can access.
Analytics
Every assistant conversation feeds analytics: the questions readers ask, which ones the assistant couldn't answer (your documentation gaps), citation click-through, and the escalation rate to support. These insights tell you exactly what to document next.