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.

  1. If this is your first time using the agent, click the Add button in the Microsoft Copilot pop-up window.
  2. Review the supporting documentation on this page.
  3. Paste your questions into the agent chat window and follow the prompts to generate your CSV file.

Launch the agent

1

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. 

2

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 
3

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. 

4

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:

  1. In Brightspace, go to Assessments > Tests.
  2. Click Question Library.
  3. Click Go and select Section.
  4. Enter a section title and click Save.
  5. Click the name of your new section in the left-hand sidebar to open it. 
  6. Click Import and select Upload a File. 
  7. Drag and drop your CSV file into the file upload area. 
  8. Wait for the “Upload Complete” message. If the CSV is invalid, the import will fail at this step.  
  9. Click Import All.
  10. Go to Assessments > Tests.  
  11. Open a Test.
  12. Click Add Existing and select Browse Question Library. 
  13. Set the Source to Question Library.
  14. Locate the questions you want to add and select the checkbox next to each question.
  15. Click Import.

To import directly to a test:

  1. In Brightspace, go to Assessments > Tests. 
  2. Click New Quiz.
  3. Click Add Existing and select Upload a File.
  4. 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.
  5. Click Import All.
5

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.

  1. Observation
  2. Hypothesis
  3. 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.

Teaching and Learning Commons

NN504, Senator Burns Building, SAIT Main Campus

Email
tlc@sait.ca
a view of the moutains and stream in between

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.