How Can We Help?

D2L Intelligent Agents

You are here:
< All Topics


Use an intelligent agent to monitor your D2L class and send an automatic email when certain conditions are met. For a quick how to overview watch this video.

Creating an Intelligent Agent

  1. Under Course Admin navigate to Communication and select Intelligent Agent
  2. Click New Agent
  3. Enter a title, description and select agent is enabled (agent will be active as soon as saved)
Intelligent Agent Create Agent
Intelligent Agent New Agent

4. Under Scheduling, select the Frequency at which the agent should be activated

5. Under “Criteria,” determine the criteria the agent looks for:

  • Under “Role in Classlist,” select whether the agent will look at All users visible in the Classlist or Users with specific roles. For example, if there is a Teaching Assistant in the class, instructors may want to limit the agent to users in the student role.
  • Select Login Activity if the agent should look for user logins within a certain time frame.
  • Select Course Activity if the agent should look for user access to the course within a certain time frame.
  • To have the agent activate when a student views or interacts with a specific item in the course, select Create in the “Release Conditions” section. Choose a condition that must be met from the “Condition Type” menu. Then, specify the actions the student must take in the “Condition Details” section. Select Create when finished.
  • If the Intelligent Agent will be automating an email but not checking for specific criteria, do not select an option under “Take Action on Activity” or create a Release Condition.

6. Under “Actions,” indicate whether the agent should take action the first time the criteria are met or every time the criteria are met.

7. Select Send an email when the criteria are satisfied if users should receive an email if their actions satisfy the criteria.

8. If an email will be sent, a Subject for the email will be required. Enter text within the “Message” field and attach files as needed. You can also add attachments as needed.

9. When finished, select Save and Close.

Replacement Strings

Replace StringGenerated Text
{InitiatingUser}The user who performs the action that meets the criteria (for use in the “To” field).
{OrgName}The name of the organization
{OrgUnitCode}The code for the course (i.e., WRD_103_103_0990)
{OrgUnitName}The name of the course
{OrgUnitId}The id for the org unit
{InitiatingUserFirstName}The first name of the initiating user
{InitiatingUserLastName}The last name of the initiating user
{InitiatingUserUserName}The username of the initiating user
{InitiatingUserOrgDefinedId}The ID number of the initiating user
{LoginPath}The address of the login path for the site
{LastCourseAccessDate}The date the initiating user last accessed the course
{LastLoginDate}The date the initiating user last logged in
Replacement Strings for D2L Emails

Sample Email

Dear {InitiatingUser},

You have not logged into {OrgUnitName} at for the last week. Please remember course participation is essential for your success! If I can be of assistance in any way please reach out ASAP.

See you in class,

Professor BrightSpace

Edit an Existing Agent

On the Intelligent Agents page select the carrot next to the name of the agent to edit the criteria.

Test an Agent with a Practice Run

This “practice run” will generate a report of students whose actions would meet the agent’s criteria. In a practice run, no emails are sent. The list that is generated indicates who would have been contacted with the given parameters of an agent, which allows instructors to test how a particular agent and settings would affect students.

  1. On the Agent list page, select the dropdown arrow next to the name of the agent.
  2. Select Practice Run.
  3. Select Run.
  4. On the confirmation page, select Done.


5 out Of 5 Stars

1 rating

5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%

Leave a Reply

Table of Contents