> For the complete documentation index, see [llms.txt](https://docs.raga.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.raga.ai/ragaai-catalyst/prompt-playground/run-evaluations.md).

# Run Evaluations

Execute structured evaluations on prompts. Analyze model behavior and ensure reliable, consistent outputs.

RagaAI Catalyst offers a powerful evaluation feature that allows users to assess the performance and quality of their prompts. This feature enables data-driven optimization of your LLM interactions.

Refer the complete directory of [RagaAI Metrics](/ragaai-catalyst/ragaai-metric-library.md).

### **Evaluation Process:**

1. **Initiate Evaluation:**
   * Navigate to your prompt in the RagaAI Catalyst Playground.
   * Click on the "Evaluate" button to begin the evaluation process.
2. **Select Evaluation Metrics:** RagaAI Catalyst provides a comprehensive set of metrics across multiple categories:

   * Prompt: Assess the quality and effectiveness of your input prompt.
   * Response: Evaluate the generated output from the LLM.
   * Context: Analyze the relevance and quality of provided context.
   * Expected Response: Compare the generated response against predetermined criteria.
   * Expected Context: Evaluate the alignment of generated context with expectations.

   <figure><img src="https://1811327582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbIiNdp1QbG4avl7VShw%2Fuploads%2FHBBOdNe30wyOPwlJqcqb%2FScreenshot%202024-09-30%20at%206.05.17%E2%80%AFPM.png?alt=media&amp;token=d1926dd9-1698-452a-886b-8da65bdba2a7" alt=""><figcaption></figcaption></figure>
3. **Configure Metrics:**

   * Choose relevant metrics from each category based on your evaluation needs.
   * For each selected metric:&#x20;

   a. Provide a descriptive name to easily identify the metric in your results.                                              b. Perform schema mapping to align the metric with specific variables or response elements.

&#x20;        c. Select the threshold value to define the passing criteria.

<figure><img src="https://1811327582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbIiNdp1QbG4avl7VShw%2Fuploads%2FWRsr8y8UGTEiDF9s3Iec%2FScreenshot%202024-09-30%20at%206.05.42%E2%80%AFPM.png?alt=media&amp;token=942a1e9b-f996-4873-9aaa-55640850ec55" alt=""><figcaption></figcaption></figure>

1. **Execute Evaluation:**

   * After configuring your desired metrics, click "Run Evals" to initiate the evaluation process.
   * RagaAI Catalyst will apply the selected metrics to your prompt and response data.

2. **Review Results:**
   * Once the evaluation is complete, review the detailed results for each metric.
   * Analyze scores, identify strengths, and pinpoint areas for improvement in your prompt design.

### **Combined Prompt Execution and Evaluation**

RagaAI Catalyst offers a streamlined approach to iterative prompt development:

1. **Modify Variables:**
   * Experiment with different variable values in your prompt template.
2. **One-Click Execution and Evaluation:**

   * Instead of running prompts and evaluations separately, use the **" + Evals"** button.
   * This action will:&#x20;

   a. Generate a new response using the current prompt and variables.                                                      b. Automatically run all selected evaluations on the fresh output.

<figure><img src="https://1811327582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbIiNdp1QbG4avl7VShw%2Fuploads%2F5SVqjBGF1wcQjOOcfFJy%2FScreenshot%202024-09-30%20at%206.11.26%E2%80%AFPM.png?alt=media&amp;token=d11acdc2-e9ce-437d-a2b5-fa637702cce2" alt=""><figcaption></figcaption></figure>
