Skip to main content
Indiana Wesleyan University Support Knowledge Base

Creating an Intelligent Agent for Missing Student Engagement

Goal

After reviewing this how-to you will have the knowledge needed to create an Intelligent Agent that will identify students who have not accessed a specific Brightspace course for a specified number of days. For information on how to navigate to Intelligent Agents within a Brightspace course, please review the Navigating to Intelligent Agents guide.For a more in-depth explanation of the Agent list and its functionality, please review the Intelligent Agent List Overview guide.

Navigation

1. Navigate to Intelligent Agents within your course and select the "New" button.

clipboard_e3b4c1c9f85abdb45cdaca56058da4ab3.png

2. In the Agent Name field, create a name for the Intelligent Agent. **For this scenario, we are identifying students who have not accessed the course for 7 days or more.**

clipboard_e5d1e74cc817d708a9bbbf28201a42182.png

3. In the Description field, enter a description that describes what the agent does upon a glance.

clipboard_e5e94e5752a9f004ff005c57ea354109d.png

4. In the Status field, select the "Agent is enabled" checkbox to enable the intelligent agent.

clipboard_ef9ff55936ccc5a8c6a2eeda81736bc97.png

5. Under the "Criteria" category and within the "Role in Classlist" subcategory, select the radio button that determines what role the intelligent agent should pertain to.  This should typically be set to "All users visible in the Classlist". However if there are mentees or teaching assistants assigned to the course and who are visible in the classlist, select the "Users with specific roles" radio button to specify the roles that the agent should pertain to.  In this scenario, the "student" role should be chosen.

clipboard_e0c6075b3626af4d031da345fa7062256.png

6. In the Course Activity subcategory, select the checkbox to "Take action when the following course activity criteria are satisfied:".

clipboard_e26a5a09f54b2919e5ecda43b9437f028.png

7. Select the criteria needed for this agent.

clipboard_eacd3d8051cd4e72cac6b90f43e1e016c.png

8. Under the Actions category and within the "Repetitions" subcategory, select the appropriate Action Repetition setting.  **For this scenario, it is recommended that the "Take action every time the agent is evaluated and the agent's criteria are satisfied for a user" radio button is chosen.**

clipboard_e3b7f60f0cb7eed6b9e35db5db992db4e.png

9. In the "Send an Email" subcategory, select the checkbox to "Send an email when the criteria are satisfied".  The "Name that the emails come from" and the Reply-To address for responses" should prefill with the name and email address set up previously in the Settings. To review how to set email preferences for Intelligent Agents within a course, review the Setting Email Preferences for Intelligent Agents within a Course guide.

clipboard_e4524c1a20db5ed0d66f07d8abc21a171.png

10. In the "To" field of the email, enter your email address.

clipboard_eff9e80c61a0293d7d385903ff2ca7968.png

11. Enter a subject for the email that will be sent to you when the agent's criteria is triggered.  It is recommended that the subject clearly identify information about the content of the email without having to open the email. Replacement strings can be used to pull the student's name into the subject line. **Note: Failure to put the replacement string in exactly may result in the intelligent agent not functioning properly**. In the example below, the subject identifies the following information: Course Name, Student's First Name, Student's Last Name, and the Subject Matter. For more information on replacement strings, see the guide on Using Replace Strings in the Email Notifications Used Within an Intelligent Agent.

clipboard_ee84353510e1468479cd51f1b725dca63.png

12. The Message field can contain any type of information that the faculty may need to be reminded of.

clipboard_ee75e3638f6cbec771ea3c6fad5c622fb.png

13. In the Attachments subcategory, the faculty can upload any materials that they would like for the student to have, such as a copy of the new engagement policy.

clipboard_e11288c1c4f8ad0d352357a77a8cd90a5.png

14. The Email format subcategory will default to "HTML".  This setting can be left to the default.

clipboard_eb2c77a9028efe77dfb0f7454ee7b0f70.png

15. In the Scheduling category, choose the checkbox to "Use the Schedule".  Not using the scheduling feature will result in the faculty having to run the agent manually each time.

clipboard_e60f6bbb6a389f1af72e8e54e09b554e9.png

16. Choose the "Update Schedule" button to set up the frequency that the agent should run.

clipboard_ef353642563bd9fecaea4170b905df445.png

17. The "Update Agent Schedule" box will allow faculty to choose how often the agent runs.  In this instance, the faculty would want the agent to run daily.

clipboard_e913f6e4926737c4fb4f26a434c40ce79.png

18. The "Repeats Every:*" box will allow faculty to set how often the agent repeats.  For this agent, it would repeat every day.

clipboard_e128018707a593678b6dc86486edbf406.png

19. The Schedule Dates field will allow faculty to enter the start and end dates for the agent.  For example, faculty may want to set the start and end date of the agent to match the start and end dates of the course.

clipboard_e2a16272ff7173e75fd5eb9b5b9351ded.png

20. Once the parameters are set, select the "Update" button.

clipboard_ebd2c0b19faf905f61c8f7836da186e89.png

21. Select the "Save and Close" button to complete the setup.

clipboard_e26964d54e9eab1a9b0db52a3dc28f340.png

  • Was this article helpful?