Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

Intelligent agents allow instructors to generate reports and communicate with students in regards to various tasks and activities completed on a Brightspace course site. Intelligent agents can track criteria such as log-in activity, course activity, and any options offered by release conditions (Learn more about Release Conditions from our Release Conditions in Brightspace documentation). While this can be helpful for keeping track of student activity in a large course, intelligent agents should not be misconstrued as a way to monitor student engagement within a course.


In this article…


Creating an Intelligent Agent

The Intelligent Agents area can be accessed by clicking Course Tools on the navbar, and selecting Intelligent Agents from the drop-down menu. From here, new Intelligent Agents can be created for the course site.

  1. Click the New Agent button.

  2. Choose a name for the agent, most likely something to do with what you will have the agent checking.

  3. Add a description and give the agent a category at your own discretion. Both are optional and used for organization purposes.

  4. Enable the agent by checking the checkbox under Status.

  5. Under Scheduling, choose whether the agent will run on a certain schedule, or have no schedule (the instructor chooses when to run it).

  6. Select the criteria required for the agent to follow. Options are explained below:

 Click here to view Critera Options

Criteria Options

Role in Classlist - Instructors can choose whether the agent checks every person in the classlist, or can specify a role for the agent to check (i.e. Every student in the class or every TA)

Take Action on Activity - This is where instructors decide what they are having the agent check and report on. The two main options are Login Activity and Course Activity.
Login Activity refers to when someone last logged into Brightspace.
Course Activity refers to when someone last went on the specific course site the agent is in.

Release Conditions - On top of login and course activity, agents can track progress in specific areas of the site by making use of release conditions. For example, agents can be paired with the No submission to folder release condition to gather a report of student who haven’t submitted to a particular assignment. To learn more about Release Conditions and their options, please see Release Conditions in Brightspace

  1. Select the Actions that the agent will take. There are options to set whether the agent records users who repeatedly meet the criteria, or whether it only tracks the first time someone meets the criteria, as well as the option to send an email to the user when the criteria is met.

CPI does not recommend allowing Intelligent Agents to send emails to users. Depending on the frequency the agent is run (as well as the number of agents being used) this could lead to far too many notifications being sent to students, discouraging them to check their emails for other important information.

  1. Click Save and Close to complete the agent.

Manually Running an Intelligent Agent

Instructors have the ability to create an intelligent agent that they can run at their own discretion as opposed to setting the agent to a particular schedule. Additionally, agents that run on a schedule can be called upon to run whenever from the Intelligent Agents area, found by clicking Course Tools on the navbar and selecting Intelligent Agents in the drop-down menu.

  1. Select the drop-down arrow next to the agent that will be run.

  2. Select Run Now, this will send a request to run the agent. It can take a few minutes for the agent to run depending on server load, connection, etc.

  3. Upon refreshing the page after a few minutes, the agent will have run and generated a report, which can be selected under the Results of Last Run column.

Viewing a History of Reports

The history of reports generated by an intelligent agent are accessible from the Intelligent Agents area, found by clicking Course Tools on the navbar and selecting Intelligent Agents in the drop-down menu.

  1. Select the drop-down arrow next to the agent.

  2. Select View History, this will open a list of all the previous times the agent has run. The reports can also be exported from the drop-down menu by clicking Export History instead.

Intelligent Agents and Engagement

While Intelligent Agents can provide helpful information to instructors for how students are interacting with the course site, this should not be misconstrued as a method of tracking user engagement with a site. For example, an intelligent agent can check to see if a user has clicked on a certain content item, but it does not know how long the student spent looking at that item, or what their takeaway from it was. Please keep this in mind when using intelligent agents. Please reach out to cpi@brocku.ca with any questions about engagement resources or to discuss with us.


  • No labels