Intelligent agents monitor your course to find activity that matches criteria that you set. The criteria that the agents search for are:

Transcription

1 Intelligent Agents Intelligent agents monitor your course to find activity that matches criteria that you set. The criteria that the agents search for are: Student login activity Release conditions in Learning Environment You can use existing release conditions, or create new ones for your agents. The agent will send you an when it finds users matching its criteria. You can run agents manually or set them to run on a schedule; daily, weekly, monthly, or annually. When you run an agent manually, it will send you a confirmation which lists the following information: org unit code and name which agent ran time and date the request was submitted time and date the request was finished whether the agent took action any error text Example uses for intelligent agents include: for users with grades below a certain level check for users that have not logged in within a specific number of days check for users that view a specific content topic Creating, Running, Editing, and Deleting Intelligent Agents You can create, edit and delete intelligent agents from the Agent List page. When you create a new agent you need to determine: what criteria it looks for what the content is for the that the agent sends when its conditions are met how often it looks for users meeting its criteria

2 Create an Intelligent Agent 1. Go to Edit Course on your course Navbar. Under the Tools area, select Intelligent Agents. 2. Click New Agent on the top tool bar on the Agent List page. 3. Type a name for the agent. 4. Type a description if you want. 5. Select the Status check box if you want the agent enabled once you save. 6. Determine the criteria the agent looks for: a. If you want the agent to search for search for login activity, select the Take action when the following login criteria are satisfied check box and choose which of the two login activities you want to monitor. b. If you want the agent to search for course activity, select the Take action when the following course activity criteria is satisfied check box and choose which of the two course activities you want to monitor.

3 c. Click the Attach Existing, or Create and Attach button to select or create release conditions for the agent to monitor (see the Release Conditions document for more information). 6. Determine the action the agent takes when its conditions are met: a. Select one of the Action Repetition radio buttons to set whether the agent takes action once or anytime the conditions are met. b. If you want the agent to run on a schedule, select the Schedule check box, then click the Update Schedule button. c. Set the schedule in the Update Agent Schedule pop-up. d. Click the Update button in the Update Agent Schedule pop-up to save the schedule and return to the New Agent page. The changes will be reflected on the New Agent page.

4 7. Select HTML or Plain Text radio buttons for the format. 8. Type the names of recipients in the To, Cc, and Bcc field. You can use special replace strings in these fields. The replace strings that you can use are depicted in the screen capture below. 9. Type the subject in the Subject field. You can use special replace strings in this field.

5 10. Type the body of your in the Message field. 11. Click Save. Run an Agent Manually Typically, intelligent agents are set up to run automatically. If you do not have a regular schedule set up for an agent, you must run it manually. Click the manually. Manually run agent icon next to an agents name on the Agent List page to run it To Edit an Agent 1. Click the name of the agent you want to edit on the Agent List page. 2. Make your revisions.

6 3. Click Save. Delete an Agent Click the Delete icon for the agent you want to delete on the Agent List page. Note: You cannot recover deleted agents Replace Strings for Intelligent Agents Address Replace Strings You can use the following replace strings in the address fields for the agent s. Replace String {InitiatingUser} Description The user who performed the action that met the agent's criteria. Address Replace Strings You can use the following replace strings in the HTML editor for the agent body. Replace String Description {OrgName} The name of the organization. {OrgUnitCode} The code for the Org Unit. {OrgUnitName} The name of the Org Unit. {OrgUnitStartDate} The start date specified for the Org Unit. {OrgUnitEndDate} The end date specified 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 Org Defined ID of the initiating user.