To help you get the most value from AI Configurations in the PIM, we strongly recommend following the guides below:
- AI Configuration Overview
- Creating & Managing AI Configuration
- Executing AI Configurations
- Useful AI Configurations Examples
- AI Prompt Analyzer & Rewriter (You are here!)
- AI Configuration Considerations & Limitations
- Understanding AI Behaviour & Realistic Use Cases
- AI Configuration Security & Data Privacy
Overview
The AI Prompt Optimizer and Rewriter helps you create high-quality prompts for your AI Configurations in Akeneo. It evaluates your instructions against the C.R.A.F.T.+R framework to ensure that your prompt is clear, relevant, and compatible with the selected attribute type. You can then automatically rewrite your prompt into an improved version, ready to preview or use in automation.
This feature is available within the Instruction Prompt section of each AI Configuration.
How It Works
When you click Analyze Prompt, Akeneo evaluates your prompt using the six criteria of the C.R.A.F.T.+R framework.
| Criterion | Description |
|---|---|
| Clarity | Measures how clearly your instructions are written. Looks for unambiguous goals, explicit context, and direct wording. |
| Role | Checks whether the AI’s perspective and expertise are defined. For example: “Act as an SEO expert” or “Act as a luxury fashion copywriter.” |
| Action | Determines whether the expected task or transformation is specific and achievable. |
| Format | Verifies that the expected output format is clearly defined, such as bullet points, sentences, or JSON. |
| Tone | Assesses the consistency and appropriateness of the writing style (for example, formal, friendly, professional, luxury). |
| Relevance | Ensures the prompt aligns with the selected attribute type. This prevents invalid combinations such as asking for a “paragraph description” on a Number or Boolean attribute. |
Each category receives a score between 0 and 100, and an overall score summarizes the total prompt quality.
Viewing the Results
After running the analysis, you will see:
- An overall score summarizing the quality of your prompt
- Individual scores for each of the six C.R.A.F.T.+R criteria
- Strengths that highlight what works well
- Recommendations to guide improvements
To explore these results in more depth, click Show Detailed Feedback. This expands a detailed summary that explains how each score was calculated and provides a complete evaluation of your prompt. It also includes actionable guidance on how to improve your instructions for the next iteration.
You can edit your prompt directly in the configuration and re-analyze it as many times as needed.
Rewriting a Prompt
The Rewrite Prompt option uses the Optimizer’s feedback to automatically create an improved version of your prompt.
When you click Rewrite Prompt, a before and after pop-up appears showing your original prompt on one side and the suggested improved version on the other. From this view, you can:
- Accept the new version, which replaces your existing prompt in the text area
- Keep your original version if you prefer not to apply the changes
If you accept the optimized version, it is inserted directly into the prompt field but not saved automatically. You must click Save at the top of the page to permanently store the updated configuration.
The rewritten prompt:
- Retains your original intent and structure
- Improves clarity, tone, and attribute alignment
- Uses consistent formatting for easier reuse
Once finalized, you can use Preview to test the updated prompt on sample products before automating it in the Rules Engine.
Example
Original Prompt
“Write a description of the product that sounds good and adds some SEO.”
Analysis Findings
- Low Clarity: The goal is vague
- Missing Role: No perspective defined
- Missing Format: No instruction on structure
- Low Relevance: No attributes specified for context
Optimized Prompt (Rewritten)
“Act as an SEO copywriter for e-commerce product pages. Using the product name, short description, and main features, write one engaging paragraph of up to 150 words optimized for search engines. Maintain a friendly and professional tone.”
Best Practices
- Keep prompts short, focused, and specific
- Always define the Role and Action clearly
- Include only attributes that are relevant to the target output
- Use the Preview function to test before saving or automating
- Re-analyze prompts after edits to continuously improve quality
- Expand Show Detailed Feedback to understand the reasoning behind scores and recommendations
- Accept rewritten prompts only after reviewing them to ensure they align with your tone and goals
Frequently Asked Questions
Does rewriting a prompt automatically save it?
- No. When you accept the optimized version, it replaces your old prompt in the text area but is not saved automatically. You must click Save in the AI Configuration page to confirm the change.
Can I undo a rewrite?
- You can decline the rewrite suggestion in the pop-up to keep your original prompt. If you’ve already accepted it, you can use your browser’s Undo action or restore the previous version manually.
Will optimizing a prompt affect existing automation rules?
- No. Changes take effect only after you save the configuration. Rules using the previous version will continue running until you save the updated prompt.
What should I do once I'm happy with the prompt?
- Once you have optimized and tested your prompt, proceed to the Preview section to validate the generated content and confirm that it meets your quality standards before applying it at scale through the Rules Engine, or using it in the Product Edit Form.
Continue to Example Configurations to explore ready made templates for AI enrichment and translations.