Configurer Autopilot (Amelia) avec Knowledge Hub

Vous pouvez utiliser NiCE CXone Knowledge Management (Expert) ou une source de connaissancesClosed A knowledge management system that hosts knowledge articles. tierce avec votre agent virtuel Autopilot (Amelia). La connexion entre Autopilot (Amelia) et votre source de connaissances est gérée avec NiCE CXone Knowledge Hub.

Avant de commencer

La configuration de l'intégration de Autopilot (Amelia) et Knowledge Hub implique deux Appels API de Autopilot (Amelia) vers NiCE CXone. Avant de pouvoir configurer et tester ces appels, vous devez enregistrer une application avec NiCE. Effectuez les tâches suivantes pour préparer l'intégration :

  • Assurez-vous d'avoir une base DE connaissances Knowledge Hub créée et configurée dans votre système NiCE CXone. Cette opération doit être terminée par votre représentant de compte NiCE CXone.

  • Veillez à ce que Autopilot (Amelia) soit configuré et fonctionnel avant de commencer l'intégration Knowledge Hub.

  • Effectuez les tâches décrites dans le guide de mise en route pour travailler avec les API NiCE CXone.

    • L'id client et le secret doivent être transmis dans la charge utile de la demande pour obtenir un jeton. Cette opération est configurée dans les tâches 2 et 4 du guide de démarrage.
    • Les intégrations avec les API NiCE CXone doivent consommer le service de découverte. Les URL ne doivent pas être codées en dur. Ce point est couvert dans la tâche 5.
    • Vous devez découvrir l'URL de base pour les Appels API utilisés dans l'intégration. Ce point est également traité à la tâche 5. La bonne pratique consiste à effectuer l'appel de découverte avant chaque Appel API que vous effectuez. Cela vous permet de ne pas coder en dur votre URL de base. Par exemple, vous pourriez développer un Web Service Action qui exploite la découverte API et transmet l'URL de base.

Configuration de l’Intégration

Suivre ces étapes pour configurer l'intégration de Autopilot (Amelia) et Knowledge Hub.

Générer une Clé d’accès NiCE CXone

Générez une clé d'accès dans NiCE CXone. Suivez les directives de votre organisation concernant le profil d'employé à utiliser pour les jetons d'accès. Vous ne pouvez accéder à la clé secrète qu'une seule fois, veillez donc à l'enregistrer dans un emplacement sécurisé. Vous l'utiliserez à l'étape suivante.

Créer une Action de service Web pour générer un jeton

Dans Autopilot (Amelia), créez une Web Service Action pour générer un token. Vous allez configurer la Web Service Action avec le jeton d'accès et la clé secrète NiCE CXone que vous avez générés dans la tâche précédente. Le token généré par la Web Service Action sera utilisé dans les Appels API dans l'en-tête Authorization: Bearer [access token].

Donnez à ce Web Service Action un nom tel que Knowledge Hub Génération de jeton. Utilisez les informations suivantes sur le Web Service Action :

  • Demande : définissez le verbe sur POST et utilisez l'API suivante : [base URL]/auth/token.

    Modifiez l'URL en remplaçant [URL de base] par l'URL de base de votre système NiCE CXone. Vous pouvez savoir ce qu'elle est en suivant les instructions du portail développeur Icon of a square with an arrow point from the center through the top right corner. sous API Discovery.

  • En-têtes : ajoutez le paramètre suivant :

    • Clé : définissez sur Content Type.
    • Valeur : Définissez sur application/x-www-form-urlencoded).
  • Corps : Dans l'onglet Corps, collez la demande suivante et configurez :

    grant_type=password&username=[accessKeyId]&password=[accessKeySecret]&client_id=[clientId]&client_secret=[clientSecret]

    Dans la demande, configurez les paramètres comme suit :

    • grant_type : Définissez sur password.
    • password : Définissez cette valeur sur la NiCE CXone clé secrète que vous avez générée lors de la tâche précédente. Si vous avez perdu la clé secrète, vous devez supprimer la clé d’accès que vous avez générée et en créer une nouvelle.

    • username : Définissez cette valeur sur la NiCE CXone clé d’accès que vous avez générée lors de la tâche précédente.

    • client ID : Définissez cette valeur sur l’id client que vous recevez après avoir enregistré l’application auprès de NiCE. Il s’agit de la tâche 2 du guide pour le guide de prise en main Icon of a square with an arrow point from the center through the top right corner. sur le portail des développeurs.

    • client secret : Définissez cette valeur sur le secret client que vous recevez après avoir enregistré l’application auprès de NiCE. Il s’agit de la tâche 2 du guide pour le guide de prise en main Icon of a square with an arrow point from the center through the top right corner. sur le portail des développeurs.

    Un exemple de corps est le suivant :

    grant_type=password&username=MZXXK3TPO5XW4ZLU&password=K5RWKZ3FNVXW4ZLUNFXG63TPOVXW4ZOVXW633D&client_id=f47ac10b-ab12-4372-cd34-0e02b2c3d479&client_secret=aGVsbG9E9PQaBc123%3D%3D 

Créer un(e) Web Service Action pour Appel Knowledge Hub

Créez une deuxième Web Service Action dans Autopilot (Amelia) pour l'Appel API Knowledge Hub. Donnez-lui un nom qui indique qu'il s'agit de l'intégration Knowledge Hub. Par exemple, Knowledge Hub v4.

Sous Demande, ajoutez les informations suivantes dans Web Service Action :

  • Verbe : Sélectionnez POST.
  • URL : [base URL]/eai-real-time-insight/v4/direct-query

    Modifiez l'URL en remplaçant [base URL] par l'URL de base de votre système NiCE CXone.

  • En-têtes :

    • Clé : autorisation

      Valeur : Bearer [token], où vous remplacez [token] par la variable appropriée pour contenir le jeton généré par le Web Service Action que vous avez créé à l'étape précédente. Par exemple, ${token}.

    • Clé : Content-Type

      Valeur : application / json

  • Corps : Dans l'onglet Corps, collez la demande suivante :

    Assurez-vous que toutes les valeurs requises dans le corps de la demande sont correctes. Vous devrez peut-être modifier d'autres valeurs pour personnaliser l'intégration en fonction des besoins de votre organisation. Vous pouvez en savoir plus sur les champs du corps de la demande et sur la façon de les remplir.

Créer des Flux dans Autopilot (Amelia)

La dernière étape de la configuration de l'intégration consiste à créer des flux qui utilisent les Web Service Actions que vous avez créés.

  1. Dans votre console Autopilot (Amelia), créez un flux pour générer un jeton et connectez-le à l'action de génération de jeton Web Service Action que vous avez créée.

  2. Connectez l'intégration Knowledge Hub Web Service Action que vous avez créée aux flux appropriés afin de l'ajouter à vos conversations Autopilot (Amelia).

Configuration de réponse KB

Autopilot (Amelia) fournit des réponses contenant des solutions au problème du contact. Elles sont basées sur la base DE connaissancesClosed A knowledge management system that hosts knowledge articles. (KB) de votre organisation. Par exemple, si un contact indique qu'il rencontre un problème avec le produit A, la réponse suggérée pourrait être : « Réessayez de réinitialiser le produit A. Accédez aux Paramètres et cliquez sur Réinitialiser. »

Vous pouvez définir un nombre maximum de mots pour les réponses KB dans le corps de la réponse dans Autopilot (Amelia). Vous pouvez également configurer les réponses KB pour qu'elles incluent :

  • Étapes du processus : décompose les réponses de la base DE connaissances en étapes individuelles. Autopilot (Amelia)peut envoyer une étape à la fois pour guider le contact tout au long du processus de résolution de son problème.

  • Liens Web de la BC : Fournit des liens vers des articles de la BC. Autopilot (Amelia) peut envoyer ces liens au contact, qui peut ouvrir les articles dans un nouvel onglet. Vous pouvez limiter le nombre de liens pouvant être envoyés dans chaque réponse.

  • KB images : fournit des images provenant des articles de KB.Autopilot (Amelia) peut envoyer ces images aux contacts. Vous pouvez limiter le nombre d'images pouvant être envoyées dans chaque réponse.

Dans le corps de la réponse, vous devez fournir l'ID AWS Bedrock pour la base DE connaissances que vous souhaitez utiliser. Vous pouvez obtenir cet ID auprès de votre représentant de compte NiCE CXone.

Champs du Corps de la demande

Les listes déroulantes suivantes contiennent les définitions des champs du corps de la demande.