Le composant prédéfini de collecte alphanumérique collecte les séquences alphanumériques de l'utilisateur final. La longueur minimale et maximale acceptée peut être configurée via des paramètres d'entrée.
Le composant capture des fragments de caractères de l'utilisateur à chaque tour de conversation et les concatène pour former la séquence finale. La longueur minimale et maximale acceptée par fragment peut être configurée via des paramètres d'entrée.
La capture de la séquence se poursuit jusqu'à ce que l'utilisateur final indique qu'il a terminé la séquence avec une entrée correspondant à l'intent prebuilt_components_confirmation_done.
Alphabet phonétique
Ce composant est compatible avec l'utilisation d'alphabets phonétiques tels que l'alphabet phonétique de l'OTAN.
| Entrée utilisateur | Séquence capturée |
|---|---|
| alpha bravo charlie 123 | abc123 |
| A B Cat 1 2 3 | ABC123 |
| A comme amour, B comme ballon, C comme chat, un quinze | ABC115 |
Fonctionnalités supplémentaires
Ce composant prédéfini fournit les fonctionnalités supplémentaires suivantes :
Exemples de dialogues
Les exemples de boîtes de dialogue suivants illustrent des scénarios courants gérés par ce composant prédéfini. Les exemples de boîtes de dialogue illustrent le comportement lorsque le composant est appelé par téléphonie, ce qui déclenche l'intent de bienvenue par défaut et la première réponse de l'agent au début de la conversation.
Fragment unique
L'utilisateur final fournit une séquence alphanumérique en une seule fois et dit "J'ai terminé". L'agent l'accepte.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par énoncer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Bien. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Indiquez-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci pour votre confirmation. La dernière séquence alphanumérique que j'ai obtenue est fvfd3433. Est-ce correct ? | |
| oui | |
| Super, j'ai bien enregistré la séquence alphanumérique. |
Plusieurs fragments
L'utilisateur final fournit une séquence alphanumérique en deux parties, que l'agent accepte.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par énoncer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Bien. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Indiquez-moi les 1 à 8 caractères suivants de la séquence. | |
| gh67 | |
| Bien. J'ai gh67, c'est bien ça ? | |
| oui | |
| D'accord. Indiquez-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci pour votre confirmation. La séquence alphanumérique finale que j'ai obtenue est fvfd3433gh67. Est-ce correct ? | |
| oui | |
| Super, j'ai bien enregistré la séquence alphanumérique. |
Nouvelle tentative réussie
L'utilisateur final fournit une séquence alphanumérique. L'agent invite l'utilisateur final à la confirmer. L'utilisateur final répond "Non" à la confirmation et fournit à nouveau une séquence alphanumérique. L'agent l'accepte.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par énoncer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Bien. J'ai trouvé fd3433, est-ce correct ? | |
| non | |
| Désolé, pouvez-vous indiquer à nouveau les 1 à 8 premiers caractères ? | |
| fvfd3433 | |
| Bien. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Indiquez-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci pour votre confirmation. La dernière séquence alphanumérique que j'ai obtenue est fvfd3433. Est-ce correct ? | |
| oui | |
| Super, j'ai bien enregistré la séquence alphanumérique. |
Tentatives infructueuses
L'utilisateur final ne parvient pas à fournir une séquence alphanumérique de 1 à 8 caractères en trois tentatives, et le composant quitte le flux.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par prononcer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123N | |
| Bien. J'ai trouvé 123 M, est-ce correct ? | |
| non | |
| Désolé, pouvez-vous indiquer à nouveau les 1 à 8 premiers caractères ? | |
| 123N | |
| Bien. J'ai trouvé 123 M, est-ce correct ? | |
| non | |
| Veuillez nous excuser. Pouvez-vous indiquer à nouveau les 1 à 8 premiers caractères ? Veuillez épeler chaque lettre de votre séquence en utilisant un mot commençant par chaque lettre. Par exemple, si votre séquence est AB123, dites "Apple Baby 123". |
|
| 123 Nest | |
| Bien. J'ai trouvé 123N, c'est bien ça ? | |
| non | |
| Désolé, j'ai effectué trop de tentatives et je n'ai pas réussi à collecter la séquence alphanumérique. |
Alphabet phonétique
L'utilisateur final fournit une séquence alphanumérique. L'agent invite l'utilisateur final à la confirmer. L'utilisateur final répond "Non" à la confirmation deux fois de suite, la conversion phonétique est activée et l'utilisateur final fournit à nouveau une séquence alphanumérique. L'agent l'accepte.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par prononcer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123N | |
| Bien. J'ai trouvé 123 M, est-ce correct ? | |
| non | |
| Désolé, pouvez-vous indiquer à nouveau les 1 à 8 premiers caractères ? | |
| 123N | |
| Bien. J'ai trouvé 123 M, est-ce correct ? | |
| non | |
| Veuillez nous excuser. Pouvez-vous indiquer à nouveau les 1 à 8 premiers caractères ? Veuillez épeler chaque lettre de votre séquence en utilisant un mot commençant par chaque lettre. Par exemple, si votre séquence est AB123, dites "Apple Baby 123". |
|
| 123 N comme Nancy | |
| Bien. J'ai trouvé 123N, c'est bien ça ? | |
| oui | |
| D'accord. Indiquez-moi les 1 à 8 caractères suivants de la séquence. | |
| 567BC | |
| Bien. J'ai trouvé 567 av. J.-C. Est-ce correct ? | |
| c'est tout | |
| Merci pour votre confirmation. La séquence alphanumérique finale que j'ai obtenue est 123N56BC. Est-ce bien cela ? | |
| Oui. | |
| Super, j'ai bien enregistré la séquence alphanumérique. |
Longueur de séquence non valide
L'utilisateur final fournit une séquence alphanumérique dont la longueur est en dehors de la longueur minimale et maximale prédéfinie de la séquence alphanumérique. L'agent invite l'utilisateur final à recommencer, l'utilisateur final refuse et le composant quitte le flux.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Veuillez commencer par prononcer les 1 à 8 premiers caractères de la séquence alphanumérique. Une fois que vous avez terminé, dites "J'ai terminé" pour finaliser la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123 M | |
| Bien. J'ai trouvé 123 M, est-ce correct ? | |
| OK | |
| Désolé, la séquence alphanumérique que vous avez fournie ne respecte pas la longueur requise (entre 5 et 30 caractères). Voulez-vous recommencer ? | |
| non | |
| Désolé, j'ai effectué trop de tentatives et je n'ai pas réussi à collecter la séquence alphanumérique. |
Conventions d'attribution de noms
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes :
| Fonctionnalité | Format | Exemple |
|---|---|---|
| Flow | [Component Name] | Collection alphanumérique |
| Intention spécifique au composant | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_alphanumeric_collection_support_continue |
| Paramètre | [param_name] | alphanumeric_max_length |
Paramètres d'entrée
Les paramètres d'entrée sont des paramètres utilisés pour configurer certains comportements du composant. Les paramètres seront utilisés par une ou plusieurs conditions du flux pour déterminer le comportement du composant. Les paramètres limités au flux doivent être définis sur la page de démarrage du composant, comme décrit ci-dessous. Les paramètres de portée session peuvent être définis par un flux d'appel ou sur la page de démarrage de ce composant.
Vous pouvez configurer les longueurs minimale et maximale acceptées par capture et pour la séquence finale collectée en modifiant les préréglages des paramètres sur la page de démarrage du flux.
Ce composant prédéfini accepte les paramètres d'entrée suivants :
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $flow.alphanumeric_min_length | Longueur minimale de la séquence alphanumérique finale. La valeur par défaut est 1. |
entier |
| $flow.alphanumeric_max_length | Longueur maximale de la séquence alphanumérique finale. La valeur par défaut est 30. |
entier |
| $flow.lower_limit | Longueur minimale du fragment qu'un utilisateur peut fournir à chaque tour. La valeur par défaut est 1. |
entier |
| $flow.upper_limit | Longueur maximale du fragment qu'un utilisateur peut fournir à chaque tour. La valeur par défaut est 8. |
entier |
Pour configurer les paramètres d'entrée de ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Compilation.
- Cliquez sur le composant importé dans la section Flows (Flux).
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vrai) sur la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs des préréglages des paramètres si nécessaire.
- Cliquez sur Enregistrer.
Paramètres de sortie
Les paramètres de sortie sont des paramètres de session qui resteront actifs après la sortie du composant. Ces paramètres contiennent des informations importantes collectées par le composant. Ce composant prédéfini fournit des valeurs pour les paramètres de sortie suivants :
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| alphanumeric_collection_alphanumeric_sequence | Ce paramètre renvoie la séquence alphanumérique capturée par le composant. | string |
Configuration de base
Pour configurer ce composant prédéfini :
Terminé
Votre agent devrait maintenant être configuré et prêt à être testé.