Maintain consistency and quality across your content with AI-accelerated content reviews. Set up detailed review guidelines tailored to specific textual elements. Whether you are working with rich text or simple text elements, you can use AI to ensure your content meets the your standards by providing insightful comments and actionable suggestions.
The AI-powered content reviews are only as good as the review guidelines you provide. Without proper review guidelines, the AI might give you review suggestions that are vague, inaccurate, or contradictory to one another.Here are a few tips for crafting effective review guidelines.
You can also provide your instructions in languages other than English.
AI-accelerated content reviews work on a per-element
For best results, we recommend creating multiple context-specific content review guidelines so content creators can choose the right one based on their current needs.
If you want to configure specific content review guidelines as the default choice for an element, follow these steps:
In Content model, open a content type for editing.
For a rich text or text element, click its .
In Content review guidelines, click the input field.
Select the preferred content review guidelines, such as Example of general style guide.
Click Savechanges.
Now you can review the element’s content with a click of a button.
Feel free to adjust the predefined Example of general style guide to fit your business writing style or create your own.
Once you set up content review guidelines for your elements, you can review an element’s content by clicking .
During the review, the AI adds comments and suggestions to your content. Each comment explains the reason behind flagging a specific part of your content, and each suggestion provides a possible fix for the issue.
When reviewing your content with AI, keep in mind the following:
In certain cases, you might need to review content with AI repeatedly to ensure it passes all the checks defined in your content review guidelines.
basis. By default, they are available for all supported text and rich text elements. Optionally, you can configure content review guidelines for your content type elements to specify the default guidelines for the element.
in content items, not components.
The reviews are available only in the default language of your project.
The maximum length for review guidelines is limited to 100,000 characters.
The review is one level deep. If your rich text elements contain components or content items
Responses are in English. You can review content in languages other than English, but the AI only provides comments in English. For example, if your content review guidelines are in Dutch and you use them to review Dutch content, the AI assistant’s reasoning will be in English, but its suggestions will be in Dutch.
The reviewed content element must contain 10 words or more.
, this inserted content won’t be reviewed as part of the rich text element review.
The content review guidelines must be in plaintext, but that doesn’t mean they should be without structure.We recommend structuring your guidelines with headings, paragraphs, and lists. This means using a markup language, such as Markdown, AsciiDoc, or ReStructuredText, to make the guidelines clearer for the AI assistant to understand and interpret.
Make sure your rule descriptions are explicit and leave little to no room for interpretation. Imagine you give the review guidelines to your new colleague as part of their onboarding. They need to understand the rule the way you intended.If your review guidelines contain many rules, ensure that following one rule doesn’t lead to a violation of another rule.
Explain what it looks like when a rule is followed and when it’s broken. What’s correct? What’s incorrect? Don’t be afraid to state the obvious and provide multiple examples. By adding examples for each rule, the content reviews become more accurate and leave less room for error. For example, let’s say you have a rule about directness that aims to avoid using words like “please”.
Creating great review guidelines is an iterative effort. Adjust them over time based on your content creator’s feedback. You might find that some rules can be more explicit or use better examples.It can feel similar to tweaking an AI prompt until it does just what you need on the first try.
When selecting content review guidelines, you can also choose to create new guidelines or edit existing ones using .
When selecting content review guidelines, you can also choose to create new guidelines or edit existing ones using .
After you start the review, the AI analyses the element and its compliance with its review guidelines.
After you start the review, the AI analyses the element and its compliance with its review guidelines.
If you're satisfied with the suggested revision, you can apply the suggestion using . If the suggestion doesn't fit, you can resolve the comment or give us feedback.
If you're satisfied with the suggested revision, you can apply the suggestion using . If the suggestion doesn't fit, you can resolve the comment or give us feedback.
To review content with AI, you need to activate it in Innovation Lab.
Markdown
# Guidelines title## Rule titleRule description* Correct: Lorem ipsum ...* Incorrect: Dolor sit amet ...
Markdown
## DirectnessRule: Be direct; avoid overly polite phrases and softening phrases like "please".* Correct: You can send in the file by 5:00 PM.* Incorrect: Please send in the file by 5:00 PM, if possible.
Jan Cerman
7 minutes
AI / Author Assist / Comments & suggestions
