# Scoring

Scoring is a step interaction in Colibri that allows participants to be scored when answering questions in a self-paced exercise. This helps to reinforce correct behaviour in participants through consequence.

There are three different options when it comes to scoring:

| Scoring option                         | Description                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------ |
| Set                                    | Set the participant's total score                                              |
| Increment (this is the default option) | Add an amount to the participant's accumulative score over an exercise.        |
| Decrement                              | Subtract an amount from the participant's accumulative score over an exercise. |

## How to

You can configure scoring in the Editor via the `Interactions` tab in a step:

<figure><img src="/files/fhqvTSEM7jwjZvSnxp0K" alt=""><figcaption></figcaption></figure>

### 1. Set

| Description                      | Use                                                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Set the participants total score | <p>At the beginning of an exercise or if you want to reset the participant's score. Set the score to 0 (assuming the score should start at 0)</p><p></p><p>You might also want to award a specific value at any time and branch on this later</p> |

<div align="left"><figure><img src="/files/mSbKGhDDPUD7y9dhB5nA" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
If you are using the `Set` option to reset the participant's score, pair it with the `Erase all` action to delete all previous messages and, effectively, reset the exercise.
{% endhint %}

### 2. Increment

{% hint style="warning" %}
This is the default option because it's the most likely scoring option you'll want to use.
{% endhint %}

| Description                                                                                                                   | Use                                                                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Add an amount to the participant's accumulative score over an exercise</p><p></p><p>If set to 0, nothing will be added</p> | When using questions, configure all incorrect answers' scoring value to 0, but the correct answer's scoring value to 1 (or more if you like) |

<div align="left"><figure><img src="/files/NhvBfvBnKNO0YbXx9do3" alt="" width="301"><figcaption></figcaption></figure></div>

### 3. Decrement

<table><thead><tr><th>Description</th><th>Use</th><th data-hidden></th></tr></thead><tbody><tr><td><p>Subtract an amount from the participant's accumulative score over an exercise</p><p></p><p>If set to 0, nothing will be subtracted</p></td><td>If you'd like to take points away from a participant for getting a question wrong</td><td></td></tr></tbody></table>

<div align="left"><figure><img src="/files/uQotYvkFJWt1wDyQWtPQ" alt="" width="301"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdocs.conducttr.com/colibri/building-exercises/scoring.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.