> 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.

# Development Overview

Opik provides a complete workflow for developing your agent: manage your prompt and model configuration with version control, test changes in the Agent Playground with full tracing, and deploy new versions directly from the UI.

## Manage your prompts and agent configuration

Define your agent's system prompt, model, and parameters in the [Prompt Library](/development/prompt-library/overview). Every change is versioned automatically (`v1`, `v2`, `v3`, …), so you can compare configurations side-by-side and roll back if needed.

![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/opik.docs.buildwithfern.com/c8de88ac5fdc9c61f9251dbcd4ec4d5c4b7c88d3f2cb82ec7610bc8c7b396747/img/v2/development/agent_configuration.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260923%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260923T082011Z&X-Amz-Expires=604800&X-Amz-Signature=d906dfcc143f72f9e79e4568f37579ab9081d13558699ef2580d4a6bd09cb3f3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Your agent pulls the requested prompt version at runtime, so you can update prompts without redeploying code.

## Test in the Agent Playground

Connect your local agent to Opik with a single command:

```bash
opik endpoint --project <project-name> -- python3 my_agent.py
```

Then run your agent from the Opik UI. Enter inputs, hit **Run**, and see the full result with traces — every LLM call, tool invocation, and sub-step captured in real time.

![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/opik.docs.buildwithfern.com/9560efa4f4ff14b3f397a13b51506252fd9977d6a01a76b88b8cdfb55ac613e6/img/v2/development/agent_sandbox.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260923%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260923T082011Z&X-Amz-Expires=604800&X-Amz-Signature=41a2878ab2404bc82815c923059d2f4794a5fdd3e9836c3ac17a6ab7955db9f5&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Switch to the **Configuration** tab to tweak prompts and parameters without changing code. The playground runs your agent against the unsaved configuration so you can test before committing changes.

## Roll out new versions

When you're happy with a configuration, save it as a new version in the Prompt Library and
update your code to pin to it (or keep it on `"latest"`). Every change is versioned, so you can
always roll back.

## More tools

#### [Prompt Playground](/development/prompt-playground)

Test and compare prompt variants side-by-side across models. Run against datasets for systematic evaluation.

#### [Optimization Runs](/development/optimization-runs/overview)

Automatically optimize prompts and agent configurations using built-in optimization algorithms.