You are now in the main content area

On Sunday, November 14, a new version of the Self Service tools used to request and manage Brightspace shells was introduced!

Learn more about the changes on the What's New page.

Use Intelligent Agents to send targeted email

The Intelligent Agents tool allows Instructors to set up automatic notifications to be sent to themselves, advisors, and students when specified course performance criteria are met.

It can be used to both recognize student achievement (e.g., a high score on a quiz) and warn of potential problems (e.g., lack of online activity or poor performance on an exam).

An Intelligent Agent will send an email for each user that matches the criteria you have outlined. If 50 students match, this will result in 50 separate emails.

If Intelligent Agents are copied from one shell to another, they are automatically disabled to prevent unwanted emails from being sent.

Scheduled intelligent agents run at approximately 4:00 PM (Canada - Toronto), and will only run if the shell is active, and the agent is enabled.

Find the Intelligent Agents in the Course Admin section of your shell.

 Create an Intelligent Agent

Before you begin, you will need to consider what criteria you will need to create your recipient list.

  • Who do you want to email?
  • What is the purpose of the email?

If it is based on their achievement in a grade, make sure you have a grade item that is appropriate for that purpose, and decide what the threshold will be for a student to receive the email (for example, send an email if a student receives 80% or higher on the Midterm Exam).

Since Intelligent Agents can make use of Release Conditions, your list of possible criteria is fairly broad.

Here are a few examples of when you might want to run an Intelligent Agent:

  • When a student has been added to your shell, send them a "Welcome" email that spells out expectations, how to get started, etc.
  • If you have concerns about students not submitting an assignment on time, you could set an intelligent agent that checks several days before the due date, and sends a reminder email to any students who have not submitted yet.
  • You could set an intelligent agent that sends you, the instructor, an email when students have earned an award, achieved a particular grade or viewed (or not viewed) a particular piece of content.
  1. Button to create a new Intelligent Agent

    You will find the Intelligent Agents tool by going to the Course Admin of your course shell, in the "Communication" section of the page.

    • Start a new Intelligent Agent by clicking the "New" button at the top of the page.
  2. Create a new Intelligent Agent

    Give the new agent a name. Only the teaching team (instructors, TAs, etc.) see the name of an Intelligent Agent - so make sure it's meaningful to you.

    Similarly, add a description that tells you what the agent does.

    For now, do not check the box to enable the agent yet. This will be done after everything has been set up and tested.

    Proceed to set the criteria that controls whether an email is sent out.

Next, you will need to set the criteria that is used to determine whether an email is sent out.

There are three types of criteria that can be applied, either individually, or in combination:

  • User roles
  • User activity
  • Release conditions

Each of these criteria serve to narrow the list of people who will receive the Intelligent Agent email.

Set Intelligent Agent criteria based on user role

Roles

Determine which users (by role) will need to match the criteria - in most cases, this will be your learners ("Student" and "Auditing Participant" in official courses, possibly "Attendee" in certain types of professional development courses).

If you aren't sure which roles apply to the people in your course, check your Classlist!

Any further criteria set will only apply to those with the role(s) you have selected here.

Set Intelligent Agent criteria based on login activity

User Activity

Identify people who have or have not been interacting with Brightspace or with your course.

  • Login activity - refers to general access to Brightspace (but not necessarily your course shell).
  • Course activity - refers specifically to access of this course shell

You can identify users who have or have not interacted within the last x number of days.

*Be sure to check the box for the type of activity to apply to this Intelligent Agent, then enter the number of days into the appropriate field.

Set a Release Condition criteria on an Intelligent Agent

Release Conditions

This is where things can get very interesting, but a little bit more complicated.

Release conditions are criteria based on specific areas of your Brightspace shell, including:

  • membership in a section or group
  • grades in the gradebook
  • submissions to quizzes and assignments
  • completion of checklists

... and much more!

For example, you can send an email to students who achieved over 80% on the midterm grade, or to students who have not yet submitted their final assignment.

Click "Save", at the bottom of the page, to save your changes as you go!

Determine whether this Intelligent Agent will repeat

Repetition

Do you want to trigger an email every time someone matches the criteria - or only the first time? 

Keep in mind that this doesn't relate to how often a student completes a task listed in the criteria, but how often they will match the criteria.

Here are some tips to ensure you don't spam your students with emails...

Opt to take action "only the first time" for criteria that will not change over time:

  • students who are enrolled in this shell
  • students who are members of section 011
  • students who got over 80% on their midterm
  • students who contributed to a specific class discussion
  • students who achieved a specific award

Think of these emails as a one-time recognition of the completion of a task or achievement of a grade or award. As these things will continue to match each time, you don't want to spam your class with emails every time the agent runs.

Opt to take action "every time" for criteria that may change as the person engages with the course shell:

  • students who haven't been in the course shell in over 2 weeks
  • students who haven't submitted to an assignment
  • students who haven't contributed to a discussion

Think of these emails as reminders and resources that are provided until those tasks are completed.

Special recipient variables in Intelligent Agents

Who will receive this email?

How do I email the students who match the criteria?

There is a special variable that you can include as a recipient that will email the specific user who matched the criteria (usually the student).

Add {InitiatingUser} to the TO, CC or BCC field.

To vs Cc or Bcc

Use the TO field to include the address of the main recipient of the email. If the email content is directed to the student, use the TO field for their email address. If you will also include yourself (the instructor) or your teaching team, you can add these email addresses into the BCC field.

If the email content is directed to you or the teaching team, feel free to put these addresses into the TO field.

We do not recommend using Intelligent Agents to send emails to those outside of the teaching team.

Bcc is used to send the email to someone without having their email address visible to the other recipients. 

Who is the "sender" of the email?

By default, the sender of the emails is "D2L@Ryerson.desire2learn.com" - this is both the email address and the display name of the sender.

You (the instructor) can change the display name of the sender as well as the reply-to address (see the "Settings" area of the Intelligent Agents tool for options).

Note that you cannot change the actual email address that the email comes from.

Craft the Intelligent Agent email

Crafting the email

Like in a regular email, the subject and message body need to be clear and concise.

What needs to be in the subject to ensure the recipient understands what it is for, and opens it?

What do you want to communicate in the message body, relating to the criteria that triggered this email in the first place? Are you providing some resources, some encouragement and acknowledgement?

Are you asking the user to perform a task?

"Replacement strings" to add dynamic content

As you craft the subject and body of the email, there are a few useful variables that you can include to dynamically include certain information.

  • {InitiatingUserFirstName} - The first name of the initiating user. (i.e. a student who has met the criteria you outline in the agent)
  • {InitiatingUserLastName} - The last name of the initiating user. (i.e. a student who has met the criteria you outline in the agent)
  • {OrgUnitCode} - The code for the course shell (i.e. abc123_f21_01).
  • {OrgUnitName} - The name of the course shell. (i.e. ABC123 - Intro to Bending Objects with your Mind - Fall 2021)
  • {LastCourseAccessDate} - The date the initiating user last accessed the course
  • {LastLoginDate} - The date the initiating user last logged in.
Tips for using the replacement strings
  • Use {InitiatingUserFirstName} to address the email - it makes the email feel more personal and friendly.
  • Start the subject line with "{OrgUnitCode}: " - this matches the way Brightspace sends emails from your course shell, and will work with any email filters you (or your class) have set up.
  • Use {OrgUnitName} in the email instead of typing the name of the course - that way, you can copy this agent to different shells and you won't have to edit the course name for each course!
  • If you are sending an email when someone hasn't visited the course in a certain number of days, you can include {LastCourseAccessDate} in the message body to indicate the actual date they last accessed the course shell.
Attach a file to an Intelligent Agent

Attachments

You can attach files to emails sent by Intelligent Agents.

  • "Upload" to select a file from your computer
  • "Choose Existing" to select a file from your shell's "Course Offering Files".
  • "Record" to record a video or audio clip to be included in the email.

Click "Save", at the bottom of the page, to save your changes as you go!

How to create an Intelligent Agent

Scheduling

Intelligent Agents can be run manually, or they can be scheduled to run automatically.

If you want the Intelligent Agent to run automatically, you will need to set a schedule.

  • Click "Use Schedule"
  • Click "Update Schedule" to select the schedule you want to apply.
  • Options: 
    • Repeats: Daily, Weekly, Monthly, Annually
    • Once you select the type of repeat, you will be offered additional setting options
    • Schedule dates: The schedule will only run between these days, allowing you to focus the Intelligent Agent on certain times of year (i.e. if it should run weekly between September 1 and October 1)

*Note that Intelligent Agents will only run on schedule if the shell is active AND the agent has been enabled.

Scheduled intelligent agents run at approximately 4:00 PM (Canada - Toronto), and will only run if the shell is active, and the agent is enabled.

Enable & run Intelligent Agent

Run an Intelligent Agent manually

This is a great option if you don't want the agent to run automatically, and you just want to run it as needed.

  • Click the arrow iconn to the right of the name of the agent you want to run.
  • From the dropdown menu, select "Run Now" and follow the on-screen prompts to complete the process.

You will receive a confirmation email once the agent has run, letting you know that the agent has completed.

If you are the recipient of the resulting emails, you will receive an email for each user that matches the criteria.

Enable & run Intelligent Agent

Do a "practice run" to test your results!

Before you enable the agent, and start sending real emails, you should complete a practice run so you can see a list of the users that match the criteria.

  • Click the arrow iconn to the right of the name of the agent you want to run.
  • From the dropdown menu, select "Practice Run" and follow the on-screen prompts to complete the process.

You will receive a confirmation email once the agent has run, letting you know that the agent has completed.

Once it has completed, come back to the agent list and click on the link in the "Results of last run" column. This will show you a list of the users that matched the criteria at the time of the last run.

Enable & run Intelligent Agent

Enable the agent when ready

Now that you've completed a practice run, you can enable the agent if you are ready to have it run on the schedule you set.

  • Click the arrow icon to the right of the name of the agent you want to run.
  • From the dropdown menu, select "Edit". 
  • On the edit screen, check the "Agent is enabled" box
  • Click "Save and Close" at the bottom of the screen.

Once enabled, you will see the scheduled "Next Run Date" in the agent list.

Note that Intelligent Agents will not run on schedule unless your course shell is "Active" and the agent is "enabled".

Video tutorials 