Studio Online de Self Help - Le menu Service Bots > Agents


Bibliothèque des modèles visuels : Disponible à partir de Self Help versions Autumn 2020 - Build 2020.2.108.7 et supérieurs.

Ce menu affiche la liste des agents virtuels créés dans Service Bots.

  • Un agent virtuel est une fonctionnalité qui permet d'interagir avec les utilisateurs via un système de questions - réponses, au travers d'un panneau conversationnel.
  • Il agrège les connaissances d'un ensemble de projets Self Help d'un même domaine.
  • Il peut être déployé sur différents canaux d'affichage.
  • Il utilise un dictionnaire pour analyser les questions de l'utilisateur et sélectionner le contenu le plus pertinent associé à la demande.

Remarques

  • Le menu Service Bots > Agents est accessible uniquement aux administrateurs domaines.
  • L'assistant de création d'un agent virtuel donne accès à une bibliothèque de modèles visuels.
    • Cette bibliothèque permet de configurer et personnaliser l'apparence de l'agent lorsqu'il doit être intégré dans une page web  - Open url.png voir Procédure
    • Lorsque l'agent virtuel est utilisé au travers d'une application Service Apps, son apparence visuelle s'effectue via le widget Virtual Agent.
  • L'intégration d'un agent virtuel dans une page web se fait en ajoutant un code JavaScript dans la section <head> de la page  - Open url.png voir Procédure

Attention

  • L'installation du package Base sociale est primordiale pour le fonctionnement de l'agent virtuel.

Bonnes pratiques

  •  Pour déployer rapidement votre agent virtuel, sélectionnez l'une des missions prédéfinies dans l'assistant de création. Celle-ci correspond à un champ d'action donné d'un agent virtuel et permet de télécharger automatiquement le contenu de tous les projets Self Help nécessaires à son fonctionnement.
        Open url.png voir Liste des modèles Self Help

    exemple  

    • Sélection de la mission Employés  ==>  Téléchargement des projets Base sociale, Service Manager, Agent virtuel Utilisateur
    • Sélection de la mission Kit Agent  ==>  Téléchargement du projet Base sociale et d'un projet Self Help vide de contenu destiné à la base de connaissance de l’agent

Description

        Service Bots menu - Agents.png

Accès : menu Service Bots > Agents

  • La liste des agents virtuels peut être triée en cliquant sur l'entête de chaque colonne.
  • Les agents virtuels peuvent être regroupés selon un critère donné, en cliquant sur le lien dédié en haut de la liste.
  • Un filtre sur le nom des agents virtuels peut être appliqué, en cliquant sur le lien dédié en haut de la liste.
  • Le détail d'un agent virtuel est affiché en cliquant sur son nom.
    • La liste de tous les projets Self Help associés à l'agent virtuel est affiché.
    • Les différentes apparences visuelles de l'agent virtuel sont affichées. Cliquez sur Add icon.png pour en créer une nouvelle  - Open url.png voir Procédure
    • Pour un agent virtuel associé à Microsoft Teams, les informations de l'application Bot créée dans Azure Bot Service sont affichées  - Open url.png voir Intégration Microsoft Teams
              Service Bots menu - Agents - Details.png
       

Fonctions disponibles via la barre d'outils

  • Création d'un nouvel agent virtuel  - Open url.png voir Procédure
    • Note : Uniquement pour un administrateur domaine
    • Affichage d'une liste de missions prédéfinies, qui permet de télécharger et d’importer automatiquement dans le domaine l'ensemble des projets Self Help nécessaires au fonctionnement de l'agent virtuel suivant son champ d'action.
    • Accès à une bibliothèque de modèles visuels, qui permet de configurer et d'adapter rapidement à sa charte graphique l'apparence visuelle de l'agent.
  • Modification d'un agent virtuel
  • Suppression d'un agent virtuel
  • Duplication d'un agent virtuel
  • Association d'un agent virtuel à la plateforme collaborative Microsoft Teams  - Open url.png voir Description

Procédures

Comment créer un agent virtuel

Note : Uniquement pour un administrateur domaine.

Étape 1 : Création du nouvel agent virtuel

1. Ouvrez le Studio Online.

2. Allez sur le menu Service Bots > Agents.

3. Cliquez sur + Ajouter.

La liste des missions prédéfinies des agents virtuels est affichée.
         Virtual agent - Template Library.png

4. Sélectionnez la méthode de création de votre agent.

  • Soit cliquez sur la mission prédéfinie qui correspond au champ d'action de votre agent virtuel. Cela vous permet de rattacher automatiquement les projets Self Help nécessaires à son fonctionnement.
        Open url.png voir Liste des modèles Self Help
  • Soit cliquez sur la mission Vide pour définir vous-même le champ d'action de l'agent virtuel et les projets Self Help nécessaires à son fonctionnement.

5. Cliquez sur Saisir les informations générales.

6. Renseignez les informations d'identification de l'agent.

Étape 2 : Définition du périmètre fonctionnel de l'agent virtuel

1. Sélectionnez le domaine d'application de l'agent.
Seuls les domaines auxquels vous avez accès sont affichés.

2. Indiquez les projets Self Help rattachés à l'agent.

  • Note : Si vous avez sélectionné une mission, tous les projets Self Help associés à celle-ci sont automatiquement affichés. Vous pouvez les désactiver en décochant la case.
  • Attention : Associez toujours la base sociale.
  • Vous pouvez ajouter d'autres projets Self Help parmi ceux auxquels vous avez accès sur le domaine, via Add icon.png.
            Virtual agent - Project selection.png

3. Sauvegardez le nouvel agent virtuel via Enregistrer et Fermer.

  • La liste des agents virtuels définis sur le serveur est réactualisée.
  • Si vous avez créé l'agent à partir d'une mission, les projets Self Help associés à celle-ci (exceptés ceux que vous avez désélectionnés) sont automatiquement importés dans le domaine de l'agent virtuel.


Étape 3 (optionnelle) : Définition de l'apparence visuelle de l'agent virtuel

Notes

  • Cette étape est nécessaire lorsque l'agent virtuel doit être intégré dans une page web  - Open url.png voir Procédure
  • La configuration de l'agent dans une application Service Apps s'effectue via le widget Virtual Agent.
  • Vous pouvez définir plusieurs apparences pour le même agent virtuel.
     

1. Cliquez sur Add icon.png dans la section Modèles visuels de l'agent.

Note : Vous pouvez configurer immédiatement l'apparence visuelle via Enregistrer et Configurer le modèle visuel à la fin de la création de l'agent.

        Virtual agent - Add layout.png

La bibliothèque de modèles visuels est ouverte.
         Virtual agent layout library.png

2. Cliquez sur le modèle souhaité.

3. Saisissez le nom de l'agent virtuel pour cette nouvelle apparence visuelle (1).

4. Configurez l'apparence de l'agent via les différentes propriétés (2)  - Open url.png voir Description

L'aperçu de l'agent est automatiquement réactualisé dans le panneau latéral droit (3).

Best Practice icon.png

  • Cliquez sur Visual appearance preview - Login icon.png pour visualiser la boîte de connexion à l'agent.
  • Cliquez sur Visual appearance preview - Conversation icon.png pour visualiser le panneau conversationnel.

5. Sauvegardez l'apparence visuelle de l'agent via Valider.

6. Répétez les mêmes actions pour chaque apparence visuelle que vous souhaitez créer pour l'agent.
 

Étape 4 (optionnelle) : Configuration du package de connexion Service Manager

Note : Lorsque l'agent virtuel recherche des informations et/ou permet la création de tickets dans Service Manager.

ServiceManagerPackageConfiguration_Procedure

1. Allez sur le Studio Desktop en mode Édition.

2. Ouvrez l'arborescence du projet Service Manager, dans le domaine de l'agent virtuel.

3. Renseignez tous les paramètres de la variable oSetup située dans la librairie du projet  - Open url.png voir Procédure
L'agent virtuel peut effectuer des appels vers l'API REST Service Manager.

Étape 5 : Configuration et publication des procédures de l'agent virtuel

ProceduresConfigurationPublication_Procedure

1. Adaptez les procédures dédiées à l'agent virtuel suivant l'identité que vous souhaitez donner à votre agent et suivant votre charte graphique / rédactionnelle.

    Open url.png voir :

2. Publiez l'ensemble des procédures des projets Self Help de l'agent virtuel  - Open url.png voir Procédure détaillée

Note : Les procédures du projet Service Manager ne nécessitent pas d’être publiées.

Étape 6 : Déploiement de l'agent virtuel

VirtualAgentDeploiement_Procedure

1. Configurez le mode d'intégration de l'agent virtuel suivant le canal d'affichage  - Open url.png voir Procédures détaillées

2. Informez les utilisateurs de la mise à disposition de l'agent virtuel.

Comment intégrer un agent virtuel dans un canal d'affichage

Intégration dans une application Service Apps

Un agent virtuel est implémenté dans une application via un widget Virtual Agent. L'accès à l'agent se fait via un connecteur de type Service Bots.

         Open url.png voir Procédure

Intégration dans une page web

L'intégration d'un agent virtuel dans une page web se fait en ajoutant un code JavaScript dans la section <head> de la page. Ce code contient toutes les informations renseignées lors de la création de l'agent et nécessaires pour son bon fonctionnement dans la page web : adresse du domaine, identifiant de l'agent, langue, ...

  • Le code peut être copié depuis l'apparence visuelle d'un agent virtuel. Dans ce cas, vous n'avez aucun paramétrage à effectuer.
  • Il peut être également créé manuellement ; pour cela, un code JavaScript vous est fourni, que vous devez configurer vous-même.
     

Best Practice icon.png  Configuration à partir du code généré par l'apparence visuelle de l'agent

Étape 1 : Copie du code JavaScript depuis l'apparence visuelle de l'agent virtuel

1. Ouvrez le Studio Online.

2. Allez sur le menu Service Bots > Agents.
La liste des agents virtuels est affichée.

3. Cliquez sur l'agent virtuel à intégrer dans la page web.
La liste des apparences visuelles définies pour l'agent est affichée.

Note : Vous pouvez créer une nouvelle apparence visuelle via Add icon.png en bas de la liste  - Open url.png voir procédure Comment créer un agent virtuel > Étape 3

        Virtual agent - Layouts.png

4. Cliquez sur Copier le code.
Le code JavaScript contenant la configuration de l'apparence visuelle est copié dans le presse-papiers.

Étape 2 : Intégration du code JavaScript dans la page web

1. Ouvrez votre page web dans un éditeur de texte.

2. Collez le code JavaScript dans la section <head> de la page.

Configuration manuelle du code JavaScript

Étape 1 : Personnalisation manuelle du code JavaScript

1. Copiez le code JavaScript ci-dessous dans un éditeur de texte.

Cliquez pour voir le code JavaScript

<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. Renseignez les paramètres ci-dessous.

  • www.myselfhelpdomain.com : Adresse du domaine hébergeant le projet Self Help.
  • assistant-id : Identifiant de l'agent virtuel.
  • lang : Langue à utiliser.
        exemple  fr_FR, en_US
  • is-test : Indique si l'agent doit utiliser la version en cours d'édition des projets Self Help (valeur true - Note : L'utilisateur doit avoir les droits nécessaires), ou non (valeur false).
  • quicklinks : Suggestions de saisie proposées à l'utilisateur.
  • contextvars.shoptions : Compte public lorsque des données doivent être accessibles à des utilisateurs non connectés. Note : Le compte doit obligatoirement être renseigné dans le cadre d'une intégration avec SSO.
  • contextvars.theme : Thème evSH à utiliser lors de l'affichage des procédures.
  • custom : Paramètres permettant de personnaliser l'interface de dialogue.
     

Étape 2 : Intégration du code JavaScript dans la page web

1. Ouvrez votre page web dans un éditeur de texte.

2. Collez le code JavaScript dans la section <head> de la page.

Tags:
Modifié par Utilisateur inconnu le 2021/05/28 13:01
Créé par Administrator XWiki le 2020/12/07 11:15

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help
•  Service Bots

Powered by XWiki ©, EasyVista 2021