# Criteria

## Overview

The **Criteria** taxonomy page is where you manage all Criterion records in Birdie Settings.

Criteria are one of the core taxonomy types in Birdie. They define the rules used to evaluate service quality in QA workflows.

This page centralizes the operational work of managing Criteria as taxonomy items. Use it to review your catalog, create new Criteria, edit existing ones, and organize them into collections.

If you want the QA model behind Criteria, see [Criteria](https://ask.birdie.ai/agent-quality-assurance/criteria) and [Manual Evaluation](https://ask.birdie.ai/agent-quality-assurance/manual-evaluation).\ <br>

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FiUj8LVSjDHyqqofonBsO%2Fimage.png?alt=media&#x26;token=d607d83b-790d-438a-8955-7a4ceed30023" alt="" width="563"><figcaption></figcaption></figure>

## Viewing and filtering

The main tab shows the full criteria catalog as a list.

Each row can include:

* **Criterion**
* **Criterion level**
* **Weight**
* **Critical** status

Use the controls at the top of the page to narrow the list:

* **Search** — find criteria by name
* **Select area** — show criteria related to one Area
* **Level** — filter by **General** or **Specific**
* **Group by collection** — switch between collection grouping and reason grouping

Click any criterion to open its details.

## Creating New Data

Click **New criterion** to create a new Criterion.

When creating a new Criterion:

1. Define the rule being evaluated.
2. Give it a clear and objective name and description to calibrate.<br>

   <figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FP0lOZmidDX34upjpC32R%2Fimage.png?alt=media&#x26;token=7a97c02c-0adf-46c4-b26d-3d49cabd83d9" alt="" width="375"><figcaption></figcaption></figure>
3. Calibrate the pending criterion.<br>

   <figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FyNzRE4QzJYY0BkdkDBH0%2Fimage.png?alt=media&#x26;token=a35fa21c-07db-48d1-a5fd-0574ab4f1eba" alt="" width="563"><figcaption></figcaption></figure>
4. Save it to add it to the catalog.

Use names that describe observable agent behavior.

## Modifying Existing Data

{% stepper %}
{% step %}

### Open the more menu

Click the **⋮** menu on the criterion you want to update.

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FvNN2FAvLC0FTJtZm0asT%2Fss_criteria_more-menu-dropdown_v1.png?alt=media&#x26;token=ff7a3b39-c57c-41d8-94fc-5cb3dd364cf9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Edit the criterion

Select **Edit**.

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FVv0kd3OwHiebpizsrbfw%2Fss_criteria_edit-modal_v1.png?alt=media&#x26;token=0b992c54-7108-456a-aa7f-0d7694e41dee" alt=""><figcaption></figcaption></figure>

Review these fields before saving:

* **Criteria name**
* **Critical?**
* **Manual?**
* **Collection**
* **Weight**
* **Reason**
* **Fields**
* **Description**
  {% endstep %}

{% step %}

### Save the changes

Save the criterion to apply the update.

{% hint style="warning" %}
Changing **Weight** or **Critical** affects the Quality Score everywhere this criterion is used.
{% endhint %}
{% endstep %}
{% endstepper %}

## Removing Data

{% stepper %}
{% step %}

### Open the more menu

Click the **⋮** menu on the criterion.

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FvNN2FAvLC0FTJtZm0asT%2Fss_criteria_more-menu-dropdown_v1.png?alt=media&#x26;token=ff7a3b39-c57c-41d8-94fc-5cb3dd364cf9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select delete

Choose **Delete**.

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FalLz09DBCQaLexLtfGQd%2Fss_criteria_delete-prompt_v1.png?alt=media&#x26;token=988f6eb2-d126-4b70-8571-6a261e71ae37" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirm removal

Confirm the action to delete the record.
{% endstep %}
{% endstepper %}

## Collections Tab

The second tab groups Criteria by **Criteria collection**.<br>

This view helps teams organize Criteria by theme, process, behavior, or quality framework.

Use collections when you need to:

* keep criteria grouped by topic
* simplify QA administration
* make workspace organization easier

### Managing collections

Use collections to group related criteria under the same operational theme.

#### Create a collection

1. Click **+ Add collection**
2. Enter the collection name
3. Confirm with the check icon

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FdaMs2gZowL2zhwPGDmQB%2Fss_criteria_add-collection-edit_v1.png?alt=media&#x26;token=d120abc7-0372-42d2-8f0b-371396d0f180" alt=""><figcaption></figcaption></figure>

#### Rename a collection

1. Hover over the collection
2. Click the pencil icon
3. Save the new name

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FRyHxafdyqboACZAD8T6Z%2Fss_criteria_add-collection-hover_v1.png?alt=media&#x26;token=c9cf9402-5a3c-4ff0-b133-be85f5b62900" alt=""><figcaption></figcaption></figure>

#### Delete a collection

1. Hover over the collection
2. Click the trash icon
3. Confirm the removal

<figure><img src="https://2659701720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN7EEIMhL4xEKWM6BDyEL%2Fuploads%2FRyHxafdyqboACZAD8T6Z%2Fss_criteria_add-collection-hover_v1.png?alt=media&#x26;token=c9cf9402-5a3c-4ff0-b133-be85f5b62900" alt=""><figcaption></figcaption></figure>

## Manual criteria and scoring

* Mark **Manual?** when a criterion must be reviewed by a person
* Manual criteria appear in [Manual Evaluation](https://ask.birdie.ai/agent-quality-assurance/manual-evaluation) when they are linked to a Reason
* **Weight** contributes to the Quality Score at Workspace, Area, Reason, and Agent levels
* **Critical** criteria do not use weight and fail the interaction when not met

## Pending criteria

If you see the alert **You have Criteria that need your attention**, open the pending list to review or finish calibration before the criteria can be used normally.

## Best Practices

* Write Criteria as objective evaluation rules.
* Keep one rule per Criterion.
* Avoid ambiguous or subjective names.
* Group related Criteria into collections for easier maintenance.

## Related Articles

* [Taxonomy](https://ask.birdie.ai/admin-and-settings/taxonomy)
* [Criteria](https://ask.birdie.ai/agent-quality-assurance/criteria)
* [Manual Evaluation](https://ask.birdie.ai/agent-quality-assurance/manual-evaluation)
* [Reasons](https://ask.birdie.ai/agent-quality-assurance/reasons)
