{"id":26769,"date":"2022-09-02T12:48:54","date_gmt":"2022-09-02T15:18:54","guid":{"rendered":"https:\/\/blog.citl.mun.ca\/technologyresources\/?page_id=26769"},"modified":"2023-02-09T16:31:17","modified_gmt":"2023-02-09T20:01:17","slug":"intelligent-agents-replace-strings","status":"publish","type":"page","link":"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-replace-strings\/","title":{"rendered":"Intelligent Agents: Replace Strings"},"content":{"rendered":"\n<p><div class='content-column one_third'><div id=\"bellows-main-intelligentagents\" class=\"bellows bellows-nojs bellows-main bellows-source-menu bellows-align-left bellows-skin-vanilla bellows-type- bellows-expand-current\"><ul id=\"menu-intelligent-agents\" class=\"bellows-nav\" data-bellows-config=\"main\"><li id=\"menu-item-26787\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-home bellows-menu-item-has-children bellows-menu-item-26787 bellows-item-level-0\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Welcome to the Technology Resources Site<\/span><button class=\"bellows-subtoggle\" aria-label=\"Toggle Submenu\"><i class=\"bellows-subtoggle-icon-expand fa fa-chevron-down\"><\/i><i class=\"bellows-subtoggle-icon-collapse fa fa-chevron-up\"><\/i><\/button><\/a>\n<ul class=\"bellows-submenu\">\n\t<li id=\"menu-item-26789\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-has-children bellows-menu-item-26789 bellows-item-level-1\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/brightspace-guides\/course-admin\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Course Admin<\/span><button class=\"bellows-subtoggle\" aria-label=\"Toggle Submenu\"><i class=\"bellows-subtoggle-icon-expand fa fa-chevron-down\"><\/i><i class=\"bellows-subtoggle-icon-collapse fa fa-chevron-up\"><\/i><\/button><\/a>\n\t<ul class=\"bellows-submenu\">\n\t\t<li id=\"menu-item-26791\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-has-children bellows-menu-item-26791 bellows-item-level-2\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Intelligent Agents<\/span><button class=\"bellows-subtoggle\" aria-label=\"Toggle Submenu\"><i class=\"bellows-subtoggle-icon-expand fa fa-chevron-down\"><\/i><i class=\"bellows-subtoggle-icon-collapse fa fa-chevron-up\"><\/i><\/button><\/a>\n\t\t<ul class=\"bellows-submenu\">\n\t\t\t<li id=\"menu-item-27309\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-27309 bellows-item-level-3\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-creating-agents\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Creating Agents<\/span><\/a><\/li>\n\t\t\t<li id=\"menu-item-27311\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-27311 bellows-item-level-3\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-email-settings\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Modyfying Email Settings<\/span><\/a><\/li>\n\t\t\t<li id=\"menu-item-27315\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-27315 bellows-item-level-3\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-replace-strings\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Using Replace Strings<\/span><\/a><\/li>\n\t\t\t<li id=\"menu-item-27313\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-27313 bellows-item-level-3\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-practice-run\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Practice Run<\/span><\/a><\/li>\n\t\t\t<li id=\"menu-item-27389\" class=\"bellows-menu-item bellows-menu-item-type-post_type bellows-menu-item-object-page bellows-menu-item-27389 bellows-item-level-3\"><a  href=\"https:\/\/blog.citl.mun.ca\/technologyresources\/intelligent-agents-use-scenarios\/\" class=\"bellows-target\"><span class=\"bellows-target-title bellows-target-text\">Use Scenarios<\/span><\/a><\/li>\n\t\t<\/ul>\n<\/li>\n\t<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul><\/div><\/div><br><div class='content-column two_third last_column'><h1 class=\"wp-block-heading\">Using Replace Strings<\/h1>\n\n\n\n<p>If you choose to have an intelligent agent send emails to students identified by the agent, you have two options:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Compose a generic email and have the same version sent to each student. <\/li><li>Personalize each email with the student\u2019s name, last login date etc., which can be done automatically by using so-called \u2018<strong>replace strings<\/strong>\u2019.<\/li><\/ul>\n\n\n\n<p>Replace strings are special codes that can be used in automated emails in places where receiver-specific information would normally be found. When creating intelligent agents, replace strings can be used in:<\/p>\n\n\n\n<p><strong>1. Email recipient field (<em>To<\/em>, <em>CC<\/em>, and <em>Bcc<\/em>)<\/strong><\/p>\n\n\n\n<p>If you want the Brightspace system to autofill the address of the student identified by the intelligent agent, use the <strong>{InitiatingUser}<\/strong> replace string in the recipient field. (For more information on creating intelligent agent emails, view the &#8216;Actions&#8217; section on the &#8216;Creating Intelligent Agents&#8217; page.) <\/p>\n\n\n\n<p><strong>2. Body of the email<\/strong><\/p>\n\n\n\n<p>An example of a replace string that can be used in the email body is <strong>{InitiatingUserFirstName}<\/strong>. If an email containing this code is sent out by an intelligent agent, the system removes the replace string and inserts the student\u2019s first name in its place. Thus, an email like this:<\/p>\n\n\n\n<p class=\"has-background\" style=\"background-color:#e5e7f7\"><em>Hello <strong>{InitiatingUserFirstName}<\/strong>,<\/em><br><br><em>I would like to congratulate you on the high grade you received on Quiz 4 in your <\/em><strong><em>{OrgUnitName}<\/em> <\/strong><em>course. Well done and keep up the good work!<\/em><br><br><em>Cheers,<\/em><br><br><em>Dr. Smith<\/em><\/p>\n\n\n\n<p>\u2026would be delivered to a student named Rebecca with her own name in place of the replace string:<\/p>\n\n\n\n<p class=\"has-background\" style=\"background-color:#e5e7f7\"><em>Hello <strong>Rebecca<\/strong>,<\/em><br><br><em>I would like to congratulate you on the high grade you received on Quiz 4 <em>in your <\/em><strong><em>Economics 101<\/em> <\/strong><em>course<\/em>. Well done and keep up the good work!<\/em><br><br><em>Cheers,<\/em><br><br><em>Dr. Smith<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Commonly Used Replace Strings<\/h2>\n\n\n\n<p>The chart below lists the most common replace strings available to use in the subject line and message of emails sent out by intelligent agents, along with the type of information they generate.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><strong>Replace String<\/strong><\/td><td><strong>Information Brightspace will autofill<\/strong><\/td><\/tr><tr><td>{InitiatingUser}<\/td><td>The name of the user who performs the action that meets the agent\u2019s criteria, e.g. the student\u2019s name<\/td><\/tr><tr><td>{InitiatingUserFirstName}<\/td><td>The first name of the initiating user<\/td><\/tr><tr><td>{InitiatingUserFirstName}<\/td><td>The last name of the initiating user<\/td><\/tr><tr><td>{LastLoginDate}<\/td><td>The date the initiating user last logged in to Brightspace<\/td><\/tr><tr><td>{LastCourseAccessDate}<\/td><td>The date the initiating user last accessed the course<\/td><\/tr><tr><td>{OrgName}<\/td><td>The name of the organization<\/td><\/tr><tr><td>{OrgUnitName}<\/td><td>The name of the Org Unit (i.e. course name)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>For a complete list of replace strings that can be used with intelligent agents, please visit <a href=\"https:\/\/documentation.brightspace.com\/EN\/le\/intelligent_agents\/instructor\/replace_strings_for_agents.htm\" target=\"_blank\" rel=\"noreferrer noopener\">this Brightspace resource<\/a>. <\/p><\/div><div class='clear_column'><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":205,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"categories":[193],"tags":[],"class_list":["post-26769","page","type-page","status-publish","category-intelligent-agents"],"featured_image_src":null,"_links":{"self":[{"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/pages\/26769","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/users\/205"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/comments?post=26769"}],"version-history":[{"count":16,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/pages\/26769\/revisions"}],"predecessor-version":[{"id":27417,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/pages\/26769\/revisions\/27417"}],"wp:attachment":[{"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/media?parent=26769"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/categories?post=26769"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.citl.mun.ca\/technologyresources\/wp-json\/wp\/v2\/tags?post=26769"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}