How to Access Intelligent Agents

1. Click Edit Course in the navbar.
2. 2.Under Communication, click Intelligent Agents

In This Guide

Creating Intelligent Agents
Running an Intelligent Agent Manually
Replace Strings for Intelligent Agents Emails

D2L Upcoming Webinars

• Intelligent Agents 101 – Making Your First Intelligent Agent – February 25, 2020
• Intelligent Agents 201 – Effective Practices and Lessons Learned – March 3, 2020

Create an Intelligent Agent

1. Select Edit Course.
2. Select Course Administration
3. Select Intelligent Agents. 
4. The Agent List page will open.
5. Select New.
6. Enter an agent name (required) and description (optional).
7. Select Agent is Enabled if the agent is to be active as soon as created. This setting only applies if the agent  is set to run automatically on a schedule.
8. Determine the criteria the agent looks for, for example:
   • To have the agent to send an email to a student who has not accessed the course recently, select Take action when the following course activity criteria are satisfied, and enter a number in the User has not accessed the course for at least [#] days field.
   • To have the agent to send an email when a student views or interacts with a specific item in the course, click Create and Attach in the Release Conditions section. Choose a condition that must be met from the options on the Condition Type menu, and then specify the actions the student must take in the Condition Details section. Click Create when done selecting release conditions.
   • Select one of the “Action Repetition” radio buttons to set whether the agent sends email once or any time the conditions are met.

NOTE: You can now add attachments to automated email messages when creating and editing intelligent agents. The intelligent agent email template contains an Attachments area that enables you to upload local files, select from available course files, or record audio. Attachment size is based on the email attachment size setting for your organization.

Scheduling an Agent to run automatically

1. For an agent to run automatically, check the Use Schedule checkbox.
2. Select Update Schedule.
3. The Update Agent Schedule window will open.
4. Set the frequency and dates in the fields provided.
5. Select Update
6. Enter the replace string in the “To” field of the automated email to be sent. (Options listed below.) 
7. Enter a subject and message for the email sent by the Intelligent Agent. Special replace strings can be used in these fields as well.
8. Select Save and Close.

NOTE: Intelligent Agents will be disabled once the course is inactive.

Editing an Agent

1. On the Agent List page, select the name of the agent you want to edit.
2. Enter any changes you want to make.
3. Select Save.

Testing Your Agent with a Practice Run

This “practice run” will generate a report of what students would have been caught by the agent. 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’s settings would impact 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.

Running an Intelligent Agent Manually

If your agent is not set up to run on a schedule, it will need to be run manually.

1. Select the dropdown arrow next to an agent’s name on the Agent List page.
2. Select Run Now.
3. A confirmation dialog box will open, select Run.

Intelligent Agent Settings

By default, intelligent agent emails come from “System – No Reply” and the reply-to email is “system_noreply@brightspace.com”. It is recommended that you change this email address to an email that is monitored by a person

1. On the Agent List page, select Settings.
2. Check “Set custom values for this course”.
3. Enter the name the email should appear to be from. For example, “Professor Smith”.
4. Enter the reply-to email address that students should reply to. For example, “youremail@delta.edu”.
5. Select Save.

Replace Strings for Intelligent Agents

Replace strings are specially formatted codes that can be entered into automated emails; they replace the need to enter information that might change from student-to-student. For example, to send a personalized message to each student in a class of 60, use the replace string {InitiatingUserFirstName}, and the names of the students will be filled in automatically.

See the table below for all of the replace string options and the text they generate. In the course, select What replace strings can I use in the subject and message under the email subject text box to see a list of replace string options.

Replace String	Generated Text
{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

Here is a sample email using replace strings:

Dear {InitiatingUserFirstName}, You did not logged into the {OrgUnitName} course site in the last week. Please remember that regular participation in course activities is essential for success in this course!  Please log in to the course site as soon as possible. 

In the example above, each student’s name and the course title will automatically appear when the email is sent see below the bold text indicates what was added based on the replace string in the above example:

Dear John, You did not logged into the Composition & Rhetoric II course site in the last week. Please remember that regular participation in course activities is essential for success in this course! Please log into the course site as soon as possible.