Self Help Online Studio - Service Bots Menu > Agents


This menu displays the list of virtual agents created in Service Bots.

  • A virtual agent is a functionality that enables user interaction via a system of questions and answers in a conversation panel.
  • It assembles all knowledge for a set of Self Help projects in a given domain.
  • It can be deployed via different display channels.
  • It uses a dictionary to analyze user questions and to select the most relevant content related to the request.

Notes

  • Only domain administrators are authorized to access the Service Bots > Agents menu.
  • The installation of the Social Base package is vital for the virtual agent to work.

Best Practice

  • Create the virtual agent using one of the virtual agent mission templates. This enables you to add the Self Help projects required for deploying the virtual agent quickly.
        Open url.png See How to create a virtual agent.

Description

        Service Bots menu - Agents.png

Access: Service Bots > Agents menu

  • You can sort the list of virtual agents by clicking one of the column headers.
  • You can group virtual agents using a specific criterion by clicking the Group By link at the top of the list.
  • You can apply a filter to the names of virtual agents by clicking the Filter link at the top of the list.
  • A wizard helps you define the virtual agent quickly using a template from the library. The profile of the virtual agent is defined based on its mission. This will determine the contents of the associated Self Help projects.

    example  Starter Pack profile ==> The social base and a Self Help project without any knowledge base content will automatically be associated with the virtual agent.

     

Functionalities available in the toolbar

  • Add a virtual agent. Open url.png See the procedure.
    • Note: Only for domain administrators.
    • Virtual agent mission templates enable you to select the Self Help projects required for deploying the virtual agent quickly.
    • The visual layout library provides templates that help you define the visual layout of the virtual agent quickly. You can modify the virtual agent's properties to customize and adapt its visual aspect to your style guide.
  • Modify a virtual agent.
  • Delete a virtual agent.
  • Duplicate a virtual agent.
  • Associate a virtual agent with the Microsoft Teams collaborative platform. Open url.png See the description.

Procedures

How to create a virtual agent

Note: Only for domain administrators.

Step 1: Create the new virtual agent.

1. Open the Online Studio.

2. Select Service Bots > Agents in the menu.

3. Click + Add.

The template library will appear.
         Virtual agent - Template Library.png

3. Select the method for creating the new virtual agent.

  • You can click one of the profiles corresponding to the mission of your virtual agent and automatically associate the relevant Self Help projects.
  • You can click the Empty profile and manually select the relevant Self Help projects.

4. Click Set General Information.

5. Specify the information for identifying the virtual agent.

Step 2: Define the functional scope of the virtual agent.

1. Select the domain of the virtual agent.
Only the domains you are authorized to access will appear.

2. Indicate the Self Help projects associated with the virtual agent.

        Virtual agent - Project selection.png

  • If you select a profile from the library, all Self Help projects associated with the virtual agent's mission will automatically appear. You can disable them by unticking the relevant box.
  • Click Add icon.png to add other Self Help projects you are authorized to access in the domain.

3. Click Save and Close to save the new virtual agent.

  • The list of virtual agents defined on the server will be refreshed.
  • If you created the virtual agent using a profile, the Self Help projects associated with the mission (except those you unticked) will automatically be imported to your domain.

Step 3 (optional): Define the virtual agent's visual layout.

Note

  • This step is mandatory if you intend to integrate the virtual agent in a Web page. Open url.png See the procedure.
  • You configure the virtual agent in a Service Apps app using the Virtual Agent widget.
  • You can define several visual layouts for a given virtual agent.
     

1. Click Add icon.png in the Agent Layout section.

Note: You can define the visual layout immediately by clicking Save and Configure Layout when completing the creation of the virtual agent.

        Virtual agent - Add layout.png

The template library will appear.
         Virtual agent layout library.png

2. Select the template you want.

3. Enter the name of the virtual agent for this new visual layout (1).

4. Configure the virtual agent's visual layout using different properties (2). Open url.png See the description.

The preview of the virtual agent will automatically be refreshed in the right pane (3).

Best Practice icon.png

  • Click Visual appearance preview - Login icon.png to see the virtual agent's login pane.
  • Click Visual appearance preview - Conversation icon.png to see the virtual agent's conversation panel.

5. Click Finish to save the virtual agent's visual layout.

6. Repeat this procedure for each visual layout to be created for the virtual agent.
 

Step 4: Integrate the virtual agent in a display channel.

   Open url.png See the procedure.

How to integrate a virtual agent in a display channel

Integration in a Service Apps app

A virtual agent is implemented in an app using the Virtual Agent widget. The virtual agent is accessed using a Service Bots connector.

         Open url.png See the procedure.

Integration in a Web page

To integrate a virtual agent in a Web page, you must add a JavaScript code in the <head> section of the page. This code contains all of the information specified when the virtual agent was created. This information, which is required to ensure the virtual agent works correctly within the Web page, includes the domain address, the virtual agent ID, language, etc.

  • You can copy the code from the visual layout of the virtual agent. In this case, you are not required to perform any configuration manually.
  • You can also create it manually. To do this, you must configure the JavaScript code provided in this document.
     

Best Practice icon.png  Configuration using the code generated by the visual layout of the virtual agent

From: Self Help Autumn 2020

Step 1: Copy the JavaScript code from the visual layout of the virtual agent.

1. Open the Online Studio.

2. Select Service Bots > Agents in the menu.
The list of virtual agents will appear.

3. Click the virtual agent to be integrated in the Web page.
The list of visual layouts defined for the virtual agent will appear.

Note: Click Add icon.png at the bottom of the list to create a new visual layout. Open url.png See How to create a virtual agent > Step 3.

        Virtual agent - Layouts.png

4. Click Copy Code.
The JavaScript code containing the configuration of the visual layout will be copied to the clipboard.

Step 2: Integrate the JavaScript code in the Web page.

1. Open the Web page in a text editor.

2. Paste the JavaScript code in the <head> section of the page.

Manual configuration of the JavaScript code

Step 1: Configure the JavaScript code manually.

1. Copy the JavaScript code below to a text editor.

Click to see the JavaScript code.

<script type="text/javascript" src="https://www.myselfhelpdomain.com/va-themes/EVSelfHelp.widget.min.js"></script>
<script type="text/javascript">
  var ezEvie = new EVSelfHelp.Widget(
   {
    "assistant-id": "MyAgentID",
    "lang": "en_US",
    "is-test": false,
    "config-url": "https://www.myselfhelpdomain.com/va-themes/ezv-panel/config.json",
    "quicklinks": ["Text1","Text2"],
    "contextvars":
     {
      "shoptions": "public",
      "theme": "evsh"
     },
    "custom":
     {
    "ff": "verdana",
    "fs": "14px",
    "f_color": "#1e1f1f",
    "title": "https://www.domain.com/logo.png",
    "subtitle": "Your virtual agent",
    "subtitle_color": "#ffffff",,
    "bg_color": "#6eb0da"
    "cb_name": "EVie",
    "cb_color": "#6eb0da",
    "cb_color_alt": "#2c658a",
    "user_color": "#ffffff", //f6f7f9
    "user_bgcolor": "#fa7268", //ffbb00
    "footer_color": "#ffffff",
    "placeholder": "Enter your question",
    "textarea_border": "1px solid #e8e8e8"
     }
   });
</script>

2. Specify the parameters below.

  • www.myselfhelpdomain.com: Address of the domain hosting the Self Help project.
  • assistant-id: ID of the virtual agent.
  • lang: Language to be used.
        example  fr_FR, en_US
  • is-test: Indicates whether or not the virtual agent should use the version of Self Help projects currently being edited. Note: If the value is true, then users must have the appropriate rights. Otherwise, the value is false.
  • quicklinks: Predictive text suggested to users.
  • contextvars.shoptions: Public account when data must be made accessible to non-authenticated users. Note: If SSO is used, the account must be specified.
  • contextvars.theme: evSH skin to be used for displaying procedures.
  • custom: Parameters for customizing the conversation panel.
     

Step 2: Integrate the JavaScript code in the Web page.

1. Open the Web page in a text editor.

2. Paste the JavaScript code in the <head> section of the page.

Tags:
Last modified by Unknown User on 2020/12/07 16:59
Created by Administrator XWiki on 2020/12/07 11:15

Shortcuts

Powered by XWiki ©, EasyVista 2021