AI authoring actions
The article editor has an AI Writing Assistant built in. Click the Sparkles icon below the editor body and a popover slides up with three ways to ask the AI for help. Each one is good at a different thing, and using them well means knowing which to reach for.
The three actions
Clean Up
Fixes typos, broken grammar, awkward sentences, and inconsistent capitalization. Keeps the meaning and structure of the article intact — only the surface gets polished.
Use Clean Up when:
- You’ve finished a first draft and want a quick proofread before publish.
- You’re translating an article in your head and the phrasing came out clunky.
- A non-native writer wrote the draft and you want it tightened.
What Clean Up doesn’t do: change the structure, the headings, or the level of detail. It’s a surface pass.
Improve
Rewrites for clarity, flow, and readability. More invasive than Clean Up — sentences may be reordered, paragraphs may be split, weak phrasing may be replaced.
Use Improve when:
- The article reads stiff and you want it to flow better.
- A teammate’s first draft is solid in content but hard to follow.
- You’ve explained something in three paragraphs and want it tightened to one.
What Improve doesn’t do: add new facts, restructure the article’s headings, or change what it covers. The article keeps its scope; only the writing gets better.
Ask AI to write or edit content
The free-form prompt input. Type a natural-language instruction — Write about pricing plans, Add a section on troubleshooting, Rewrite this for an end-user audience, Make the tone more casual — and the AI does that thing.
This is the most flexible action and the one with the steepest learning curve. The better your prompt, the better the output. Be specific about audience, tone, and what you want included or excluded.
Use the prompt input when:
- You’re starting from scratch and want a first draft from an outline.
- You want to add a section to an existing article.
- The change you want is more nuanced than “polish” or “rewrite for clarity.”
How the AI sees your article
All three actions operate on either the current selection in the editor, or the whole article body if nothing is selected. Highlight a paragraph first and Clean Up only polishes that paragraph; click Clean Up with no selection and it cleans the whole body.
The AI sees the article’s content, but not the metadata (title, category, tags, role assignments). If your prompt depends on context the AI can’t see, include it in the prompt.
A separate action: AI draft from a title
The Generate an article from a title flow is different. It runs before the editor opens — you give it a title, it produces a first draft, and you open the draft in the editor. From inside the editor, the three actions above (Clean Up, Improve, prompt input) are the tools you have. There’s no separate “regenerate everything” button.
What the AI Writing Assistant won’t do
Two adjacent KB capabilities are exposed via the API but not through the AI Writing Assistant popover today:
- Translation jobs — the engine that translates published articles into your enabled languages runs in the background, not from the editor. You don’t trigger it from here. See Multi-language Knowledge Base.
- Embedding rebuilds — the vector index that AI agents retrieve against updates automatically when you publish. There’s an admin endpoint to force a full rebuild, but no UI button. Useful for the rare case where the index has drifted after a bulk import.
Both are deliberate. The editor stays focused on the article in front of you; lifecycle operations happen elsewhere.
Cost and rate limits
AI calls use Atender-billed inference. There’s a soft cap per tenant per day to prevent runaway use; if you hit it, the action shows an error and you can resume the next day. For most teams writing a few articles a week, the cap never comes into play.