The AI Assistant
Semantic incorporates an AI assistant that helps you improve the editorial quality and SEO of your articles. The AI operates on two levels: block by block or on the entire article.
Block correction (AI Block)
Each block of type paragraph, title (H2, H3, H4), SEO title, and intro has an AI (sparkle icon) button in its toolbar.
How to use it
- Select a block to display its toolbar.
- Click on the AI icon on the right of the bar.
- In the menu, click on Correct Errors.
- The AI analyzes block evaluations (length, readability, passive voice, transition words, etc.) and suggests a correction.
- A preview window opens with three tabs:
- Before: the original content
- Differences: highlighted changes (additions in green, deletions in red)
- After: the corrected content - Click on Apply to validate, Retry to request a new correction, or Cancel to make no changes.
If all block evaluations are green, a message indicates that everything is already correct.
What the AI corrects
- Length: shortens overly long paragraphs, expands too short ones
- Double spaces: removes double spaces
- Keywords: naturally integrates missing key phrases and keywords
- Long sentences: breaks up sentences over 30 words
- Passive voice: rephrases passive constructions into active voice
- Transition words: adds logical connectors to smooth reading
- Readability: simplifies vocabulary and sentence structures
- Titles: adjusts length and integrates keywords
- Intro: adapts length for the SERP (ideally 120-155 characters)
Full article correction (AI document)
The Correct the Article button appears in the SEO panel (right sidebar) when document-level evaluations are orange or red.
The configuration window
Before launching the correction, a dialog box allows you to configure the AI:
Strict mode
When enabled, the AI applies minimum lengths to all paragraphs. When disabled, short paragraphs are tolerated (useful for catchy or transitional sentences).
The SEO title and intro are always corrected, even in non-strict mode.
Intelligent bold
The AI bolds the 2 to 5 most important sentences in the article: key conclusions, direct responses, actionable recommendations. This is not a mechanical bolding of every keyword, but a strategic bolding designed for the reader and optimized for SEO.
Also correct each block
Also corrects errors specific to each block (length, readability, transitions, passive voice). This option consumes more tokens.
Internal links
If your article is associated with a Butterfly property, you can search for published articles on your site and suggest them as internal links. You can also directly enter a URL.
The AI integrates these links naturally within the existing text, using descriptive keywords as anchor text — never generic phrases like “click here” or “learn more.”
External links
Add URLs of external sources (Wikipedia, reference sites, etc.). The AI will integrate them into the appropriate paragraphs, finding a relevant existing sentence as an anchor.
The review of corrections
After processing, a review window opens. It displays all changes proposed by the AI:
- Sidebar: list of modified blocks with their status (pending, accepted, rejected). The + sign indicates a new block inserted.
- Main area: for each change, you see the reason for the change and the Before / Differences / After tabs.
- Buttons per block: Accept or Reject each change individually.
- Global actions: Accept All to validate all changes at once, or Apply Accepted to apply only those validated.
Best practices
- Always review corrections: the AI is an aid tool, not a replacement for editorial judgment. Use the preview to check each change.
- Start with document correction for structural issues (links, keywords, titles), then use block-by-block correction for fine-tuning.
- Suggest relevant links: the closer the internal and external links you provide are to the topic, the better the result will be.
- Use non-strict mode if your writing style includes intentionally short paragraphs (hooks, transitions).