AI settings – teacher's guide

1 What AI Settings is

The AI Settings tool (subtitle Assistants) is in the ＋ Add tools menu, in the Settings group – with the + button you can pin it to the navigation. It opens one set of shared AI instructions for the whole app. These instructions tell the AI how tasks should be graded and what must be taken into account in grading. The same instructions are used whenever the AI grades students’ answers.

＋ Add tools→ AI Settings→ Edit AI instructions→ Write the criteria→ Save

The ＋ Add tools menu: AI Settings (Assistants) is in the Settings group next to Archives.

The instructions are one shared text (not per task). They are saved in the app and affect all AI grading. Task-specific refinements are given in the task’s own model solution (section 4).

2 Editing the instructions

Clicking the tool opens the “Edit AI instructions” window. It has a short instruction text and a text field where you write the grading instructions. The Save button puts the changes into use.

The “Edit AI instructions” window: instruction text, the Alaia training option, the editable instructions field, and Save and Cancel.

Text field – write or edit the grading instructions. Previously saved instructions are shown ready in the field.
Save gradings for Alaia training – when this option is on, a training card is saved on the school’s own server for every exam grading you submit: Alaia’s assessment and your final assessment. This helps Alaia learn to grade closer to the teachers’ line. The option is off by default.
Save – puts the changes into use; the app confirms “The AI instructions were updated successfully.”
Cancel – closes the window without saving.

Privacy: the training card does not store the student number, and the cards stay on the school’s own server. If saving a card fails, submitting the grading still works normally.

Note: the instructions cannot be empty – saving is blocked when the field is empty (“Instructions cannot be empty!”).

3 Tips for good instructions

The quality of the assessments depends directly on the instructions. The app itself emphasises these principles:

🎯 Be precise

The clearer and more detailed your instructions, the better the AI’s assessments.

⚠️ AI makes mistakes

Include precise grading criteria and as many examples as possible of how the task is graded correctly.

📈 Quality follows the instructions

Take time to write clear and comprehensive instructions – it reduces errors and improves reliability.

📝 Support with a model solution

A clear and comprehensive model solution supports the AI: it should show the correct method, the intermediate steps and the important details.

Good instructions contain concrete scoring criteria and examples. For example: “Full points for a correct answer with justification; −1 point for a missing intermediate step; accept alternative correct methods.”

4 Instructions, model solution and rubric

AI grading relies on two things: these shared instructions and the task’s own model solution. The shared instructions set the general principles; the model solution gives a task-specific basis for comparison.

Shared instructions (this view) – general grading principles for all tasks.
Model solution (in the task details) – the correct method, intermediate steps and details for that particular task.
Rubric – if you use AI grading, it is worth writing a clear scoring rubric at the end of the correct solution (e.g. what each point is awarded for). This makes the AI’s grading more precise for each task.

Remember: the AI is a tool, not the final grader. Check the points and feedback the AI gives before you send the grades – especially in borderline cases.