Contrôles de format

Un contrôle de format (format check) vérifie un code que l'appelant dicte : une plaque d'immatriculation, un numéro de commande ou de bon, un numéro de téléphone, un SIRET, un IBAN. Vous définissez le format une fois, vous attachez le contrôle aux étapes qui recueillent ce code, et à chaque tour de parole la plateforme donne à l'agent soit la valeur propre, soit la raison pour laquelle elle est fausse.

Pourquoi l'utiliser

Un modèle d'IA compte mal les caractères d'un code dicté : quand l'appelant dit « douze, vingt-quatre, trente-six, quatre », il ne sait pas reconnaître de façon fiable un numéro à 7 chiffres, ni voir qu'il manque une lettre à une plaque. Le contrôle de format fait cette partie exactement, sans délai supplémentaire : l'agent peut confirmer tout de suite une bonne valeur, ou redemander la partie erronée.

Étape 1 : créer le contrôle

Les contrôles appartiennent à un compte et peuvent être utilisés par tous les agents de ce compte. Ouvrez Accounts, choisissez le compte, puis l'onglet Format checks, et cliquez sur Add a format check.

Création d'un contrôle de format : the repair ticket number, motif AA-9999, essayé avec une valeur valide et une invalide gardées comme exemples, puis enregistré
  1. What is being checked : une courte expression, comme dans une phrase, par exemple le numéro de bon de réparation. L'Identifier se remplit tout seul.
  2. Type of format : choisissez l'un des trois types décrits plus bas.
  3. How the valid value is written : Grouped (AT-2041, 06 85 26 48 41) ou Compact (AT2041). C'est la valeur que reçoivent l'agent et vos variables.
  4. When the check runs : gardez Automatic (recommended) sauf raison particulière (voir plus bas).
  5. Try it : tapez ce qu'un appelant dirait, comme il le dirait, par exemple A T 2 0 4 1. Vous voyez tout de suite si c'est valide et la valeur propre, ou la raison du refus. Cliquez sur Keep as example pour garder les cas à retester plus tard (jusqu'à 10).
  6. Cliquez sur Save.

Les modifications s'appliquent dès l'appel suivant. Comme les web services, les contrôles de format ne font pas partie des versions d'un agent : une modification touche tous les agents qui utilisent le contrôle dès l'appel suivant, sans republier. Un compte peut avoir jusqu'à 50 contrôles.

Types de format

TypeCe qu'il accepte
Ready-made formatPlaque d'immatriculation française (AB-123-CD), numéro de téléphone français (10 chiffres commençant par 0, +33 accepté), code postal français (5 chiffres), SIRET (14 chiffres), SIREN (9 chiffres), IBAN. Le SIRET, le SIREN et l'IBAN vérifient aussi leur clé de contrôle : un chiffre erroné est détecté.
Number of digitsExactly N chiffres, ou Between deux nombres (de 1 à 34). Pour les numéros de commande, de mission ou de client.
PatternLettres et chiffres dans un ordre fixe. A = une lettre, 9 = un chiffre, * = une lettre ou un chiffre. Toute autre lettre ou tout autre chiffre doit figurer tel quel (MIS-9999 = MIS puis 4 chiffres). Un tiret ou un espace indique seulement comment grouper le code. Exemple : AA-9999 accepte AT-2041.

Étape 2 : l'attacher à une étape

Un contrôle ne s'exécute que sur les étapes auxquelles il est attaché. Attachez-le à l'étape qui demande le code : une étape Agent, ou l'étape de départ.

Ouverture d'une étape Agent, onglet Connections, case the repair ticket number cochée sous Format checks et essai d'une valeur
  1. Dans l'éditeur de flow, ouvrez l'étape et allez dans l'onglet Connections.
  2. Sous Format checks, cochez les contrôles qui correspondent à ce que l'étape recueille (jusqu'à 10 par étape).
  3. Facultatif : Save a valid value into une variable du workflow. Quand l'appelant donne un code valide, il y est enregistré, déjà nettoyé.
  4. Facultatif : utilisez la case Try it pour tester le contrôle depuis l'étape.
  5. Cliquez sur OK, puis enregistrez l'agent et mettez la version en ligne.

N'attachez que les contrôles que l'étape recueille vraiment. Deux contrôles composés uniquement de chiffres sur la même étape (un numéro de bon à 7 chiffres et un code postal à 5 chiffres, par exemple) peuvent réagir tous les deux à la même réponse.

Étape 3 : dire à l'agent quoi faire du résultat

Le contrôle ne décide pas de la suite : c'est votre prompt qui le fait. À chaque tour de parole, l'agent voit le verdict à côté de ce qu'a dit l'appelant, dans la langue de l'appel : la valeur propre, ou la raison du refus (« Il faut 6 caractères... »). Les verdicts précédents restent dans la conversation, ce qui permet d'écrire des règles qui comptent les échecs. Par exemple, dans le prompt de l'étape :

Demande le numéro du bon de réparation.
Si le contrôle dit qu'il est valide, répète-le et continue.
S'il n'est pas valide, explique brièvement ce qui ne va pas et redemande-le.
Après deux réponses invalides, demande plutôt le modèle du vélo et le nom inscrit sur le bon.

Ne demandez pas à l'agent de « remplir » une variable dans le prompt : utilisez plutôt Save a valid value into sur l'étape.

Quand le contrôle s'exécute

ChoixCe qui se passeÀ utiliser quand
Automatic (recommended)La plateforme contrôle chaque tour de l'appelant qui ressemble à un code, sans délai supplémentaire. Un simple « oui, c'est ça » est ignoré.Presque toujours.
ToolL'agent appelle lui-même le contrôle, comme un outil. Cela ajoute environ une seconde avant qu'il ne parle.L'agent doit d'abord reconstituer la valeur : dite en toutes lettres (« quatre cent douze ») ou répartie sur plusieurs tours.
BothAutomatique à chaque tour, et aussi proposé à l'agent comme outil.Cas mixtes.

La Note for the agent facultative est ajoutée à la description de l'outil : elle ne sert donc qu'en mode Tool ou Both.

Voir les résultats

Sur la page d'un appel dans Appels, chaque verdict apparaît sur une ligne sous le message de l'appelant qu'il a jugé, par exemple Check the_repair_ticket_number: AT-2041, ou la raison quand la valeur n'était pas valide. Un verdict demandé par l'agent lui-même est marqué (called by the agent).

Bon à savoir

  • L'agent doit appartenir à un compte : un agent sans compte n'a pas de contrôles de format.
  • L'épellation phonétique est comprise (« G comme Georges »). Les lettres écrites en toutes lettres et les nombres dits en mots ne sont pas convertis en mode automatique : utilisez le mode Tool si vos appelants parlent ainsi.
  • Le mode automatique ne lit que le tour en cours. Un code donné en plusieurs morceaux sur plusieurs tours nécessite le mode Tool.
  • Renommer l'identifiant d'un contrôle le détache de toutes les étapes qui utilisaient l'ancien.