AI Actions: AI Suggestions
AI Suggestions are an entry-level type of AI Action in Contentful that analyzes your content to generate insightful, actionable suggestions. Insight types include content quality checks, alignment with style guides.
Unlike AI Actions that transform content, AI Suggestions focus on analyzing and suggesting. These produce stored results that can be reviewed, reused to maintain brand consistency and improve content quality assurance.
How to use AI Suggestions:
Navigate to an entry within your Contentful space where you want to perform content analysis.
In the entry editor, choose “AI Suggestions” from the AI dropdown.
In the right-hand sidebar of the entry editor, open the AI Actions tab. If your space has AI Actions enabled, you’ll see a panel showing available actions for that entry.
AI Suggestions are visually distinguished by a light bulb icon. Transform Actions uses a lightning bolt icon. These two types are shown in the AI Actions configuration tab and categorized accordingly in the sidebar.
Select an existing AI Suggestions or create a new one by defining your instructions. You can write instructions like:
“Highlight any spelling and grammar issues.”
“Analyze this content against our brand guidelines.”
“Check for potential violations of compliance based on this document.”
You can enhance your prompt using variables, such as:
Entry fields (e.g., title, body).
Media files (now including PDF or text documents).
6. You can upload resources such as style guides or compliance documents to align with your content quality checks). To include a reference document:
Go to the Media in the variable picker in your AI Action Instructions.
Upload or select a PDF or text file (e.g., a style guide or legal policy document).
Attach this as a variable in the AI Action.
Click Publish to use this action during analysis.
7. Click Run to execute the AI Suggestion. You can run it:
Manually from the sidebar.
8. Once processed, the AI Action results are displayed in the AI Actions sidebar. Results include:
Highlighted text suggestions (e.g., red for removals, green for improvements)
Annotations that reference your attached document (e.g., “Per Contentful writing guidelines, avoid bold text for emphasis”)
Every result is temporarily stored in the entry’s history and can:
Be revisited or deleted at any time.
Be referenced as a variable in other AI Actions.