Utiliser les Requêtes dans la recherche

Lorsque vous examinez les conversations dans la section Insights ou dans la boîte de réception NLU, ou lorsque vous parcourez les compétences dans le Skill Store, vous pouvez utiliser la barre de recherche pour restreindre les résultats. Vous pouvez effectuer des recherches de base en langage naturel ou rédiger des requêtes dans le langage de requête. Ce type de requête comporte trois parties de base :

  • Paramètre
  • Operator (Opérateur)
  • Valeur

Pour créer une requête simple, commencez par un paramètre et la valeur souhaitée, puis placez l'opérateur approprié entre les deux. Vous pouvez créer des requêtes plus complexes en utilisant un opérateur supplémentaire pour combiner deux ou plusieurs requêtes simples.

Akela veut retrouver toutes les conversations qui se sont terminées par un transfert à un agent. Elle utilise le paramètre action, la valeur handover et l'opérateur =.

Sa requête complète ressemble à ceci :

action = handover

Malheureusement, cette requête a renvoyé trop de résultats pour qu'Akela puisse les examiner facilement. Elle décide de restreindre cette recherche pour ne voir que les résultats des deux dernières semaines. Elle ajoute une deuxième requête simple à sa requête d'origine et les combine avec l'opérateur AND.

Sa requête complète ressemble maintenant à ceci :

action = handover AND datetime > -14 days

Paramètres et valeurs pris en charge

Le tableau suivant présente en détail tous les paramètres pris en charge, la façon de les utiliser, ainsi que les sections de Bot Builder qui prennent en charge chacun d'eux.

Paramètre Détails Pris en charge dans
action

Le nom que Bot Builder utilise pour une action. Les valeurs prises en charge sont :

  • integration
  • handover
  • core_fallback
  • fill_slot
bot_message_count Le nombre de messages sortants dans la conversation. Les valeurs de ce paramètre doivent être au format numérique.
Catégorie Permet de filtrer les compétences de robots répertoriées en fonction de la catégorie à laquelle elles sont rattachées.
Canal

Le nom, le type ou l'ID d'un canal. Vous n'obtiendrez des résultats que pour les canaux que vous avez configurés dans Digital Experience (DX).

Les valeurs prises en charge sont :

  • apple-business
  • facebook-dm
  • twitter-dm
  • vkontakte-dm
  • live-chat
  • chat
  • line
  • slack
  • sms
  • teams
  • telegram
  • viber
  • whatsapp
  • talk-to-your-bot
  • talk-to-your-bot-public
conversation ID d'une conversation.
client Le nom ou l'ID d'un client.
customer_contact L'id du contact (aussi appelé id de cas) provenant de NiCE CXoneDigital Experience (DX).
customer_message_count Nombre de messages entrants dans la conversation. Les valeurs de ce paramètre doivent être au format numérique.
date

Date qui n'inclut pas d'heure précise. Lorsque ce paramètre est utilisé, toute valeur d'heure est automatiquement définie à 00:00:00. Les valeurs de ce paramètre peuvent être absolues ou relatives.

datetime

Date et heure. Les valeurs de ce paramètre peuvent être absolues ou relatives.

Les formats pris en charge pour les dates absolues sont :

  • États-Unis — le 2 janvier s'écrit numériquement 01/02/2023
  • Europe — le 2 janvier s'écrit numériquement 02/01/2023
  • Format écrit — 2 janvier2023 ou 2 janvier2023

Les valeurs prises en charge pour les dates relatives sont :

  • now
  • - (soustraire/subtract) — secondes, minutes, jours, mois, années (seconds, minutes, days, months, years)
  • + (ajouter/add) — secondes, minutes, jours, mois, années (seconds, minutes, days, months, years)
  • précédent (previous) — seconde, minute, heure, jour, mois, année, jour de la semaine, semaine, quinzaine, nom du jour au format lundi ou lun (second, minute, hour, day, month, year, weekday, week, fortnight, day name in format Monday or Mon)
  • suivant (next) — seconde, minute, heure, jour, mois, année, jour de la semaine, semaine, quinzaine, nom du jour au format lundi ou lun (second, minute, hour, day, month, year, weekday, week, fortnight, day name in format Monday or Mon)
  • demain/tomorrow (maintenant + 24 heures)
  • hier/yesterday (maintenant - 24 heures)
  • midi (noon)
  • après-midi (afternoon)
  • minuit (midnight)
  • dernier (last) — nom du jour au format lundi ou lundi
  • premier jour de ce/mois suivant (first day of this/next — month)
  • dernier jour de ce/prochain — mois (last day of this/next — month)
fulltext Si vous créez une requête avec un langage de requête, ce paramètre vous permet d'y ajouter un langage naturel.

Intention

Le nom d'une intention que vous avez créée.
intention_confiance

Degré de confiance de Bot Builder quant à la classification correcte de l'intention. Les valeurs prises en charge vont de 0 à 0,99, comme lors de la conception du Repli.
is_reviewed État de révision d'une conversation. Les valeurs de ce paramètre sont true (a été révisée) ou false (n'a pas été révisée).
Langue Permet de filtrer les compétences de robots répertoriées en fonction de la langue pour laquelle elles sont définies.
message_count Nombre total de messages dans la conversation. Ce nombre inclut les messages entrants et sortants. Les valeurs de ce paramètre doivent être au format numérique.
balise Affiche les conversations en fonction des balises appliquées ou non. Ce paramètre fonctionne avec tous les opérateurs disponibles.

Opérateurs pris en charge

Le tableau suivant présente tous les opérateurs pris en charge et décrit leur signification.

Operator (Opérateur) Description
= Représente « égal à »
!= Représente « pas égal à »
< Représente « moins que »
<= Représente « inférieur ou égal à »
> Représente « supérieur à »
>= Représente « supérieur ou égal à
AND (ET)

Renvoie les conversations où les valeurs des deux côtés correspondent.

Par exemple, la requête suivante renvoie les conversations SMS qui ont été transmises à un agent :

channel = sms AND action = handover

OU

Renvoie les conversations où au moins une valeur de chaque côté correspond.

Par exemple, la requête suivante renvoie toutes les conversations SMS et toutes les conversations WhatsApp :

channel = sms OR channel = whatsapp
PAS (NOT)

Renvoie les conversations où la valeur ne correspond pas.

Par exemple, la requête suivante renvoie toutes les conversations qui n'étaient pas dans le canal SMS :

NOT channel = sms
IN (DANS)

Renvoie les conversations dont la valeur correspond à au moins une option de la liste.

Par exemple, la requête suivante renvoie toutes les conversations dans les canaux SMS et WhatsApp :

channel IN (sms, whatsapp)
( )

Vous aide à organiser une requête complexe et à attribuer une priorité en fonction du concept mathématique général selon lequel les éléments entre parenthèses sont traités en premier.

Par exemple, la requête suivante renvoie à la fois les conversations SMS qui ont été transmises à un agent et les conversations WhatsApp avec plus de quatre messages :

(action = handover AND channel = sms) OR (message_count < 4 AND channel = whatsapp)

Exemples de requêtes supplémentaires

Toutes les Conversation d’aujourd’hui :

datetime > midnight

Toutes les conversations d'un jour spécifique :

datetime >= 2nd Jan 2021 AND datetime < 3rd Jan 2021

Toutes les conversations sur les canaux SMS où elles ont été transmises à un agent en direct ont eu lieu :

channel = sms AND action = handover

Toutes les conversations depuis les canaux SMS ou Whatsapp :

channel = sms OR channel = whatsapp

Toutes les conversations sur les canaux WhatsApp ou SMS, des 30 derniers jours, et elles sont considérées comme abandonnées (moins de 3 messages) ou elles ont été transmises à l'agent en direct :

channel IN (whatsapp, sms) AND datetime > -30 days AND (message_count < 3 OR action = handover)