# Optimizer Introduction Cookbook

:::callout{intent="info"}
This example demonstrates end-to-end prompt optimization on the HotPotQA dataset using Opik Agent Optimizer. All
steps, code, and explanations are provided in the interactive Colab notebook below.
:::

:::callout{intent="note"}
This notebook powers the **Quickstart notebook** entry in the Agent Optimization navigation.
:::

## Load Example Notebook

:::callout{intent="note"}
To follow this example, simply open the Colab notebook below. You can run, modify, and experiment with the workflow
directly in your browser—no local setup required.
:::

| Platform                     | Launch Link                                                                                                                                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Colab (Preferred)** | [<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab">](https://colab.research.google.com/github/comet-ml/opik/blob/main/sdks/opik_optimizer/notebooks/OpikOptimizerIntro.ipynb) |
| **GitHub**                   | [View the notebook on GitHub](https://github.com/comet-ml/opik/blob/main/sdks/opik_optimizer/notebooks/OpikOptimizerIntro.ipynb)                                                                                    |

## What you'll learn

- How to set up Opik Agent Optimizer SDK
- How to setup Opik Cloud (Comet Account) for prompt optimization
- How to use the HotPotQA dataset for multi-hop question answering
- How to define metrics and task configs
- How to run the `FewShotBayesianOptimizer` and interpret results
- How to visualize optimization runs in the Opik UI

## Quick Start

1. Click the Colab badge above to launch the notebook.
2. Follow the step-by-step instructions in the notebook.
3. For more details, see the [Opik Agent Optimizer documentation](https://www.comet.com/development/optimization-runs/overview).

## Related pages

- [Agent Optimization](./development-optimization-runs-overview.md)
- [Optimization Studio](./development-optimization-runs-optimization-studio.md)
- [Quickstart](./development-optimization-runs-quickstart.md)
- [Optimizer Frequently Asked Questions](./development-optimization-runs-faq.md)
- [Changelog](./development-optimization-runs-changelog.md)
- [Known Issues](./development-optimization-runs-known-issues.md)
- [Optimization](./development-optimization.md)
- [Optimization Algorithms](./development-optimization-algorithms.md)
- [Cookbooks & Tutorials](./development-cookbooks-tutorials.md)
- [Advanced Topics](./development-advanced-topics.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.
