Audience: User
LokAkrt’s AI assistant helps you compose and refine pages with natural language. You stay in the page builder: describe the change, review steps and questions, and let successful Agent edits land as page revisions under Versions.
The assistant is available for project pages, global pages, templates, and blocks (same builder shell).
How the loop works end to end: How the assistant works.
The assistant asks project-specific questions rather than reading your whole project, so a small model is usually enough. A larger model mainly helps with richer page designs. Pick the model in the composer when more than one is enabled.
| Role | Purpose |
|---|---|
| Content author | Faster first drafts and layout tweaks |
| Project lead | Spike new screens for review |
| Power user | Combine assistant runs with precise manual edits |
Context chips (current page, selection, device breakpoint) are included automatically. Enter sends; Shift+Enter adds a newline. Use Stop while a run is in progress. Clear removes history for the current page + project.
📷 AI assistant tab
Image Path:
images/ai-assistant-tab.png
Alt Text:
Page builder AI tab with prompt input and conversation
Caption:
Prompting the assistant while editing a page.
Add a mobile header with title "Welcome" and a primary button "Get started".Expected result: New structure appears without hand-building every piece.
Common mistakes: Vague prompts (“make it better”); publishing without mobile preview; skipping Save after hand edits.
Modes, questions, and approvals: Asking, answering, approving.
| Action | User | Admin |
|---|---|---|
| Use AI in builder (incl. picking an enabled model) | Yes* | Yes |
| Register this workspace with the AI server (AI URL) | — | Yes (Settings) |
| Configure inference profiles, default model, Host/Model/pricing | — | Yes — AI operator Settings (ui/ai, typically port 5200), not workspace Settings |
*Requires AI services to be configured and reachable.
| Problem | Cause | Solution |
|---|---|---|
| AI tab errors | AI server down or misconfigured | Ask an Admin to check workspace Settings → AI (URL / register) and Server status |
| No models / cannot send | No enabled profiles, or Host unreachable | Ask an Admin to enable a profile and fix Host in the AI operator Settings |
| Wrong model for a run | Composer select only affects new asks | Change the model, then send again |
| Step stopped / no change | Step failed or was not allowed | Read the step’s reason on the run card |
| Unexpected changes | Broad prompt or wrong revision | Restore an earlier version from Versions, or Discard if the report still offers staged Apply/Discard; use History restore only for a published tip |
| Already published by mistake | You published before reviewing | Restore an earlier revision from History, then fix and publish again |