> ## Documentation Index > Fetch the complete documentation index at: https://www.getmaxim.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Prompt Optimization > Learn how to use prompt optimization in Maxim to automatically generate and test improved prompt versions. This page covers configuring optimization runs, prioritizing evaluation metrics, and reviewing performance improvements. ## When to Use Prompt Optimization * Improve prompt performance based on specific evaluation metrics * Eliminate guesswork in prompt engineering * Automatically generate better prompt versions from test data ## Optimize a prompt Open your workspace and select a completed test run associated with a prompt. Test run page showing optimization option Click the `Optimize prompt` button on the run page to open the optimization dialog. The button may be disabled if: * The test run is still running or queued * Required evaluators or models are not available Hover over the button to see the specific reasons. Select your optimization preferences: * **Evaluators to prioritize**: Choose which metrics to focus on during optimization * **Optimization iterations**: Set how many improvement cycles to run Optimization dialog with configuration options Submit your configuration to start the optimization process. The system will: * Analyze your current prompt and test results * Generate improved prompt versions using AI models * Test new versions against your dataset * Iterate based on evaluator feedback Optimization progress indicator Once complete, you'll receive: * **Side-by-side comparison** of original and optimized prompts * **Detailed reasoning** for each change made * **Performance improvements** across your chosen evaluators * **Suggestions** for accepting or modifying the optimized version Results comparison view Review the optimized prompt and choose to: * **Accept**: Creates a new prompt version and links it to your runs * **Discard**: Discard the optimized prompt and keep the original Accept optimization dialog After accepting an optimized prompt, you'll have: * **New prompt version** tailored to your success metrics * **Performance tracking** showing improvements over time in run reports You will also receive an email when your prompt optimization is complete. Optimization results