Pour afficher cette page en anglais :
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 des paramètres ou d'ajuster son comportement au sein du flux.
Le nœud Récupérer les Connaissances permet à AI Agents (Cognigy) de récupérer des informations pertinentes à partir de sources de connaissances connectées, telles que Knowledge Hub, pendant 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 uniquement un 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'application
, accédez à général, puis sélectionnez Automation. -
Dans Automatisation, sélectionnez Cognigy AI.
Ajouter le Nœud Récupérer les 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 Flux principal dans le sélecteur de flux en haut. Le Flux s'ouvre dans la vue Graphique, 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 les Connaissances doit être ajouté.
-
Sélectionnez l’onglet Par Fonction > 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 Connaissances, les champs suivants s’affichent :
|
Nom du champ |
Définition |
notes |
|---|---|---|
| ID Knowledgehub | Entrée l'ID Knowledge Hub à partir de 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 la source de connaissances qui sera utilisée pour récupérer les réponses. |
|
| Requête de saisie | Indique la question de l'utilisateur final qui sera utilisée pour rechercher une réponse dans la base DE connaissances. |
|
| Requête | ||
| Persona de requête | Décrit le persona que vous souhaitez que AI adopte lors de la génération du résumé. | N'utilisez pas ce champ si vous utilisez l'Éditeur Prompt et avez défini un Id profil du Gestionnaire d'invites, car le Gestionnaire d'invites y a déjà configuré un persona. |
| Langue de requête | Sélectionnez la langue du résumé généré. Ce paramètre affecte uniquement la langue de sortie. |
Sélectionnez la langue dans laquelle vous souhaitez que le LLM réponde.
|
| Knowledge Hub | ||
| Filtre | Préciser 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 afin de restreindre les documents renvoyés, en prenant en charge les conditions uniques et les 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 que vous puissiez créer des filtres simples ou complexes comme, {"equals": {"key":"PageRestriction", "value":"Public" } } Pour en savoir plus, reportez-vous à la Section Opérateur de Filtre. |
| Max Articles | Définit le nombre maximum d'articles à récupérer depuis la base DE connaissances pour générer la réponse. | |
| Prompt | 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 l’Éditeur et avez défini un « Id profil » du Gestionnaire d’invites. | |
| ARN du modèle | Sélectionnez le modèle LLM à utiliser pour générer la réponse 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 de l’ARN du modèle 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 depuis le Gestionnaire d’invites de AI Studio. Cela vous permet de gérer et de modifier votre invite directement dans le Gestionnaire d’invites. |
|
| Nombre maximal de Mots pour les réponses | Définissez la longueur maximum de la réponse connaissances générée. | |
| Max Liens | Définit le nombre maximum de liens de citation à inclure dans la réponse générée. | |
| Stockage des résultats | ||
| Stockage des résultats | Préciser l'emplacement où le contenu récupéré doit être stocké. |
|
| Nom DE variable | Entrez le 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 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électionner l'approche de gestion des erreurs | Définissez comment gérer les erreurs qui se produisent pendant la demande. |
En fonction de votre besoin, vous pouvez sélectionner une des options de traitement 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 continuer l'Exécution du Flux dans Select Error Handling Approach est sélectionnée. Message En option à générer en sortie si la récupération des connaissances échoue. |
| Déboguer les Paramètres | ||
| Paramètres déboguer | Pour des raisons de performance, la journalisation de débogage ne sera active que lors des tests effectués depuis le panneau d'interaction et lorsque le mode déboguer y est activé. | |
| Journaliser le Corps de la Demande | Activez ou désactivez la journalisation du corps de la demande envoyé au Knowledge Hub. | |
| Demande de journal | Activez ou désactivez la journalisation du temps nécessaire pour que la demande soit terminée. | |
| Simulation de la \n\nLatence | Entrée le code fictif à utiliser lorsque le mocking est activé pour le Nœud. | Le mocking vous permet de modifier le comportement d'un Nœud en remplaçant sa logique par un code simulé (mock) 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. Le mocking fournit le champ Mock Code dans les paramètres de chaque Nœud, dans l'éditeur de Nœud. 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 simulé remplace entièrement la logique d'exécution configurée du Nœud 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 passé | |
Gérer les Options de 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
Copier l'identifiant unique d'un nœud à utiliser dans les Appels API ou pour le débogage.
-
Dans le panneau Edit 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 de 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é.
La suppression en cours d'un nœud est irréversible. Recréez le nœud si nécessaire.
Désactiver un Nœud
Désactivez temporairement un nœud sans le supprimer 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 il 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 simples et multiples :
-
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> } }]
}
]
}
-
Les opérateurs valides — Remplacez <operator> par un des éléments suivants :
|
Console Symbole |
Nom du Filtre API (<operator>) |
Type de données pris en charge |
Plain Anglais |
|---|---|---|---|
|
= |
Égale | Chaîne, Nombre, Booléen | Est exactement égal à |
|
!= |
notEquals | Chaîne, Nombre, Booléen | N'est pas égal à |
|
^ |
startsWith | Chaîne, Nombre, Booléen | Commence avec |
|
> |
supérieur à | Numéro | Est supérieur à |
|
>= |
supérieur ou égal à | Numéro | Supérieur ou égal à |
|
< |
moins que | Numéro | Est inférieur à |
|
<= |
Inférieur ou égal à | Numéro | Est inférieur ou égal à |
|
: |
dans | Liste de chaînes | Fait partie de la liste |
|
!: |
notIn | Liste de chaînes | N'est pas l'un des éléments 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> (String) |
« Public » |
|
<valeur> (Nombre) |
2023 |
|
<value> (Boolean) |
vrai ou faux |
|
<value> (String list) |
« valeur1 », « valeur2 » — 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 nécessitent un minimum de deux conditions dans le tableau.
-
Référence des opérateurs valides
|
Nom du Filtre API (<operator>) |
Type de données prises en charge | Sens |
|---|---|---|
|
equals |
Chaîne, Nombre, Booléen | Est exactement égal à |
|
Différent de |
Chaîne, Nombre, Booléen | Est différent de |
|
startsWith |
Chaîne, Nombre, Booléen | Commence avec |
|
greaterThan |
Numéro | Est supérieur à |
|
supérieur ou égal à |
Numéro |
Est supérieur ou égal à |
|
moins que |
Numéro | Est inférieur à |
|
inférieur ou égal à |
Numéro | Est inférieur ou égal à |
|
dans |
Liste de chaînes | Fait partie de la liste |
|
notIn |
Liste de chaînes | N'appartient pas à la liste |