> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://www.comet.com/docs/opik/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://www.comet.com/docs/opik/_mcp/server.

# Optimization Studio

> Run prompt optimizations from the Opik UI with datasets, metrics, and visual progress tracking.

Optimization Studio helps you improve prompts without writing code. You bring a prompt, define what “good” looks like, and Opik tests variations to find a better version you can ship with confidence. Teams like it because it shortens the loop from idea to evidence: you see scores and examples, not just a hunch. If you prefer a programmatic workflow, use the [Optimize prompts](/development/optimization-runs/optimization/optimize_prompts) guide.

## Start an optimization

An optimization run is a structured way to improve a prompt. Opik takes your current prompt, tries small variations, and scores each one so you can pick the best-performing version with evidence instead of guesswork.

![Optimization Studio form showing name, prompt, algorithm, dataset, and metric configuration](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/opik.docs.buildwithfern.com/b666e3db5befc979a9b65dceb03a8a23841fbe5feaa7efde005db5ab9e725f1b/img/agent_optimization/optimization_studio_create_form.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260928%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260928T185958Z&X-Amz-Expires=604800&X-Amz-Signature=03208dfdb6815aad4dddef8d0c48ce372533105edc89889b5b4911ed117c8cad&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Configure the run

### Name the run

Give the run a descriptive name so you can find it later. A good pattern is `goal + dataset + date`, for example “Support intent v1 - Jan 2026”.

### Configure the prompt

Choose the model that will generate responses, then set the message roles (System, User, and so on). If your dataset has fields like `question` or `answer`, insert them with `{{variable}}` placeholders so each example flows into the prompt correctly. Start with the prompt you already use in production so improvements are easy to compare.

### Pick an algorithm

Choose how Opik should search for better prompts. GEPA works well for single-turn prompts and quick improvements, while HRPO is better when you need deeper analysis of why a prompt fails. If you are new, start with GEPA to get a quick baseline, then switch to HRPO if you need deeper insight. For technical details, see [Optimization algorithms](/development/optimization-runs/algorithms/overview).

### Choose a dataset

Pick an existing dataset to supply examples. Aim for diverse, real-world cases rather than edge cases only, and keep the first run small so you can iterate quickly. If you need to create or upload data first, see [Manage datasets](/evaluation/advanced/manage_datasets).

### Define a metric

Pick how Opik should score each prompt. Use Equals if the output should match exactly, or G-Eval if you want a model to grade quality. When using G-Eval, make sure the grading prompt reflects what “good” means for your task.

* **Equals**: Use when you have a single correct answer and want a strict match.
* **G-Eval**: Use when answers can vary and you want a model to score quality.

## Monitor progress

Once the run starts, Optimization Studio shows the best score so far and a progress chart for each trial.

![Optimization results page with progress chart and best prompt indicator](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/opik.docs.buildwithfern.com/df649ba9232bb8fbc7afbe36b5999fd024422ace9702e79691459960eb14130c/img/agent_optimization/optimization_studio_results.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260928%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260928T185958Z&X-Amz-Expires=604800&X-Amz-Signature=43147e2655d6562480a2f29cc860e38eb53693682e3ba3da39d782dad3426256&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Analyze results

The Trials tab is where you compare prompt variations and scores, by clicking on a specific trial you can view the individual trial items that were evaluated.

![Trials table showing prompts and scores for each optimization trial](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/opik.docs.buildwithfern.com/4e3143185c29e65a63f870b23b602fb55c181cf71e444777ce42594c06cf4505/img/agent_optimization/optimization_studio_trials.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260928%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260928T185958Z&X-Amz-Expires=604800&X-Amz-Signature=522f61cef232064d5fcda09210200aab964a88fd03a87c0e67801c6537b995a6&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Actions

You can rerun the same setup, cancel a run to change inputs, or select multiple runs to compare outcomes.

## Reuse results outside the UI

If you want to automate optimizations in code later, follow [Optimize prompts](/development/optimization-runs/optimization/optimize_prompts) and use the same dataset and metric from this run.

## Next steps

For a deeper breakdown of trials and traces, visit [Dashboard results](/development/optimization-runs/optimization/dashboard_results). If you want to automate this workflow, use [Optimize prompts](/development/optimization-runs/optimization/optimize_prompts). To fine-tune your strategy, explore [Optimization algorithms](/development/optimization-runs/algorithms/overview).