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
-
Cliquez sur le sélecteur d'applications
accédez à général et sélectionnez Automatisation. -
Dans Automatisation, sélectionnez Cognigy AI.
Ajouter un Nœud Récupérer Connaissances dans AI Agents (Cognigy)
-
Dans AI Agents (Cognigy), sélectionnez Build > Flux.
-
Dans la liste, sélectionnez le Flux que vous souhaitez modifier, par exemple SayHelloAndHandover.
-
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.
-
Dans l'éditeur de Flux, sélectionnez l'icône plus (+) à l'endroit où le nœud Récupérer Connaissances doit être ajouté.
-
Sélectionnez l'onglet By Function > catégorie CXone > Récupérer Connaissances. Le nœud est ajouté à votre flux.
-
Cliquez sur le nœud pour ouvrir le panneau Modifier le Nœud sur le côté droit.
-
Le panneau Modifier le Nœud affiche les champs configurables spécifiques au type de nœud.
-
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. |
|
| 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.
|
| 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 :
|
| 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. |
|
| 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 :
|
| 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 :
|
| 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
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.
-
Dans le panneau Modifier le Nœud, sélectionnez le nœud souhaité.
-
Cliquez sur l'icône Plus d'options
. -
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.
-
Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez supprimer.
-
Cliquez sur l'icône Plus d'options
. -
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.
-
Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez désactiver.
-
Cliquez sur l’icône Plus d’options
. -
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.
-
Dans le panneau Modifier le Nœud, sélectionnez le nœud que vous souhaitez définir comme point d'entrée.
-
Cliquez sur l’icône Plus d’options
. -
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 |