Ajouter un Nœud Récupérer Connaissances dans AI Agents (Cognigy)

Les nœuds d'un flux AI Agents (Cognigy) représentent des actions ou une logique que votre agent virtuel exécute. La modification d'un nœud vous permet de configurer ses propriétés, de mettre à jour les paramètres ou d'ajuster son comportement au sein du flux.

Le nœud Récupérer les Connaissances permet à l'AI Agents (Cognigy) de récupérer des informations pertinentes à partir des sources de connaissances connectées, telles que Knowledge Hub, au cours d'une interaction. Il traite la requête de l'utilisateur, effectue une recherche dans la base DE connaissances configurée et renvoie le contenu le plus pertinent afin de générer des réponses exactes et adaptées au contexte.

Pour un flux donné, vous pouvez configurer un seul nœud Récupérer Connaissances, qui peut être lié à une seule base DE connaissances Knowledge Hub. La configuration de plusieurs nœuds de connaissances au sein du même flux n'est actuellement pas prise en charge.

Lancer AI Agents (Cognigy) via NiCE CXone

  1. Cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background accédez à général et sélectionnez Automatisation.

  2. Dans Automatisation, sélectionnez Cognigy AI.

Ajouter un Nœud Récupérer Connaissances dans AI Agents (Cognigy)

  1. Dans AI Agents (Cognigy), sélectionnez Build > Flux.

  2. Dans la liste, sélectionnez le Flux que vous souhaitez modifier, par exemple SayHelloAndHandover.

  3. Si le projet contient plusieurs flux, sélectionnez Main Flow dans le sélecteur de Flux en haut. Le flux s'ouvre dans la vue Chart, où vous pouvez ajouter et configurer des nœuds.

  4. Dans l'éditeur de Flux, sélectionnez l'icône plus (+) à l'endroit où le nœud Récupérer Connaissances doit être ajouté.

  5. Sélectionnez l'onglet By Function > catégorie CXone > Récupérer Connaissances. Le nœud est ajouté à votre flux.

  6. Cliquez sur le nœud pour ouvrir le panneau Modifier le Nœud sur le côté droit.

  7. Le panneau Modifier le Nœud affiche les champs configurables spécifiques au type de nœud.

  8. Pour un nœud Récupérer les Connaissances, vous verrez les champs suivants :

Nom du champ

Définition

notes

ID Knowledgehub Entrée l'ID Knowledge Hub depuis Knowledge Hub de AI Studio. Chaque base DE connaissances possède un ID Knowledge Hub unique que vous pouvez copier et coller ici. Cet ID détermine quelle source de connaissances sera utilisée pour récupérer les réponses.
  1. Accédez à AI Studio > Knowledge Hub.

  2. Sélectionnez l'icône Autres actions More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point en regard de la base DE connaissances appropriée.

  3. Depuis le menu, sélectionnez l'option Copy KB ID.

Saisie de la requête Indique la question de l'utilisateur final qui sera utilisée pour rechercher une réponse dans la base DE connaissances.
Requête
Requête Persona Décrit la persona que vous souhaitez que l'IA adopte lors de la génération du résumé. N'utilisez pas ce champ si vous utilisez Prompt Éditeur et avez défini un Id profil du Gestionnaire d’invites, car le Gestionnaire d’invites dispose déjà d'un persona configuré.
Langage de requête Sélectionnez la langue du résumé généré. Ce paramètre n'affecte que la langue de sortie.

Sélectionnez la langue dans laquelle vous souhaitez que le LLM réponde.

Le champ Query Language permettant de sélectionner la langue dans laquelle le LLM répond

Knowledge Hub
Filtre Précisez des critères pour sélectionner les articles de connaissances à inclure dans le Knowledge Hub, en fonction de leurs métadonnées.

Définit des filtres de récupération basés sur JSON qui appliquent des conditions d'attribut pour restreindre les documents renvoyés, prenant en charge des conditions simples et des groupes logiques imbriqués à l'aide de andAll/orAll. Prend en charge plusieurs opérateurs (equals, notEquals, comparaisons numériques, in/notIn, startsWith) sur les attributs de type chaîne, nombre et booléen, afin de vous permettre de créer des filtres simples ou complexes, comme,

{
"equals":
{
"key":"PageRestriction",
"value":"Public"
}
}

Pour plus de détails, reportez-vous à la section Filtre Opérateur.

Max Articles Définit le nombre maximum d'articles à récupérer dans la base DE connaissances pour générer la réponse.  
Invite Crée une invite personnalisée pour contrôler le ton et fournir un contexte pour votre base DE connaissances. N'utilisez pas ce champ si vous utilisez Prompt Editor et que vous avez défini un « Prompt Manager Profile ID ».  
ARN du modèle Sélectionnez le modèle LLM à utiliser pour générer la réponse de connaissances.

Les options disponibles sont amazon.nova-pro-v1:0, amazon.nova-lite-v1:0, et anthropic.claude-haiku-4-5-20251001-v1:0.

Si vous utilisez l'ID du Gestionnaire d'invites, vous n'avez pas besoin du Model ARN dans ce champ, car les gestionnaires d'invites ont déjà sélectionné des modèles suivants :

  • Nova Pro

  • Nova Lite

  • Claude 4.5 Haiku

  • Claude 3.5 Haiku

Réponses de la base DE connaissances
Id profil gestionnaire d’invites Entrée l’id profil issu du Gestionnaire d’invites de AI Studio. Cela vous permet de gérer et de modifier votre invite directement dans Prompt Manager.
  1. Accédez à AI Studio > GenAI Prompts.

  2. Ouvrez Copilot for Agents > réponses de la base DE connaissances.

  3. Sélectionnez l'icône Autres actions More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point à côté du profil Prompt de réponse KB approprié.

  4. Sélectionnez Copy ID dans le menu.

Nombre maximal de Mots pour les réponses Définissez la longueur maximale pour la réponse de connaissances générée.  
Max Liens Définit le nombre maximal de liens de citation à inclure dans la réponse générée.  
Résultat Stockage
Stockage des résultats Précisez où le contenu récupéré doit être stocké.
Nom DE variable Entrée du nom de la variable dans laquelle le contenu stocké sera sauvegardé.

La réponse du LLM est stockée dans cette Variable, et les valeurs sont affichées dans le chat en fonction des Configurations illustrées dans la capture d'écran.

Nœud Say :

Les paramètres Output Type dans la configuration du nœud Retrieve Knowledge

Gestion des erreurs
Enregistrer dans le Système Activer la journalisation des erreurs dans les journaux système. Les journaux peuvent être consultés sur la Page Logs de votre Projet. Le paramètre est inactif par défaut.
Sélectionnez l'approche de gestion des erreurs Définir comment gérer les erreurs qui se produisent pendant la demande.

En fonction de vos besoins, vous pouvez sélectionner l'une des options de gestion des erreurs suivantes :

  • Arrêter l'Exécution du Flux : Terminer l'exécution du Flux en cours.

  • Continuer l'Exécution du Flux : permet au Flux de continuer à s'exécuter, en contournant l'erreur et en passant aux étapes suivantes.

  • Aller au Nœud : rediriger le flux de travail vers un Nœud spécifique du Flow, ce qui peut être utile pour la récupération après erreur ou pour une gestion personnalisée des erreurs.

Message d’erreur (En option) Entrée un message personnalisé à afficher en cas d'erreur. Ce champ est en option. Ce paramètre est actif lorsque l'option continue Flow Execution de Select Error Handling Approach est sélectionnée. Message En option à générer en sortie en cas d'échec de la récupération des connaissances.
Paramètres de déboguage
Déboguer les Paramètres Pour des raisons de performances, la journalisation de déboguage ne sera active que lors des tests à partir du panneau d'interaction et lorsque le mode déboguer est activé dans celui-ci.  
Journaliser le Corps de la Demande Activez ou désactivez la journalisation du corps de la demande envoyée à Knowledge Hub.  
Log Demande Activez ou désactivez la journalisation du temps nécessaire à l'achèvement de la demande.  
Latence Mocking Entrée du code simulé à utiliser lorsque le mocking est activé pour le Nœud. La simulation permet de modifier le comportement d'un Nœud en remplaçant sa logique par du code de simulation sans modifier les paramètres d'origine du Nœud. Cette approche vous permet de conserver la logique de Flux d'origine et de simuler les comportements des Nœuds afin de tester des conditions de Flux spécifiques dans le Simulateur, le Panneau d'interaction et les points de terminaison sans avoir à reconfigurer les Nœuds. La simulation fournit le champ Mock Code dans les paramètres de chaque Nœud dans l'éditeur de Nœuds. Ce champ prend en charge le code JavaScript pour accéder aux objets Saisie, Contexte et Profil, ainsi qu'à la fonction API.say. Le code de simulation remplace entièrement la logique d'exécution du Nœud configuré au moment de l'exécution. Pour plus de détails, reportez-vous au sujet Mocking.
Paramètres
Étiquette Définit un nom personnalisé du Nœud.  
Commentaire Champ de texte libre.  
Analytics Étape L'Étape est enregistrée dans Cognigy Insights et le terminal OData de Cognigy.AI, une fois que le Nœud est franchi  

Gérer les options du Nœud dans le panneau Modifier le Nœud

Utilisez le menu Plus d’options More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point dans le panneau Modifier le Nœud pour effectuer des actions supplémentaires sur un nœud. Ces actions vous permettent de copier des identifiants, de gérer l’état du nœud ou de définir le point de départ d’un flux.

Copier un ID de Nœud

Copiez l'identifiant unique d'un nœud à utiliser dans les Appels API ou pour le débogage.

  1. Dans le panneau Modifier le Nœud, sélectionnez le nœud souhaité.

  2. Cliquez sur l'icône Plus d'options Icône Plus d'options qui ouvre un menu contenant des actions supplémentaires pour l'élément sélectionné, telles que copier l'ID, supprimer, désactiver ou définir comme point d'entrée.

  3. Sélectionnez Copier l'id du Nœud.

    L'ID du nœud est copié dans votre presse-papiers.

Supprimer un Nœud

Supprimer définitivement le nœud du flux.

  1. Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez supprimer.

  2. Cliquez sur l'icône Plus d'options More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point.

  3. Sélectionnez supprimer.

    Confirmez la suppression lorsque vous y êtes invité.

    Suppression en cours d'un nœud ne peut pas être annulée. Recréez le nœud si nécessaire.

Désactiver un Nœud

Désactivez temporairement un nœud sans le retirer du flux.

  1. Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez désactiver.

  2. Cliquez sur l’icône Plus d’options Icône Plus d’options qui ouvre un menu proposant des actions supplémentaires pour l’élément sélectionné, telles que copier l’ID, supprimer, désactiver ou définir comme point d’entrée .

  3. Sélectionnez désactiver.

    Le nœud reste dans le flux, mais ne s'exécutera pas jusqu'à ce que vous l'activiez de nouveau.

Définir un Nœud comme point d'entrée

Définissez un nœud comme point de départ pour le flux.

  1. Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez définir comme point d'entrée.

  2. Cliquez sur l’icône Plus d’options Icône Plus d’options qui ouvre un menu avec des actions supplémentaires pour l’élément sélectionné, telles que copier l’ID, supprimer, désactiver ou définir comme point d’entrée.

  3. Sélectionnez Set Entrypoint.

    Le flux démarrera à partir de ce nœud au lieu du nœud de démarrage par défaut.

Opérateur de filtre

Cette section traite de la syntaxe généralisée pour les opérateurs uniques et Multiple :

  • Condition unique

{"<operator>": {
"key": "<metadata-key>",
"value": <value>
}
}
  • Multiple Les conditions — ET (toutes doivent correspondre)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • Multiple Les conditions — OU (une seule doit correspondre)

{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • Imbriqué — ET avec OU à l'intérieur (logique complexe)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
]
}
  • Opérateurs valides — Remplacez <operator> par l'un des éléments suivants :

Console Symbole

Nom du Filtre API (<operator>)

Type de données prise en charge

Anglais simple

=

équivaut à Chaîne, Nombre, Booléen Est exactement égal à

!=

N'est pas égal à Chaîne, Nombre, Booléen N'est pas égal à

^

S'il commence par Chaîne, Nombre, Booléen Commence avec

>

greaterThan Numéro Est supérieur à

>=

supérieur ou égal à Numéro Est supérieur ou égal à

<

Inférieur à Numéro Est inférieur à

<=

≤ (inférieur ou égal) Numéro Est inférieur ou égal à

:

dans Chaîne list Fait partie de la liste

!:

notIn Liste de chaîne N'est pas l'un de la liste
  • Référence de substitution

Espace réservé remplacer par

<operator>

Tout nom de Filtre d'API du tableau ci-dessus

<metadata-key>

Uri, Titre, PageRestriction, Balises, etc. (sensible à la casse)

<value> (Chaîne)

« Public »

<value> (Number)

2023

<value> (Booléen)

vrai ou faux

<value> (String list)

["value1", "value2"] — uniquement pour in et notIn
  • <metadata-key>: Définit dans le Knowledge Hub. Cette valeur peut varier selon le connecteur KMS.

  • <Value> : doit correspondre à la valeur envoyée par le KMS.

andAll et orAll requièrent un minimum de deux conditions à l'intérieur du tableau.

  • Référence des opérateurs valides

Nom du Filtre API

(<opérateur>)

Type de données prises en charge Sens

égale

Chaîne, Number, Boolean Est exactement égal à

notEquals

Chaîne, Number, Boolean N'est pas égal à

startsWith

Chaîne, nombre, booléen Commence avec

Supérieur à

Numéro Est supérieur à

supérieur(e) ou égal(e) à

Numéro

Est supérieur ou égal à

Inférieur à

Numéro Est inférieur à

Inférieur ou égal à

Numéro Est inférieur ou égal à

dans

Chaîne list Fait partie de la liste

notIn

Chaîne list N'est pas l'un des éléments de la liste