Intelligent Agents

Automate your email notifications and delegate tasks to make your workload more efficient with Intelligent Agents.

Uses of Intelligent Agents

Examples of criteria that instructors can set up include, but are not limited to:

Login activity: if a student has or has not logged into Brightspace.
Course activity: if a student has or has not accessed a course.
Grades: if a student has achieved a specific score on a grade item or if they have not completed a grade item.
Content: if a student has or has not completed content or if a student has or has not viewed a content topic.

This page provides steps on how to create and utilize Intelligent Agents for your course.

Intelligent Agents

Creating a New Intelligent Agent

To create a new Intelligent Agent, follow these steps:

On a course navbar, click Instructor Only.
Click Course Admin.
On the Course Administration page, under the Communication header, click Intelligent Agents.
On the Agent List page, click New Agent.
On the New Agent page, enter a name.
Enter a description into the Description field, if required.
If you want to assign a category to the agent, select an option from the Category drop-down menu.
- You can create a new category by clicking the Add Category link to the right of the Category drop-down menu. Enter a name into the Name field and then click Create.
If you want the agent to be active, select the Agent is enabled check box.
To schedule how frequently agent criteria is evaluated, choose a frequency option from the dropdown menu and complete the schedule dates and repetition options as needed.
- Note: Intelligent Agents can only be scheduled to start after the course start date. Scheduled intelligent agents stop running and are automatically disabled if the course is inactive, past its end date, or deleted. You can still set up a practice run or a manual run of an intelligent agent at any time in a course that has passed its end date.
Expand Criteria, and under Role in Classlist do one of the following
- If you want the intelligent agent to be applicable to all roles in the Classlist, select the All users visible in the Classlist check box.
- If you want the intelligent agent to be applicable to select roles, select the Users with specific roles check box and select the respective roles.
If you want your agent to target users' login habits, under Criteria select Login Activity and enter your criteria.
- Note: Login activity refers to logins at the platform level.
If you want your agent to target users' course habits, under Criteria select Course Activity and enter your criteria.
To set an intelligent agent based on specific release conditions, do one of the following:
- If you want your agent to run when a specific existing condition has been met, under the Release Conditions subheading, select Create.
- Select a Condition Type from the drop-down list. Complete any additional Condition Details that appear and click Create. For example, you can create an agent that acts against users who have been enrolled in a course for a certain number of days, either based on the first or last time they were enrolled into the course.
- Note: All criteria selections under Take Action on Activity, which include the criteria Login Activity, Course Activity and Release Conditions, are optional selections.
Under Actions select Repetition and then select how often you want the agent to take action.
You can set your agent to perform an enrollment action:
- Under Change User Enrollments, select the Change user enrollments when the criteria are satisfied check box.
- From the Enrollment Action drop-down list, select the action you want your agent to perform and select the course.
- If you want to Enroll user in a course, select an available course from the dialogue. Only courses you have permission to enroll in will be shown.
- From the New Role drop-down list, select what role the user will be enrolled with when the agent criteria is satisfied.
If you want the agent to send an email when the criteria are satisfied, expand Actions and under Send an Email select the Send an email [when the criteria are satisfied] checkbox and enter your email details and relevant attachments.
Click Save and Close.

Considerations When Creating a New Intelligent Agent

When you create a new agent, you need to consider the following:

Criteria: The criteria the agent selected. The agent can check user login activity, course activity and/or triggered release conditions.
- Intelligent agents evaluate the status of release conditions at the time that they run.
Frequency: How often the agent is scheduled to run and find users that meet its criteria or often the agent takes action when a user satisfies the criteria. If you don't set a schedule, the agent must be manually triggered on the Agent List page.
Action. The action you want the agent to take when it finds a user that fits the criteria it is looking for. An agent can:
- change enrollment in the current course or enroll into another course.
- send an email to the user, their auditor or other user; or do nothing.
  - Note: choosing no action enables the agent to run and generate reports of those who have satisfied the criteria during different runs of the agent.

Note: You must have the appropriate enrollment permissions in the current or destination courses to create intelligent agents that change user enrollments. Any file attachments and inserted images in emails cannot exceed the limit set for your institution for email attachments.

Best Practices for Intelligent Agents

Any file attachments and inserted images in emails cannot exceed the limit set for your institution for email attachments.

Some best practices include:

Use a standard naming convention to keep the order and purpose of each agent clear.
Use the agent's description area to collect reminder notes of what you need to adjust in the agent for each offering.
Determine if your agent would benefit from repetition.
Use Replace Strings to personalize emails and minimize editing.
Avoid overusing agents, especially if you can get the information to learners another way.
Conduct a practice run of your Intelligent Agent prior to activating the agent.

Intelligent agents are not automatically accessible in their design. Students who are blind or have low vision, for example, use text-to-speech software and must listen to an entire email from start to finish. To assist in ease of access for all students: