Le service Intelligent Advisor, en tandem avec le composant de flux de dialogue Intelligent Advisor dans Oracle Digital Assistant, vous permet d'intégrer une entrevue Oracle Intelligent Advisor dans votre compétence.

Lorsqu'une compétence effectue une entrevue, elle présente chaque champ d'une manière adaptée au canal, comme décrit dans la rubrique Comment les artefacts s'affichent dans une conversation. Pour naviguer dans l'entrevue, les clients répondent à la question ou disent l'une des commandes à barre oblique suivantes :

L'intégration de votre compétence à une entrevue est un processus en trois étapes.

1. Ajoutez une intégration au service Intelligent Advisor.
2. (Facultatif mais fortement recommandé) Créez une variation "conversationnelle" de l'entrevue.
3. Ajoutez un composant Intelligent Advisor au flux de dialogue de votre compétence.

Pour pouvoir accéder aux entrevues d'Oracle Intelligent Advisor à partir de toutes les compétences, vous devez ajouter un service Intelligent Advisor, qui configure la connexion entre Oracle Digital Assistant et le client API d'un centre de gestion Intelligent Advisor.

Nous vous guiderons tout au long de la procédure pour obtenir les informations du client d'API du centre de gestion Intelligent Advisor et pour créer le service Intelligent Advisor dans Digital Assistant. Les étapes du centre de gestion Intelligent Advisor doivent être effectuées par un des administrateurs du centre.

1. Dans le centre de gestion Intelligent Advisor, cliquez sur pour ouvrir le menu latéral, sur Permissions, puis sur l'onglet Workspaces (Espaces de travail).

2. Cliquez sur la collection souhaitée et assurez-vous que Chat Service (Service de clavardage) est sélectionné afin que, lorsque les déploiements de la collection sont activés, ils le soient par défaut pour le service de clavardage.

3. Cliquez sur l'onglet API clients (Clients d'API).

4. Si vous ne voyez pas de client associé au rôle Chat Service (Service de clavardage), affectez ce rôle à l'un des clients existants ou créez un client pour lequel ce rôle est activé.

5. Ouvrez le client d'API, assurez-vous qu'il est activé et notez la clé secrète et l'identifiant associés. Vous en aurez besoin pour créer le service Intelligent Advisor.

6. Sélectionnez Administrateur Hub pour la page ou Gestionnaire pour l'espace de travail. Si aucun de ces éléments n'est sélectionné, vous ne pourrez pas afficher les déploiements de clavardage actifs du concentrateur à partir de la page du service Intelligent Advisor. Vous ne pourrez pas non plus créer de nouvelles compétences directement à partir de la page du service.

7. Vous pouvez vous déconnecter du centre de gestion.

   Dans Digital Assistant, cliquez sur pour ouvrir le menu latéral, sur Settings (Paramètres), sur Additional Services (Services supplémentaires), puis sur l'onglet Intelligent Advisor.

8. Cliquez sur + Service.

9. Dans la boîte de dialogue New Intelligent Advisor Service (Nouveau service Intelligent Advisor), donnez un nom unique au service.

   Il s'agit du nom que vous utiliserez pour la propriété Intelligent Advisor Service Name (Nom du service Intelligent Advisor) du composant Intelligent Advisor dans le flux de dialogue de votre compétence.

10. Entrez l'hôte du centre de gestion Intelligent Advisor. Supprimez le préfixe https://. Par exemple : myhub.example.com.

11. Affectez à Client ID (ID client) et Client Secret (Clé secrète du client) l'identificateur et la clé secrète du client d'API que vous avez notés précédemment.

12. Cliquez sur Create (Créer).

13. Cliquez sur Vérifier les paramètres pour vous assurer qu'une connexion peut être établie à l'aide des paramètres entrés.

Lorsque vous créez des compétences qui utilisent le service, la page du service Intelligent Advisor affiche les noms des compétences et des déploiements de concentrateur utilisés par les compétences. Vous pouvez ouvrir le testeur de compétence pour l'une de ces compétences directement pour la page du service. Vous pouvez également créer des compétences directement à partir de cette page. Voir Créer et tester des aptitudes à partir de la page Service Intelligent Advisor.

Pour plus d'informations sur les clients d'API, voir Activer un projet et Mettre à jour les détails d'un client d'API dans la documentation sur Intelligent Advisor.

La page du service Intelligent Advisor répertorie toutes les compétences qui utilisent les déploiements de clavardage actifs du concentrateur, et vous pouvez exécuter le testeur de compétences pour l'une des compétences répertoriées. En outre, à partir de cette page, vous pouvez créer une compétence qui accède à un déploiement actif.

Pour tester une compétence figurant dans la liste, cliquez sur l'icône Test this Skill (Tester cette compétence) qui s'affiche à côté du nom de la compétence. Lorsque le testeur de conversation s'ouvre, démarrez la conversation. Avec les compétences typiques, il vous suffit de taper hi et d'appuyer sur Entrée pour commencer. Cependant, parfois, la compétence est à la recherche de phrases spécifiques. Dans ce cas, si vous entrez une phrase qu'il ne comprend pas, il devrait vous donner des instructions sur ce qu'il faut taper.

Pour créer une compétence à partir de la page du service Intelligent Advisor, sélectionnez un service pour les utilisateurs anonymes, puis cliquez sur + New Skill (Nouvelle compétence). (Les compétences ne peuvent pas accéder aux déploiements activés pour les utilisateurs du portail ou les utilisateurs d'agent.) Indiquez un nom d'affichage pour la compétence, sélectionnez un déploiement dans la liste déroulante et cliquez sur Create (Créer). La nouvelle compétence apparaît dans la liste des compétences qui utilisent le service.

Pour voir la liste des déploiements du concentrateur auxquels vous pouvez accéder à partir de compétences, allez à Services supplémentaires, cliquez sur Intelligent Advisor, sélectionnez le service du concentrateur et cliquez sur Déploiements.

Si un déploiement est activé pour le Web, vous verrez l'icône Lancer l'entrevue Web à côté de son nom. Vous pouvez cliquer sur l'icône pour exécuter l'entrevue dans un nouvel onglet du navigateur.

Pour accéder au déploiement dans le concentrateur, cliquez sur Gérer le déploiement .

Description de l'illustration ia-deployments.png

Si le client d'API du service n'a pas d'administrateur Hub ou de gestionnaire sélectionné, la page ne peut pas afficher les déploiements et vous recevrez un avis indiquant que vous n'êtes pas autorisé à effectuer l'opération. Voir Ajouter un service Intelligent Advisor.

Bien qu'il ne s'agisse pas vraiment d'une exigence, vous pouvez augmenter considérablement l'efficacité de vos entrevues par clavardage Oracle Intelligent Advisor en utilisant des techniques de conversation.

La plupart des entrevues sont optimisées pour les formulaires sur des pages Web, où les étiquettes d'écran et de section, et les types de composant tels que les listes déroulantes et les cases à cocher donnent des indices visuels sur le contexte de la question et sur les choix que vous pouvez faire. Étant donné que les conversations de compétence sont différentes des interfaces Web traditionnelles, vous ne serez peut-être pas en mesure d'utiliser simplement votre formulaire d'entrevue pour une conversation. Pour illustrer ce point, demandez à une personne de se joindre à vous et de s'asseoir dos à dos, avec une personne agissant en tant que bot et l'autre agissant en tant que personne interviewée. Lisez votre entrevue basée sur un formulaire à haute voix (lecture de chaque étiquette et invite) et demandez-vous s'il s'agit d'une conversation que vous pensez que vos clients voudraient avoir avec un robot.

Au lieu de réutiliser une entrevue spécialement conçue pour une page Web, envisagez de créer une variation plus conversationnelle. Puisque vous vous servirez certainement du même modèle de politique comme source de données unique, utilisez la fonction Inclusions d'Oracle Intelligent Advisor pour créer des entrevues supplémentaires sur ce modèle. Voir Inclusions dans la documentation Intelligent Advisor. Sinon, envisagez de transmettre des données de départ à l'entrevue pour indiquer qu'elle est menée dans une compétence. Masquez ou affichez des artefacts dans l'entrevue en conséquence, comme dans les étapes décrites dans Personnaliser les entrevues multicanaux pour différents types d'utilisateur de la documentation sur Intelligent Advisor, sauf que vous utiliserez votre propre attribut. Voir Transmettre les valeurs d'attribut et les paramètres de connexion.

Voici un exemple . L'entrevue suivante présente un ensemble d'images à activer ou désactiver. Sur une page Web, l'utilisateur peut cliquer sur les images qui s'appliquent.

Lorsqu'elle est effectuée dans une compétence, l'entrevue présente chaque image et demande à l'utilisateur si la plaque-étiquette est présente. L'utilisateur doit répondre Oui ou Non pour chacune, comme indiqué dans cet exemple.

Étant donné que les règles de l'entrevue ne s'attachent qu'à la présence éventuelle d'une plaque, l'entrevue peut être optimisée pour une compétence en affichant une seule image contenant toutes les plaques-étiquettes et en posant une seule question : "L'une de ces plaques-étiquettes est-elle présente?" Les règles doivent simplement être modifiées pour ajouter une condition pour there is any sign present, comme indiqué ici.

dangerous goods need to be handled if  
  there is a combustibles sign present or
  there is an explosives sign present or
  there is a flammable gas sign present or
  there is an inhalation sign present or
  there is a nonflammable sign present or
  there is an oxygen sign present or
  there is a flammable solid sign present or
  there is any sign present

Notez également que l'amorce n'est pas applicable au comportement de la conversation de compétence et, par conséquent, doit être modifiée ou masquée.

Avant de pouvoir accéder à une entrevue anonyme à partir d'une compétence, demandez à un administrateur Digital Assistant d'ajouter un service Intelligent Advisor à votre instance, et à un gestionnaire de centre de déployer votre entrevue au centre et de l'activer pour un service de clavardage. Une fois ces tâches terminées, vous pouvez accéder à l'entrevue à partir de votre compétence en ajoutant le composant Intelligent Advisor à votre flux de dialogue.

Conseil :

Vous pouvez créer rapidement la compétence à partir de la page du service Intelligent Advisor. Cliquez sur pour ouvrir le menu latéral, sur Settings, sur Additional Services (Services supplémentaires), sur l'onglet Intelligent Advisor, puis sur + New Skill (Nouvelle compétence). Donnez à la compétence un nom d'affichage et sélectionnez le déploiement dans la liste déroulante.

Les étapes suivantes vous guident tout au long de l'utilisation du composant dans une compétence créée pour le mode de dialogue visuel.

1. Dans votre compétence, cliquez sur Entités pour voir la page Entités, puis sélectionnez l'entité DATE.

2. Activez Consider End User Locale (Consider les paramètres régionaux de l'utilisateur final) et sélectionnez Nearest (Le plus proche) dans la liste déroulante Resolve Date as (Résoudre la date en tant que).

   L'entrevue utilise ces paramètres pour déterminer le format de date d'entrée et interpréter les dates ambiguës, comme décrit dans Règles de résolution d'ambiguïté pour les correspondances de temps et de date et Résolution de date basée sur des intervalles.

3. Vérifiez que l'option Consider End User Locale (Considérer les paramètres régionaux de l'utilisateur final) est activée pour les entités CURRENCY et NUMBER.

4. Cliquez sur Flux , puis sélectionnez le flux dans lequel vous voulez insérer le composant Intelligent Advisor.

5. Souris sur la ligne reliant les deux composants où vous souhaitez insérer le nouveau composant et cliquez sur
   
   
   
   .
6. Dans le champ Rechercher de la boîte de dialogue Ajouter un état, entrez intell, puis sélectionnez le composant Intelligent Advisor qui s'affiche.
7. Remplissez les champs Nom et Description et cliquez sur Insérer.

8. Dans l'inspecteur de propriétés du composant nouvellement ajouté, réglez la propriété Nom du service Intelligent Advisor du composant au nom du service ajouté à la page Settings > Additional Services > Intelligent Advisor.

9. Réglez Nom du projet de déploiement au nom de l'entrevue anonyme déployée dans le centre Intelligent Advisor.

   Conseil :

   Si vous n'êtes pas sûr de l'orthographe exacte du nom, allez à Services supplémentaires, cliquez sur Intelligent Advisor, sélectionnez le service du concentrateur et cliquez sur Déploiements pour voir la liste des noms de déploiement.

10. Si vous voulez que le composant masque les titres d'écran, réglez Masquer tous les titres d'écran à true. Par défaut, l'entrevue affiche les titres d'écran.

11. Par défaut, l'entrevue n'affiche pas l'explication. Vous pouvez régler la propriété Show Explanation (Afficher l'explication) à always pour afficher l'explication à chaque fois, ou à ask si vous voulez que l'utilisateur choisisse de voir l'explication.

12. Si la compétence a déjà obtenu des valeurs pour l'un des attributs de l'entrevue, vous pouvez utiliser la propriété Seed Data (Données prédéfinies) pour transmettre les valeurs. Sinon, supprimez la propriété.

    Voir Transmettre des valeurs d'attribut et des paramètres de connexion pour apprendre comment transmettre les données de départ et comment utiliser les données dans une entrevue.

13. Par défaut, les compétences extraient le balisage HTML et CSS de l'entrevue. Si l'entrevue contient des balises HTML et CSS qui font que la conversation contient des lignes vides inutiles, envisagez de régler Supprimer les marqueurs HTML de la sortie à true.

14. Si l'entrevue attend une certaine devise, réglez Interview Expected Currency (Devise attendue de l'entrevue) au code ISO-4217 pour la devise attendue. Lorsqu'un code est spécifié, l'utilisateur ne peut entrer des valeurs de devise que dans les formats autorisés pour cette devise.

15. Ajoutez un état pour le traitement de l'erreur générée en cas de problème d'intégration à Intelligent Advisor.
    • Dans l'insecteur de propriété, sélectionnez l'onglet Transitions.
    • Créez une action et nommez-la error.
    • Dans le champ Transition vers, sélectionnez Ajouter un état.
    • Sélectionnez le modèle Envoyer un message ou l'un des modèles Messagerie utilisateur, entrez un nom et une description, puis cliquez sur Insérer.

      Un nouveau composant doit être inséré dans le diagramme de flux avec une transition erreur le connectant au composant Intelligent Advisor

    • Sélectionnez le composant nouvellement inséré et insérez et entrez le texte que les utilisateurs souhaitent voir en cas d'erreur, p. ex.

      We are having a problem with a connection. Can you please send email to contact@example.com to let them know that the loan advisor isn't working? Thank you.
16. (Facultatif), réglez avec précision les chaînes utilisées par le composant pour les étiquettes et les messages standard. Voir Entrées d'ensemble de ressources pour Intelligent Advisor.

17. Si la compétence est accessible par des canaux textuels, assurez-vous que le paramètre de configuration Enable Auto Numbering on Postback Actions in Task Flows (Activer la numérotation automatique pour les actions de republication dans les flux de tâches) de la compétence est réglé à true ou à une expression qui se résout à true pour les canaux textuels, tels que l'expression suivante :

    ${(system.channelType=='twilio'||system.channelType=='osvc' )?then('true','false')}

    Cela permet à l'utilisateur de sélectionner simplement une option en tapant un nombre au lieu du texte intégral de l'option.

    Vous pouvez accéder à ce paramètre en sélectionnant
    
    dans la barre de navigation de gauche de la compétence et en sélectionnant l'onglet Configuration.

18. (Facultatif), cliquez sur Preview (Prévisualiser) et testez l'entrevue pour tous les canaux qui pourront accéder à la compétence.

Pour plus de détails sur chacune des propriétés du composant, voir Propriétés d'Intelligent Advisor.

Pour plus de détails sur chacune des propriétés de la version YAML du composant et pour un exemple simple de leur utilisation, voir System.IntelligentAdvisor.

Si votre compétence a déjà obtenu des valeurs pour les attributs d'une entrevue, vous pouvez utiliser la propriété Seed Data (Données prédéfinies) du composant Intelligent Advisor pour transmettre ces valeurs à l'entrevue. Si votre entrevue nécessite des paramètres pour les connecteurs de service Web, vous pouvez utiliser la propriété Paramètres de connexion pour transmettre les valeurs.

Utilisez la propriété Seed Data (Données prédéfinies) pour définir des paires clé-valeur afin de transmettre des valeurs pour tout attribut d'entrevue pour lequel l'option Seed from URL parameter (Données prédéfinies à partir du paramètre d'URL) est activée. Vous pouvez trouver cette option dans la boîte de dialogue Edit Attribute (Modifier l'attribut) dans Oracle Policy Modeling.

L'entrevue utilise les valeurs Seed Data (Données prédéfinies) pour définir les valeurs par défaut, qui sont affichées en tant que valeurs suggérées.

Si vous voulez que l'entrevue ignore l'écran ou l'étape si des données de départ lui sont fournies, suivez les étapes suivantes dans la modélisation de politique :

1. Ajoutez une règle pour déterminer si les données de départ ont été fournies :

   • Pour un attribut booléen, utilisez la règle suivante :

     The <screen name> screen should be shown if
           <attribute name> is uncertain or
           <attribute name> is currently unknown

   • Pour un attribut non booléen, utilisez cette règle :

     The <screen name> screen should be shown if
           <attribute name> is currently unknown

2. Dans l'onglet Entrevue, sélectionnez l'écran, cliquez sur Afficher l'écran si et sélectionnez la règle dans la liste déroulante Afficher si.

   
   
   Description de l'illustration ia-show-screen-if.png
   

   Si vous avez plusieurs questions à l'écran et que vous voulez masquer uniquement la question, au lieu d'utiliser le bouton Afficher l'écran si, sélectionnez la question, cliquez sur Obligatoire et sélectionnez la règle dans la liste déroulante Afficher si.

Pour en savoir plus sur les données de départ et sur la façon de les utiliser dans une entrevue, voir ces articles dans la documentation sur Intelligent Advisor :

Si votre entrevue utilise un connecteur de service Web qui contient des mappages de données aux données d'application, vous utilisez la propriété Paramètres de connexion pour définir des paires clé-valeur pour la transmission de données au connecteur.

Pour en savoir plus sur les paramètres, voir Intégration de données dans la documentation d'Intelligent Advisor.

Si vous devez accéder aux valeurs des attributs nommés qui ont été définis lors de l'entrevue, vous pouvez utiliser la propriété Variable pour les résultats d'entrevue pour transmettre le nom d'une variable de liste. Les valeurs d'attribut nommé seront stockées dans cette variable sous la forme d'un tableau de paires clé/valeur.

Si l'utilisateur quitte l'entrevue avant l'achèvement, la variable nommée par Variable pour les résultats de l'entrevue ne sera pas créée.