About the agent
The agent has been developed to validate your question formatting, ask for clarification if the required information is missing and generate a Brightspace-compatible CSV file for download.
Supported question types:
- Multiple choice
- Multiple select
- True/False
- Short answer
- Written response
- Matching
- Ordering
Note: Questions that contain images and unsupported question types aren't currently supported, so you'll need to create those manually in Brightspace.
This tool is currently being tested and may continue to change over time.
Before you begin
Before using the agent, we recommend you review the following instructions and formatting recommendations. They explain how to prepare your questions, what the agent can and cannot do, how to import the CSV file into Brightspace, and how to format different question types for best results.
Accessing the agent
You'll need a Microsoft 365 Copilot license to access the agent (the free Microsoft Copilot account doesn't include access). If you have a Microsoft 365 Copilot license but can't access the agent, contact us at TLC@sait.ca.
- If this is your first time using the agent, click the Add button in the Microsoft Copilot pop-up window.
- Review the supporting documentation on this page.
- Paste your questions into the agent chat window and follow the prompts to generate your CSV file.
Prepare and format your questions
Although the agent can handle some formatting inconsistencies, making sure your questions are clearly structured and easy to interpret generally yields better results and reduces the need for clarification questions.
Paste your questions into chat
Paste your questions directly into the chat window. You can submit:
- A single question
- Multiple questions
- An entire quiz or test
Review clarification questions (if needed)
If any questions are incomplete or unclear, the agent will ask follow-up questions before generating the CSV.
Examples that may require clarification:
- Missing correct answers
- Ambiguous question types
- Matching pairs that are unclear
- Ordering questions with missing order
- Multiple choice questions with only one option
- Multiple select questions with only one correct answer
The agent validates only formatting and completeness. It doesn't fact-check question content or answer keys.
Download the CSV file and import it into Brightspace
Once validation is complete, the agent will generate a downloadable .csv file. Import this file into the Brightspace Question Library or Test.
We recommend uploading to the Brightspace Question Library because it's easier to create a question pool that multiple tests can pull from.
To import to the question library and add to a test:
- In Brightspace, go to Assessments > Tests.
- Click Question Library.
- Click Go and select Section.
- Enter a section title and click Save.
- Click the name of your new section in the left-hand sidebar to open it.
- Click Import and select Upload a File.
- Drag and drop your CSV file into the file upload area.
- Wait for the “Upload Complete” message. If the CSV is invalid, the import will fail at this step.
- Click Import All.
- Go to Assessments > Tests.
- Open a Test.
- Click Add Existing and select Browse Question Library.
- Set the Source to Question Library.
- Locate the questions you want to add and select the checkbox next to each question.
- Click Import.
To import directly to a test:
- In Brightspace, go to Assessments > Tests.
- Click New Quiz.
- Click Add Existing and select Upload a File.
- Drag and drop your CSV file into the file upload area. Wait for the “Upload Complete” message. If the CSV is invalid, the import may fail at this step.
- Click Import All.
Review your imported questions
Carefully review your imported questions in Brightspace before using them in a live course. Pay particular attention to:
- Correct answers
- Question formatting and layout
- Special characters or symbols
- Overall test organization
Notes
- The agent preserves your wording as closely as possible.
- The agent won't automatically improve or rewrite your questions.
- You may need to revise or convert unsupported question types to other question types before import.
- You may need to manually adjust special formatting, symbols and emojis to ensure CSV compatibility.
- The agent doesn't currently upload or manage image files in Brightspace. You'll need to manual set up image-based questions after import.
- Very large tests may work better when submitted in smaller batches.
General formatting recommendations
The agent can handle a certain degree of inconsistent question formatting, but following these recommendations will generally yield better results and reduce the need for clarification questions.
- Keep each question and its answers grouped together.
- Place answer options on separate lines.
- Clearly indicate correct answers.
- Separate questions with blank lines, when possible.
- Keep matching and ordering questions consistently structured.
- Avoid mixing multiple question types together within the same question block.
The agent accepts a variety of formatting styles, so your questions don't have to exactly match the examples below.
Indicating correct answers
The clearest way to improve agent accuracy is to explicitly identify correct answers. Accepted answer indicators include:
- Asterisk (*)
- Answer:
- Correct Answer:
For example:
- *Ottawa
- Answer: B
- Correct Answer: Ottawa
Multiple choice questions must:
- include a question
- include at least two answer options
- include exactly one correct answer.
For example:
What is the capital of Canada?
A. Toronto
B. Vancouver
*C. Ottawa
D. Montreal
Multiple select questions must:
- include a question
- include at least two correct answers
- clearly indicate all correct answers.
For example:
Which of the following animals are mammals?
*A. Dog
*B. Whale
C. Shark
D. Eagle
True/False questions should:
- include a question/statement
- include both True and False
- clearly indicate the correct answer.
For example:
Water freezes at 0 °C.
*A. True
B. False
Short answer questions require a question and a correct answer. Exact-match words or short phrases work best for automatic grading in Brightspace.
For example:
What is the chemical symbol for gold?
Answer: Au
Written response questions:
- must include a question
- do not require a correct answer
- may optionally include a sample response or feedback.
For example:
Explain the importance of cybersecurity in healthcare
OR
Discuss the impact of climate change on agriculture.
Answer: Responses should discuss changing weather patterns, crop yields and food security.
Matching questions must:
- include a question/statement
- include at least two matching pairs
- clearly connect each pair.
For example:
Match the country to its capital.
Canada → Ottawa
France → Paris
Japan → Tokyo
Ordering questions must:
- include a question/statement
- include at least two items
- list items in the correct order.
For example:
Place the steps of the scientific method in order.
- Observation
- Hypothesis
- Experiment
Common issues
The agent may ask follow-up questions in the following situations:
- Correct answers are missing
- The question type is unclear
- Multiple Choice questions only contain one answer option
- Multiple Select questions only contain one correct answer
- Matching pairs are ambiguous
- Ordering questions are incomplete or unclear
Unsupported question types
Because of limitations with the Brightspace CSV import format, the agent does not currently support the following question types:
- Fill in the blank questions
- Arithmetic questions
- Significant figures questions
- Multi-short answer questions
- Questions containing images
You may need to revised, exclude, manually recreate or convert unsupported question types before you import them into Brightspace.
How can we help?
Every teaching context is different. Let's start with a conversation about your goals, your learners, and your ideas.
Oki, Âba wathtech, Danit'ada, Tawnshi, Hello.
SAIT is located on the traditional territories of the Niitsitapi (Blackfoot) and the people of Treaty 7 which includes the Siksika, the Piikani, the Kainai, the Tsuut’ina and the Îyârhe Nakoda of Bearspaw, Chiniki and Goodstoney.
We are situated in an area the Blackfoot tribes traditionally called Moh’kinsstis, where the Bow River meets the Elbow River. We now call it the city of Calgary, which is also home to the Métis Nation of Alberta.