> For the complete documentation index, see [llms.txt](https://docs.radar.citadel-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.radar.citadel-ai.com/en/application-owner-guide/evaluation-library/custom-metrics.md).

# Create Custom Metrics

Custom Metrics are Evaluation Metrics that can be created to match company-specific evaluation criteria, guidelines, rules, and similar requirements.

AI applications have different risks to consider depending on their purpose of use, business workflow, data handled, and how output results are used. Therefore, in addition to Built-In Metrics based on common risk domains, it is important to define evaluation criteria according to the application's characteristics and use case.

By creating Custom Metrics, you can continuously evaluate the inputs and outputs of an AI application with criteria aligned with your company's business and operational rules.

### How-to create a Custom Metric

#### 1. Select Add metric

Select `Add metric` from `Evaluation Library` in the sidebar.

#### 2. Select a creation method

Custom Metrics can be created using one of the following methods.

<table><thead><tr><th width="205.13671875">Creation method</th><th>Use case</th></tr></thead><tbody><tr><td>Add a new Evaluation Category</td><td>When creating an Evaluation Metric for a new risk domain</td></tr><tr><td>Select an existing Evaluation Category</td><td>When adding new evaluation criteria or a target metric to an existing evaluation category</td></tr></tbody></table>

When adding to an existing Evaluation Category, metrics created in the past are not overwritten and are managed as versions.

{% hint style="info" %}
For the relationship between Evaluation Categories and Evaluation Metrics, see [Manage the Evaluation Library](/en/application-owner-guide/evaluation-library.md).
{% endhint %}

**When adding a new Evaluation Category**

Create a new Evaluation Category and the Evaluation Metric linked to that category.

<table><thead><tr><th width="133.328125">Setting</th><th>Overview</th></tr></thead><tbody><tr><td>Evaluation Category</td><td>Enter the Evaluation Category name. As the category represents a risk or threat domain, set a name that clearly describes the risk or threat you wish to monitor.</td></tr><tr><td>Description</td><td>Enter the Evaluation Category description. This does not affect the evaluation criteria.</td></tr><tr><td>Target</td><td>For the evaluation target, select either <code>Input (prompt/user text)</code> or <code>Output (model response)</code>.</td></tr><tr><td>Evaluation criteria</td><td>Use natural language to describe the conditions that trigger the evaluation metric.</td></tr></tbody></table>

<figure><img src="/files/eIKPlTpbO0QnxC6wzoSm" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
When writing the evaluation criteria, refer to the definitions of existing built-in metrics.

Using `AI Autofill` can automatically generate the Evaluation criteria based on the category name and description. Review and revise the generated content as needed.

Evaluation results tend to be more stable when the evaluation criteria specifically describe the conditions that should be detected and the conditions that should be excluded.
{% endhint %}

Check the entered details, then click `Save` if there are no issues.

**When selecting an existing Evaluation Category**

Create a new evaluation metric linked to an existing evaluation category.

<table><thead><tr><th width="133.328125">Setting</th><th>Overview</th></tr></thead><tbody><tr><td>Evaluation category</td><td>Select the existing Evaluation Category to which the metric will be added.</td></tr><tr><td>Target</td><td>For the evaluation target, select either <code>Input (prompt/user text)</code> or <code>Output (model response)</code>.<br><br>If a metric already exists in the selected category, a new version will be created. Otherwise, a completely new metric will be created.</td></tr><tr><td>Current latest evaluation criteria</td><td>If a metric already exists, the current evaluation criteria are displayed.</td></tr><tr><td>Evaluation criteria</td><td>Use natural language to describe the conditions that trigger the evaluation metric.</td></tr></tbody></table>

<figure><img src="/files/510XxY7S9C4Ew9rQApQ9" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
When writing the evaluation criteria, refer to the definitions of existing Built-In Metrics.

Using `AI Autofill` can automatically generate the Evaluation criteria based on the category name and description. Review and revise the generated content as needed.

Evaluation results tend to be more stable when the evaluation criteria specifically describe the conditions that should be detected and the conditions that should be excluded.
{% endhint %}

Check the entered details, then click `Save` if there are no issues.

#### 3. Review the created custom Evaluation Category and Metrics

You can review the created custom Evaluation Categories and Metrics using the same procedure as [Review Built-In Metrics](/en/application-owner-guide/evaluation-library/built-in-metrics.md).

Custom made Evaluation Categories and Metrics havve a `Custom` badge.
