Configure Tenant Environments

The process of configuring tenant environments will be completed by Anthology staff.

  • The DevOps Cloud team will configure resources in the Azure environment.
  • The Professional Service team will configure the Anthology Reach environment.

This procedure has two parts:

Create an App Registration

  1. Log in to the Azure Portal (Anthology Reach Tenant Azure Directory).

  2. Navigate to App registrations and click New registrationClosed

    New registration

  3. Specify the App Registration Name and click RegisterClosed

    <Product Name, Marketing>, <Marketing Purpose>

    The convention would look like this:

    • Production Environment
      • Renee - Higher Education Digital Assistant
    • Non-Production Environment
      • Renee - Higher Education Digital Assistant – Non-Production

    Register App Name

  4. The created ReneeBot app registration page will be displayed. Closed

    ReneeBot page

  5. Navigate to API permissions and click Add a permissionClosed

    Add a permission

  6. Add the following permissions which are required to authorize OAuth API calls. Closed

    Note: The administrator has to explicitly Grant Permission to the permission types listed below. For more information, see Customer Administration Portal > Permissions.

    API permissions

  7. Navigate to Overview and copy the Application (client) ID by clicking the Copy to clipboard button. Closed

    This ID will be specified as the Client ID in the Internal Administration Portal when mapping the tenants (see Add Tenant in Internal Administration Portal).

    This ID will also be needed for the Application User. See Create Application User, step 5.

    Application (client) ID

  8. Navigate to Certificates & secrets and click on New client secretClosed

    Application (client) ID

  9. Add a client secret by keeping Expires as NeverClosed

    Application (client) ID

  10. Copy the created Client Secret value by clicking the Copy to clipboard button. This Client Secret will be entered in the Internal Administration Portal when mapping the tenants. Closed

    This ID will be specified as the Client Secret in the Internal Administration Portal when mapping the tenants (see Add Tenant in Internal Administration Portal).

    Application (client) ID

Add Tenant in Internal Administration Portal

The Anthology Digital Assistant Internal Administration Portal (previously known as ReneeAdminWebApp) is used to manage configurations and environment variables for a new client/tenant. These variables are stored in an Azure SQL database and are retrieved by Digital Assistant.

In Digital Assistant version 1.2 and later, clients have access to the Customer Administration Portal which enables them to configure tenant settings, skills, and channels used by the bot. The tenant configuration in the Internal Administration Portal has to occur before clients can configure their instances of the Digital Assistant in the Customer Administration Portal.

  1. Log in to the Internal Administration Portal site.

  2. In the top menu, select Tenants and click the Create New link. To edit data for an existing tenant, scroll to the right and select the Edit link. Closed

    Tenants

  3. Specify the tenant details. Closed

    Tenant details

    • Name

      Specify the tenant's name (e.g., name of the institution).

    • Email

      Specify the email address of the tenant's contact person.

    • Phone Number

      Specify the phone number of the tenant's contact person. .

    • App ID

      The App ID is a required field for bot authentication. It cannot be empty and must be a valid GUID. The maximum number of characters allowed is 128.

      The App ID is retrieved from the tenant's bot channels registration. See Bot Channels Registration, step 10.

      1. On the Azure Services page, select the Bot Channels Registration resource.

      2. On the Bot Channels Registration page, select Settings under Bot Management in the left pane.

      3. Locate the Microsoft App ID field under Configuration in the main page. Copy and paste this ID into the Internal Administration Portal.

      4. Click the Manage link above the Microsoft App ID field and locate the Client Secrets section.

      5. Click the New client secret button to generate a password. Copy and paste the new password into the Internal Administration Portal.

    • App Password

      The App Password is a required field for bot authentication. It cannot be empty and must match the password in the bot's Azure directory. The password is masked while entering. The maximum number of characters allowed is 128.

      The App Password is retrieved from the tenant's bot channels registration. See Bot Channels Registration, step 13.

    • Client ID

      This is the Application (client) ID copied during the Create an App Registration process. The Client ID is a required field for multi-factor authentication (MFA).

    • Client Secret

      This is the Client Secret created and copied during the Create an App Registration process. The Client Secret is a required field for multi-factor authentication (MFA).

    • Tenant ID

      The Tenant ID is a required field for multi-factor authentication (MFA) and multi-tenancy in Digital Assistant version 1.1 and later. It cannot be empty and must be a valid GUID from the client's Azure directory. The maximum number of characters allowed is 128.

      The Tenant ID value is specified when you Configure Messaging Endpoints (see step 3).

    • Web Chat Secret

      This field needs to be populated to configure web chat for the Digital Assistant. For more information, see Web Chat Configuration.

    • CRM Domain

      This field is populated only for Anthology Reach clients.

      Note: If the CRM domain is “https://900002renee.crm.dynamics.com”, it should be added as “https://900002renee.api.crm.dynamics.com”.

  4. Click Create if you are creating a new tenant or Save if you are editing an existing tenant.

  5. The tenant will be listed on the tenant Index (List) page.

Review Tenant Details

To review the configuration for an existing tenant, scroll to the right on the list page and select the Details link. The tenant details are displayed. Closed

View Tenant Details

Remove a Tenant

To remove a tenant, scroll to the right in the Index page, select the Delete link, and click the Delete button on the Delete page. Closed

Delete

Review Audit Logs

The Internal Administration Portal enables Anthology staff to review changes done by a client in the Customer Administration Portal. Select the Audit Logs link in the Internal Administration Portal. The log will show old and new values for settings configured in the Customer Administration Portal.  Closed

Audit Log

You can scroll to the right of the log page and click the Details link to view a single log entry.  Closed

Log Details

The process of configuring tenant environments will be completed by Anthology staff.

  • The DevOps Cloud team will configure resources in the Azure environment.
  • The Professional Service team will configure the Anthology Reach environment.

This procedure has three parts:

Create an App Registration

  1. Log in to the Azure Portal (Anthology Reach Tenant Azure Directory).

  2. Navigate to App registrations and click New registrationClosed

    New registration

  3. Specify the App Registration Name and click RegisterClosed

    <Product Name, Marketing>, <Marketing Purpose>

    The convention would look like this:

    • Production Environment
      • Renee - Higher Education Digital Assistant
    • Non-Production Environment
      • Renee - Higher Education Digital Assistant – Non-Production

    Register App Name

  4. The created ReneeBot app registration page will be displayed. Closed

    ReneeBot page

  5. Navigate to API permissions and click Add a permissionClosed

    Add a permission

  6. Add the following permissions which are required to authorize OAuth API calls. Closed

    Note: The admin has to explicitly Grant Permission to the permission types listed below.

    API permissions

  7. Navigate to Overview and copy the Application (client) ID by clicking the Copy to clipboard button. Closed

    This ID will be specified as the Client ID in the Internal Administration Portal when mapping the tenants (see Add Tenant in Internal Administration Portal).

    This ID will also be needed for the Application User. See Create Application User, step 5.

    Application (client) ID

  8. Navigate to Certificates & secrets and click on New client secretClosed

    Application (client) ID

  9. Add a client secret by keeping Expires as NeverClosed

    Application (client) ID

  10. Copy the created Client Secret value by clicking the Copy to clipboard button. This Client Secret will be entered in the Internal Administration Portal when mapping the tenants. Closed

    This ID will be specified as the Client Secret in the Internal Administration Portal when mapping the tenants (see Add Tenant in Internal Administration Portal).

    Application (client) ID

Add Tenant in Internal Administration Portal

The Internal Administration Portal is used to manage customer configurations and environment variables for a new customer/tenant. These variables are stored in an Azure SQL database and are retrieved by Digital Assistant to determine which cognitive models the institution has access to.

The Internal Administration Portal is used to specify the identity and skills of the Digital Assistant for different tenants in the Azure cloud.

The Digital Assistant will evolve over time to have different cognitive models, or Lu-down files, that will understand conversations about specific use cases. The Digital Assistant will need to know which models to reference when people from a specific institution converse with it. Feature flags have been added to the cognitive models.

Skills are available when adding a new tenant to be able to set the cognitive models an institution can use. Skills are re-usable conversational building-blocks based on specific combinations of cognitive models. One institution may have the ability to access FAQ, General, and Chitchat while another institution may have a specific model for Student Verification and Chitchat but none of the other features like logging or opening a case.

  1. Log in to the Internal Administration Portal site. The Internal Administration Portal Index (List) page is displayed.

  2. In the top menu, select Tenants and click the Create New link. To edit data for an existing tenant, scroll to the right and select the Edit link. Closed

    Tenants

  3. Specify the tenant details. Closed

    Tenant details

    • Name

      Specify the tenant's name.

    • Email

      Specify the tenant's email address.

    • Phone Number

      Specify the tenant's phone number.

    • Username

      Specify a CRM User account in the Anthology Reach tenant. This account needs to be assigned the System Administrator security role.

      Note: This field is deprecated in Digital Assistant version 1.1. See Create Application User.

    • Bot Name

      This field is applicable only for clients using channels other than Live Assist. The maximum number of characters allowed is 50. If the Bot Name field is empty in the Internal Administration Portal and the tenant is not using Live Assist, the Bot will be named "Renee" by default.

      Clients using Live Assist can customize the Bot name as described here: Change the Bot Name.

    • App ID

      The App ID is a required field for bot authentication. It cannot be empty and must be a valid GUID. The maximum number of characters allowed is 128.

      The App ID is retrieved from the tenant's bot channels registration. See Bot Channels Registration, step 10.

      1. On the Azure Services page, select the Bot Channels Registration resource.

      2. On the Bot Channels Registration page, select Settings under Bot Management in the left pane.

      3. Locate the Microsoft App ID field under Configuration in the main page. Copy and paste this ID into the Internal Administration Portal.

      4. Click the Manage link above the Microsoft App ID field and locate the Client Secrets section.

      5. Click the New client secret button to generate a password. Copy and paste the new password into the Internal Administration Portal.

    • App Password

      The App Password is a required field for bot authentication. It cannot be empty and must match the password in the bot's Azure directory. The password is masked while entering. The maximum number of characters allowed is 128.

      The App Password is retrieved from the tenant's bot channels registration. See Bot Channels Registration, step 13.

    • Client ID

      This is the Application (client) ID copied during the Create an App Registration process. The Client ID is a required field for multi-factor authentication (MFA).

    • Client Secret

      This is the Client Secret created and copied during the Create an App Registration process. The Client Secret is a required field for multi-factor authentication (MFA).

    • Tenant ID

      The Tenant ID is a required field for multi-factor authentication (MFA) and multi-tenancy in Anthology Digital Assistant version 1.1 and later. It cannot be empty and must be a valid GUID from the client's Azure directory. The maximum number of characters allowed is 128.

      The Tenant ID value is specified when you Configure Messaging Endpoints (see step 3).

    • WebChat Secret, Embed Code, and Web Chat Domains

      These fields need to be populated to configure web chat for the Digital Assistant. For more information, see Web Chat Configuration.

    • LA Account Number

      This is the number of the tenant's Live Assist Dynamics 365 account. In can be found in the in the URL of the Live Assist Engagement Portal.

      This field needs to be populated if the client is using the Live Assist Enabler Configuration.

    • LA Data Host

      This is the hostname of the tenant's Live Assist data services configured in Anthology Reach. Enter the hostname without protocol, for example: "services.nx.lafor365.com"

      This field needs to be populated if the client is using the Live Assist Enabler Configuration.

    • Chat Email

      Specify the default email address to be used for email messages sent from within the chat window. This email address provides an option for the chat user to send a message when an institution does not have Anthology Reach but has the Digital Assistant implemented.

    • CRM Domain

      This field is populated only for Anthology Reach customers.

      Note: If the CRM domain is “https://900002renee.crm.dynamics.com”, it should be added as “https://900002renee.api.crm.dynamics.com”.

  4. Click Create if you are creating a new tenant or Save if you are editing an existing tenant.

  5. The tenant will be listed on the tenant Index (List) page.

Continue with Configure Tenant Skills.

Configure Tenant Skills

For every tenant, the Digital Assistant needs to be given access to specific skills. The skills can include out-of-the-box skills and/or custom skills.

  1. Select the Configure Skills link on the tenant record in the Internal Administration PortalClosed

    Tenants

  2. In the Skills section, select chitchat and/or faq. These are out-of-the-box skills for the Digital Assistant.  Closed

    Webapp - Skills configuration

  3. To configure custom skills, specify the following:

    • Name

      Specify a name that identifies the custom skill.

    • MicrosoftAppId

      Specify the Microsoft App Id of the custom skill.

    • ManifestUrl

      Specify the URL path of the Manifest for the custom skill.

    Click the Add button. Repeat this step for any additional custom skills. Use the Edit and Delete options as needed. Closed

    Custom skill

  4. Save the skill configuration. The list of skills will be updated in the Main Menu of the chat bot.

Review Tenant Configuration Details

To review the configuration for an existing tenant, scroll to the right on the Index page and select the Details link. The tenant details are displayed. Closed

View Tenant Details

Remove a Tenant

To remove a tenant, scroll to the right in the Index page, select the Delete link, and click the Delete button on the Delete page. Closed

Delete

Update QnA Pairs in Anthology Reach

After the Internal Administration Portal is configured, the deployment of the QnA pairs to the Anthology Reach instance needs to occur. Deployment instructions are in the Azure DevOps BOTs project repository. Please see the Deployment.md file.

  1. This update requires Node LTS to be installed on your computer. If Node LTS is not installed, download and install it from https://nodejs.org/en/download/.

  2. Download the Renee repo from https://dev.azure.com/campusmgmt-product-development/BOTs/_git/Renee and place it in a directory on your computer.

  3. Navigate to the directory where you placed the Renee repo and navigate to Services\ReneeDigitalAssistant.

  4. Open a Command Prompt for the above mentioned location and run npm installClosed

    Install npm

  5. Once npm is installed, run the following command substituting your variables as applicable. These variables are used in the Internal Administration Portal for tenant mapping.

    Variable Value
    -d CRM domain
    -u Username
    -p Password
    -i Client ID
    -s Client Secret


    node publishPairsToCRM.js -d https://somedomain.api.crm.dynamics.com -u someuser@somedomain.onmicrosoft.com -p somepassword -i some-client-id -s some-client-secret

    Command response Closed

    Install npm

    Install npm

  6. Once the command runs successfully, verify that the QnA pairs are updated in Anthology Reach under Settings > Bot Question ResponsesClosed

    Entity in Engage

After the QnA Pairs are deployed, users can Manage Answers on the Bot Question Responses Entity in Anthology Reach.

The Internal Administration Portal is used to manage customer configurations and environment variables for a new customer/tenant. These variables are stored in an Azure SQL database and are retrieved by the Digital Assistant to determine which cognitive models the institution has access to. The process for Configuring Tenant Environments will be completed by Anthology Inc. staff.

This procedure has three parts:

Create New App Registration

  1. Log in to the Azure Portal (Anthology Reach Tenant Azure Directory).

  2. Navigate to App registrations and click New registrationClosed

    New registration

  3. Specify the App Registration Name and click RegisterClosed

    <Product Name, Marketing>, <Marketing Purpose>

    The convention would look like:

    • Production Environment
      • Renee - Higher Education Digital Assistant
    • Non-Production Environment
      • Renee - Higher Education Digital Assistant – Non-Production

    Register App Name

  4. The created ReneeBot app registration page will be displayed. Closed

    ReneeBot page

  5. Navigate to API permissions and click Add a permissionClosed

    Add a permission

  6. Add the following permissions which are required to authorize Outh API calls. Closed

    Note: The admin has to explicitly Grant Permission to the permission types listed below.

    API permissions

  7. Navigate to Overview and copy the Application (client) ID by clicking the Copy to clipboard button. This ID will be entered as the Client ID in the Internal Administration Portal when mapping the tenants. Closed

    Application (client) ID

  8. Navigate to Certificates & secrets and click on New client secretClosed

    Application (client) ID

  9. Add a client secret by keeping Expires as NeverClosed

    Application (client) ID

  10. Copy the created Client Secret value by clicking the Copy to clipboard button. This Client Secret will be entered in the Internal Administration Portal when mapping the tenants. Closed

    Application (client) ID

Add Tenant in Internal Administration Portal

The Digital Assistant will evolve over time to have different cognitive models, or Lu-down files, that will understand conversations about specific use cases. The Digital Assistant will need to know which models to reference when people from a specific institution converse with it. Feature flags have been added to the cognitive models.

Skills are available when adding a new tenant to be able to set the cognitive models an institution can use. Skills are re-usable conversational building-blocks based on specific combinations of cognitive models.

One institution may have the ability to access FAQ, General, and Chitchat while another institution may have a specific model for Student Verification and Chitchat but none of the other features like logging or opening a case.

  1. Log in to the Internal Administration Portal site.

  2. In the top menu, select Tenants and click the Create New link. Closed

    Tenants

  3. Fill in the tenant details:

    • Name
    • Email
    • Phone Number
    • Username (This is a CRM User account in the Anthology Reach Tenant. This account needs to be assigned the System Administrator security role.)
    • Password (This is the credentials for the CRM User account in the Engage Tenant.)
    • Client ID (This is the Application (client) ID copied during the Create New App Registration process.)
    • Client Secret (This is the Client Secret created and copied during the Create New App Registration process.)
    • CRM Domain
    • Portal Domain

    Select the required Skills (e.g., chitchat, faq), and click CreateClosed

    Note: If the CRM domain is “https://900002renee.crm.dynamics.com”, it should be added as “https://900002renee.api.crm.dynamics.com”.

    Tenant details

  4. The tenant will be added to the tenant Index page. Closed

    Tenant Index

Update QnA Pairs in Anthology Reach

After the Internal Administration Portal is configured, the deployment of the QnA pairs to the Anthology Reach instance needs to occur. Deployment instructions are in the Azure DevOps BOTs project repository. Please see the Deployment.md file.

  1. This update requires Node LTS to be installed on your computer. If Node LTS is not installed, download and install it from https://nodejs.org/en/download/.

  2. Download the repo from https://dev.azure.com/campusmgmt-product-development/BOTs/_git/Renee and place it in a directory on your computer.

  3. Navigate to the directory where you placed the repo and navigate to services\renee_bot.

  4. Open a Command Prompt for the above mentioned location and run npm installClosed

    Install npm

  5. Once npm is installed, run the following command substituting your variables as applicable. These variables are used in the Renee Admin Web app for tenant mapping.

    Variable Value
    -d CRM domain
    -u Username
    -p Password
    -i Client ID
    -s Client Secret


    node publishPairsToCRM.js -d https://somedomain.api.crm.dynamics.com -u someuser@somedomain.onmicrosoft.com -p somepassword -i some-client-id -s some-client-secret

    Command response Closed

    Install npm

    Install npm

  6. Once the command runs successfully, verify that the QnA pairs are updated in Anthology Reach under Settings > Bot Question ResponsesClosed

    Entity in Engage

After the QnA Pairs are deployed, users can Manage Answers on the Bot Question Responses Entity in Anthology Reach.