Le service Intelligent Advisor, en tandem avec le composant de flux de dialogue Intelligent Advisor dans Oracle Digital Assistant, permet d'intégrer une enquête Oracle Intelligent Advisor à votre brique.

Lorsqu'une brique réalise une enquête, elle affiche chaque champ de manière appropriée pour le canal, comme décrit dans Affichage des artefacts dans une conversation. Pour avancer dans l'enquête, les clients répondent à la question ou indiquent l'une des commandes avec barre oblique suivantes :

L'intégration d'une enquête à une brique est un processus en trois étapes.

1. Ajoutez une intégration de service Intelligent Advisor.
2. (Facultatif mais vivement recommandé) Créez une variante "conversationnelle" de l'enquête.
3. Ajouter un composant Intelligent Advisor au flux de dialogue de votre brique.

Pour pouvoir accéder aux enquêtes Oracle Intelligent Advisor à partir de n'importe quelle brique, vous devez ajouter un service Intelligent Advisor, qui configure la connexion entre Oracle Digital Assistant et le client d'API d'Intelligent Advisor Hub.

Nous vous guiderons à travers les étapes d'obtention des informations du client d'API à partir d'Intelligent Advisor Hub et de création du service Intelligent Advisor dans Digital Assistant. Les étapes dans Intelligent Advisor Hub doivent être effectuées par un administrateur de hub.

1. Dans Intelligent Advisor Hub, cliquez sur pour ouvrir le menu latéral, sur Droits d'accès, puis sur l'onglet Espaces de travail.

2. Cliquez sur la collection souhaitée et assurez-vous que l'option Service de discussion est sélectionnée de sorte que, lorsque les déploiements de la collection sont activés, ils soient activés par défaut pour le service de discussion.

3. Cliquez sur l'onglet Clients d'API.

4. Si aucun client doté du rôle Service de discussion n'est présent, affectez le rôle à l'un des clients existants ou créez-en un avec le rôle Service de discussion activé.

5. Ouvrez le client d'API, assurez-vous qu'il est activé, et notez la clé secrète et son identificateur, dont vous aurez besoin pour créer le service Intelligent Advisor.

6. Sélectionnez Administrateur du hub pour la page ou Responsable pour l'espace de travail. Si aucune de ces options n'est sélectionnée, vous ne pourrez pas afficher les déploiements de discussion actifs du hub à partir de la page de service Intelligent Advisor. Vous ne pourrez pas non plus créer de nouvelles compétences directement à partir de la page de service.

7. Vous pouvez vous déconnecter du hub.

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

8. Cliquez sur + Service.

9. Dans la boîte de dialogue Nouveau service Intelligent Advisor, indiquez un nom unique pour le service.

   Il s'agit du nom que vous utiliserez pour la propriété Nom du service Intelligent Advisor du composant Intelligent Advisor dans le flux de dialogue de votre brique.

10. Entrez l'hôte d'Intelligent Advisor Hub. Enlevez le préfixe https://. Par exemple : myhub.example.com.

11. Définissez l'ID client et la clé secrète client sur l'identificateur et la clé secrète du client d'API que vous avez notés précédemment.

12. Cliquez sur Créer.

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

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

Pour plus d'informations sur les clients API, reportez-vous à Activation d'un projet et à Mise à jour des détails d'un client d'API dans ladocumentation Intelligent Advisor.

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

Pour tester une brique figurant dans la liste, cliquez sur l'icône Tester cette brique qui apparaît en regard du nom de la brique. Lorsque le testeur de conversations s'ouvre, démarrez la conversation. Avec les briques standard, il vous suffit de saisir hi et d'appuyer sur Entrée pour commencer. Cependant, la compétence recherche parfois des 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 brique à partir de la page de service Intelligent Advisor, sélectionnez un service pour les utilisateurs anonymes, puis cliquez sur + Nouvelle brique. (Les compétences ne peuvent pas accéder aux déploiements activés pour les utilisateurs de portail ou les utilisateurs d'agent.) Indiquez le nom d'affichage de la brique, sélectionnez un déploiement dans la liste déroulante, puis cliquez sur Créer. La nouvelle brique apparaît dans la liste des briques qui utilisent le service.

Pour afficher la liste des déploiements du hub auxquels vous pouvez accéder à partir des briques, accédez à Services supplémentaires, cliquez sur Intelligent Advisor, sélectionnez le service du hub et cliquez sur Déploiements.

Si un déploiement est activé sur le Web, l'icône Démarrer l'enquête Web apparaît en regard de son nom. Vous pouvez cliquer sur l'icône pour exécuter l'enquête dans un nouvel onglet du navigateur.

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

Description de l'image ia-deployments.png

Si Administrateur du hub ou Responsable n'est pas sélectionné pour le client d'API du service, la page ne peut pas afficher les déploiements et vous recevez une notification indiquant que vous n'êtes pas autorisé à effectuer l'opération. Reportez-vous à Ajout d'un service Intelligent Advisor.

Bien qu'il ne s'agisse pas d'une exigence stricte, vous pouvez améliorer considérablement l'efficacité de vos enquêtes Oracle Intelligent Advisor basées sur une discussion en utilisant des techniques conversationnelles.

La plupart des enquêtes sont optimisées pour les formulaires sur des pages Web, où les libellés d'écran, les libellés de section et les types de composant, tels que les listes déroulantes et les cases à cocher, donnent des indications visuelles sur le contexte de la question et les choix que vous pouvez faire. Etant donné que les conversations des briques sont différentes des interfaces Web traditionnelles, il se peut que vous ne puissiez pas simplement utiliser votre enquête par formulaire pour une conversation. Pour illustrer ce point, demandez à une personne de vous rejoindre et de vous asseoir dos à dos, l'une agissant en tant que bot et l'autre en tant que personne interrogée. Lisez votre entretien basé sur un formulaire à haute voix (en lisant chaque libellé et chaque invite) et demandez-vous s'il s'agit d'une conversation que vous pensez que vos clients voudraient avoir avec un bot.

Plutôt que de réutiliser une enquête spécifiquement conçue pour une page Web, envisagez de concevoir une variante plus conversationnelle. Pour reprendre le même modèle de stratégie comme source unique d'informations valides, utilisez la fonction d'inclusion Oracle Intelligent Advisor afin de créer des enquêtes supplémentaires pour ce modèle de stratégie. Reportez-vous à Inclusions dans la documentation Intelligent Advisor. Vous pouvez également envisager d'envoyer des données prédéfinies à l'enquête pour indiquer que celle-ci est réalisée dans une brique et pour que les artefacts de l'enquête soient masqués ou affichés en conséquence, comme les étapes décrites dans Personnaliser les enquêtes multicanal pour différents types d'utilisateur dans la documentation Intelligent Advisor, à ceci près que vous utiliserez votre propre attribut. Reportez-vous à Transmettre des valeurs d'attribut et les paramètres de connexion.

Voici un exemple. L'enquête suivante présente un ensemble de bascules d'image. Sur une page Web, l'utilisateur peut cliquer sur les images qui s'appliquent.

Lorsqu'elle est réalisée dans une brique, l'enquête présente chaque image et demande à l'utilisateur si le panneau est présent. L'utilisateur doit répondre par Oui ou Non pour chaque panneau, comme illustré dans cet exemple.

Etant donné que les règles de cette enquête ne s'intéressent qu'à la présence d'un panneau, l'enquête peut être optimisée pour une brique en affichant une seule image avec tous les panneaux et en posant une seule question : "L'un de ces panneaux est-il présent ?". Vous devez simplement modifier les règles afin d'ajouter une condition pour there is any sign present, comme illustré 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

Par ailleurs, le texte d'introduction ne s'applique pas au comportement d'une conversation dans une brique, et doit donc être modifié ou masqué.

Pour que vous puissiez accéder à une enquête anonyme à partir d'une brique, demandez à un administrateur Digital Assistant d'ajouter un service Intelligent Advisor à votre instance, puis demandez à un gestionnaire de hub de déployer votre enquête vers Intelligent Advisor Hub et de l'activer pour le service de discussion. Une fois ces tâches terminées, vous pouvez accéder à l'enquête à partir de votre brique en ajoutant le composant Intelligent Advisor à votre flux de dialogue.

Conseil :

Vous pouvez rapidement créer la brique à partir de la page du service Intelligent Advisor. Cliquez sur pour ouvrir le menu latéral, sur Paramètres, sur Services supplémentaires, sur l'onglet Intelligent Advisor, puis sur + Nouvelle brique. Attribuez un nom d'affichage à la brique 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 brique créée pour le mode de dialogue Visual.

1. Dans votre brique, cliquez sur Entités pour visualiser la page Entités, puis sélectionnez l'entité DATE.

2. Activez l'option Considérer les paramètres régionaux de l'utilisateur final et sélectionnez Le plus proche dans la liste déroulante Résoudre la date en tant que.

   L'enquête 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 les sections Règles de résolution d'ambiguïté pour les correspondances de date et d'heure et Résolution de date basée sur les paramètres régionaux.

3. Vérifiez que l'option Consider 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 insérer le composant Intelligent Advisor.

5. Passez la 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, saisissez intell, puis sélectionnez le composant Intelligent Advisor affiché.
7. Renseignez les champs Nom et Description, puis cliquez sur Insérer.

8. Dans l'inspecteur de propriétés du nouveau composant ajouté, définissez la propriété Nom du service Intelligent Advisor du composant sur le nom du service ajouté à la page Paramètres > Services supplémentaires > Intelligent Advisor.

9. Définissez Nom du projet de déploiement sur le nom de l'enquête anonyme qui a été déployée vers Intelligent Advisor Hub.

   Conseil :

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

10. Si vous voulez que le composant masque les titres d'écran, définissez Masquer tous les titres d'écran sur true. Par défaut, l'enquête affiche les titres des écrans.

11. Par défaut, l'enquête n'affiche pas l'explication. Vous pouvez définir la propriété Show Explanation sur always pour afficher l'explication à chaque fois, ou sur ask si vous voulez que l'utilisateur choisisse d'afficher ou non l'explication.

12. Si la brique a déjà obtenu les valeurs de l'un des attributs de l'enquête, vous pouvez utiliser la propriété Données prédéfinies pour transmettre les valeurs. Sinon, enlevez la propriété.

    Reportez-vous à Transmission de valeurs d'attribut et de paramètres de connexion pour découvrir comment transmettre les données prédéfinies et utiliser les données dans une enquête.

13. Par défaut, la brique affiche le balisage HTML et CSS de l'enquête. Si l'enquête contient du balisage HTML et CSS qui entraîne la présence de lignes vides inutiles dans la conversation, envisagez de définir Enlever des balises HTML de la sortie sur true.

14. Si l'enquête s'attend à une certaine devise, définissez Devise attendue de l'enquête sur le code ISO-4217 pour la devise attendue. Lorsqu'un code est spécifié, l'utilisateur peut uniquement saisir des valeurs de devise dans les formats autorisés pour cette devise.

15. Ajoutez un état permettant de gérer l'erreur générée en cas de problème avec l'intégration Intelligent Advisor.
    • Dans l'insecteur de propriétés, 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, renseignez les champs Nom et Description, puis cliquez sur Insérer.

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

    • Sélectionnez le composant nouvellement inséré et insérez et saisissez le texte que vous souhaitez que les utilisateurs voient en cas d'erreur, par 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) Affinez le réglage des chaînes utilisées par le composant pour les libellés et les messages standard. Voir Entrées de groupe de ressources pour Intelligent Advisor.

17. Si la brique est accessible par des canaux de type texte uniquement, assurez-vous que le paramètre de configuration Activer la numérotation automatique sur les actions de postback dans les flux de tâches de la brique est défini sur true ou sur une expression résolue en true pour les canaux de type texte uniquement, telle que l'expression suivante :

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

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

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

18. (Facultatif) Cliquez sur Aperçu et testez l'enquête pour tous les canaux qui auront accès à la brique.

Pour plus d'informations sur chacune des propriétés de composant, reportez-vous à Propriétés Intelligent Advisor.

Pour plus d'informations sur chacune des propriétés de la version YAML du composant et un exemple simple de leur utilisation, reportez-vous à System.IntelligentAdvisor.

Si votre brique a déjà obtenu les valeurs des attributs d'une enquête, vous pouvez utiliser la propriété Données prédéfinies du composant Intelligent Advisor pour transmettre les valeurs à l'enquête. Si votre enquête 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é Données prédéfinies pour définir des paires clé-valeur afin de transmettre des valeurs pour tout attribut d'enquête pour lequel l'option Paramètre prédéfini à partir de l'URL est activée. Cette option est disponible dans la boîte de dialogue Modifier l'attribut d'Oracle Policy Modeling.

L'enquête utilise les valeurs 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 souhaitez que l'enquête ignore l'écran ou l'étape si des données prédéfinies lui sont fournies, procédez comme suit dans Policy Modeling :

1. Ajoutez une règle pour déterminer si les données prédéfinies 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 la règle suivante :

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

2. Dans l'onglet Enquête, sélectionnez l'écran, cliquez sur Afficher l'écran si, puis sélectionnez la règle dans la liste déroulante Afficher si.

   
   
   Description de l'image 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 prédéfinies et sur la façon de les utiliser dans une enquête, reportez-vous aux articles suivants dans la documentation Intelligent Advisor :

Si votre enquête utilise un connecteur de service Web qui contient des mises en correspondance de données avec des données d'application, vous utilisez la propriété Paramètres de connexion pour définir des paires clé-valeur pour transmettre des données au connecteur.

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

Si vous devez accéder aux valeurs des attributs nommés qui ont été définies au cours de l'enquête, vous pouvez utiliser la propriété Variable pour les résultats de l'enquête 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'enquête avant la fin, la variable nommée par Variable pour les résultats de l'enquête ne sera pas créée.