Feedback Aide lets you customize the feedback comment it generates for responses evaluated with a short response rubric type, so the comment matches your teaching style and classroom context. You control three aspects of the comment: whether it reveals the correct answer, whose point of view it is written from, and any extra instructions you want it to follow.
| Control | Option | Values | What it changes |
|---|---|---|---|
| Cueing | feedback.cueing |
reveal, guiding
|
Whether the comment states the missing or correct answer |
| Point of view | feedback.point_of_view |
second_person, third_person, passive
|
Who the comment addresses or describes |
| Feedback guidance | feedback.guidance_text |
Free text | What the comment focuses on, plus any other instructions |
These controls change only the wording of the feedback comment. They do not change the score Feedback Aide awards.
Cueing
Cueing controls whether the feedback comment tells the learner what their response is missing. Set feedback.cueing to one of the following values.
-
reveal: the comment names the missing or correct content directly. Use this when learners need the answer to move on, for example in revision or review activities. -
guiding: the comment points out where the learner went wrong, but does not expose the missing answer. Instead, it prompts the learner to work it out. Use this for formative practice where you want learners to try again.
For example, a learner is asked to name the four components of blood and answers "red blood cells and white blood cells".
| Value | Example feedback comment |
|---|---|
reveal |
You correctly identified red and white blood cells. You also needed plasma, which carries dissolved substances, and platelets, which help blood clot. |
guiding |
You've covered the cells that carry oxygen and fight infection. What do those cells travel in? And what helps you stop bleeding when you cut yourself? |
With guiding, the comment does not mention plasma or platelets, even though Feedback Aide knows they are missing.
Point of view
Point of view sets the grammatical voice of the feedback comment. It changes how the comment is phrased, not what it says. Set feedback.point_of_view to one of the following values.
| Value | Writes the comment… | Example feedback comment |
|---|---|---|
second_person |
To the learner, using "you" | You correctly identified red and white blood cells, but you left out plasma and platelets. |
third_person |
About the learner, using "the learner" | The learner correctly identified red and white blood cells, but left out plasma and platelets. |
passive |
Without referring to a person | Red and white blood cells are correctly identified, but plasma and platelets are missing. |
Use second_person when learners read the feedback directly. Use third_person when the feedback is mainly for teachers or graders. Use passive when you want a neutral, impersonal tone.
Feedback guidance
Feedback guidance is a free-text field for your own instructions about the feedback comment. Use feedback.guidance_text to tell Feedback Aide what to focus on, or how to write the comment, in plain language.
Examples of feedback guidance:
- Focus on the use of correct scientific vocabulary.
- Keep the comment to two sentences or fewer.
- Remind the learner to include units of measurement.
- Use simple language suitable for learners aged 10 to 12.
Write each instruction clearly and keep it specific to the feedback comment. Feedback guidance shapes the comment only; it does not change how the response is scored. To change scoring, edit the rubric or grading options instead.
How the controls work together
You can use any combination of the three controls. When feedback guidance conflicts with cueing or point of view, the structured setting takes priority and Feedback Aide ignores the conflicting part of the guidance.
| Structured setting | Conflicting feedback guidance | Result |
|---|---|---|
cueing: guiding
|
Always give the learner the correct answer. | The comment does not reveal the missing answer. |
point_of_view: third_person
|
Speak directly to the student as "you". | The comment refers to "the learner". |
Instructions in the guidance that don't conflict still apply. For example, with guiding and the guidance "Focus on scientific vocabulary", the comment both withholds the answer and focuses on vocabulary.
Effect on the score
None of these settings affect the score. Feedback Aide grades the response in the same way regardless of cueing, point of view or feedback guidance; only the wording of the feedback comment changes.
Configuring feedback customization
Set the controls in the feedback object of the Feedback Aide evaluation options, through the JavaScript API.