Question Tool — Generating and Reviewing Questions

Before You Begin

This guide helps teachers use the UnaGPT Question Tool to generate AI-assisted questions, configure marking schemes, and review or refine generated questions. Each step is accompanied by a screenshot in which the numbered red markers correspond to the numbered instructions in the text.

Platform address: app.una.study
Role required: teacher
The Question Tool is currently in public beta.

Use the UnaGPT Question Tool

The Question Tool allows teachers to generate customised practice and assessment questions automatically using AI. Original questions can be created from a broad topic, or a reference question can be supplied so that tailored variants are generated from it.

Step 1Open the Question Tool

Click Question Tool in the left menu, under UnaGPT.
When the menu is collapsed, click the question mark icon.

The Question Tool page with the left menu expanded — Figure 1. The Question Tool in the left menu.

Step 2Set the basic configuration

Open the Generate tab to set the criteria and prompt the AI agents.

Student level: select the target academic level from the drop-down (Lower primary, Upper primary, Lower secondary, Upper secondary).

The Student level drop-down open — Figure 2. The Student level drop-down.

Question language: select the language of the generated questions (English, Traditional Chinese or Simplified Chinese).

The Question language drop-down open — Figure 3. The Question language drop-down.

1 — Subject and Topic: enter the subject and the specific topic.
2 — Instructions (maximum 300 words): provide specific guidance or constraints for the AI.

Step 3Include a reference question (optional)

1 — Tick Include a reference question to base the generated questions on an existing question structure. The reference question fields open below the checkbox.

The Include a reference question checkbox below the instructions field — Figure 4. The Include a reference question checkbox.

Figure 5. A completed set of basic configuration fields.

Step 4Configure the AI settings

Answer Content Type: General, Formula / Calculation, or Code.
Answer Language: English, Traditional Chinese or Simplified Chinese.
Answer Structure: Text Only, Image Only, “Text, Image”, “Image, Text”, or “Text, Image, Text”.
Output Language: the language of the AI feedback and instructions (English, Traditional Chinese or Simplified Chinese).
Answer Word Limit (optional): minimum and maximum word counts for student responses.
Analysis Options: Enable with Writing Techniques includes stylistic suggestions, examples and context analysis; Hide Correction from student keeps the AI grading feedback visible to teachers only.

The AI Settings panel — Figure 6. AI Settings, with the reference question fields open above.

Step 5Enter the question and the marking settings

Question Input:

1 — Click OCR (Markdown) to convert an uploaded image into text.
2 — Or type or paste the reference question directly into the text field.

The Question Settings panel with the OCR button — Figure 7. The Question Settings panel: OCR, or the question text field.

Under AI Marking Settings, set the following:

Full Score: the maximum obtainable score.
Marking Scheme: enter the guidelines, or click Load a Template to select a preset.
Penalty Scheme (optional): the criteria for mark deductions.
Sample Answer (optional): an ideal response, used to calibrate the AI.

The AI Marking Settings panel with the Load a Template button — Figure 8. The AI Marking Settings panel.

Selecting Load a Template opens the list of preset marking schemes.

The Load an AI Marking Setting Template dialogue — Figure 9. The preset marking scheme templates, in Chinese and English.

Step 6Generate the questions

Once the settings are complete, click Generate questions.

The Generate questions button at the foot of the form — Figure 10. The Generate questions button.

Two independent AI agents, Agent A and Agent B, process the prompt simultaneously and generate alternative question variants. Each generated result displays the complete question setup, the AI marking settings, the marking scheme and the token usage.

Generated results shown side by side in the Question Tool — Figure 11. Both agents return their results in the Generate tab, side by side.

Step 7Act on a generated question

Export Question: downloads an XML file that can be imported directly into a Teaching Session or an Activity.

Agent A and Agent B results, each with an Export Question button — Figure 12. Export Question, one button per agent result.

1 — Review this question: imports the selected question into the Review tab for further refinement.
2 — Test in Playground: opens the question in the UnaGPT Playground to test AI grading performance and student response handling.

The Review this question and Test in Playground buttons under each result — Figure 13. Review this question and Test in Playground, below each result.

Review and Amend Questions

Open the Review tab to evaluate, test and refine a question independently, with AI assistance.

Note: a review session expires 14 days after it is created. After expiry the previous review history can still be viewed, but follow-up questions and amendments are disabled.

Step 8Start a review

Input the question: enter or paste a question manually, or click Import Question to load a saved question or one sent from the Generate tab.
Configure the settings: set the AI Settings and the Question Settings, including the answer content type, the marking schemes and the analysis options.

The Review tab with the Import Question button — Figure 14. The Review tab carries the same settings as the Generate tab.

Click Review question, at the foot of the form.

The Review question button at the foot of the form — Figure 15. Review question sits at the foot of the form.

Step 9Follow up with the agents

Agent evaluation: Agent A and Agent B review the question independently, providing general comments, constructive feedback and structural suggestions.
Follow-up questions: type follow-up instructions of up to 300 words in the box.
1 — Choose the recipient: both agents, Agent A only, or Agent B only.
2 — Click Send.

Agent review comments with the follow-up question box below — Figure 16. The follow-up question box, with the recipient selector and Send.

Up to eight follow-up messages can be exchanged with each agent during a review session.

Step 10Finalise and amend the question

Before the final amended version is generated, each agent analyses the entire discussion history, including all follow-up exchanges and the comments made by both agents.

Enter the final guidelines in the Optional amendment instructions box (maximum 300 words).
Click Amend question. This concludes the current review session.

Figure 17. The amendment instructions box and the Amend question button.

The agents produce the amended questions, with the option to start a new review or to test the question directly in the Playground.

The amended questions produced by both agents — Figure 18. The amended question from each agent, with the marking scheme rebuilt.