Le composant prédéfini de la collection alphanumérique collecte les séquences alphanumériques de l'utilisateur final. Les longueurs minimale et maximale acceptées peuvent être configurées via des paramètres d'entrée.
Le composant capture des blocs de caractères de l'utilisateur à chaque tour de conversation et les concatène pour former la séquence finale. Les longueurs minimale et maximale acceptées pour chaque fragment peuvent être configurées 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 des alphabets phonétiques, comme 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 pomme, B comme banane, C pour piment, un quinze | ABC115 |
Fonctionnalités supplémentaires
Ce composant prédéfini offre les fonctionnalités supplémentaires suivantes:
Exemples de boîtes de dialogue
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éphone, ce qui déclenche l'intent d'accueil 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 dans un bloc et dit "J'ai terminé". L'agent l'accepte avec succès.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Merci. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Dites-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci de votre confirmation. La séquence alphanumérique finale que j'ai reçue est fvfd3433. C'est bien cela ? | |
| oui | |
| Fantastique, j'ai collecté la séquence alphanumérique. |
Plusieurs fragments
L'utilisateur final fournit une séquence alphanumérique en deux fragments. L'agent l'accepte avec succès.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Merci. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Dites-moi les 1 à 8 caractères suivants de la séquence. | |
| gh67 | |
| Merci. J'ai le gh67, c'est bien ça ? | |
| oui | |
| D'accord. Dites-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci de votre confirmation. La dernière séquence alphanumérique que j'ai reçue est fvfd3433gh67, c'est bien cela ? | |
| oui | |
| Fantastique, j'ai collecté la séquence alphanumérique. |
Nouvelle tentative réussie
L'utilisateur final fournit une séquence alphanumérique. L'agent l'invite à nouveau à la confirmer. L'utilisateur final répond "Non" à la confirmation et affiche à nouveau une séquence alphanumérique ; l'agent l'accepte avec succès.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| fvfd3433 | |
| Merci. J'ai trouvé fd3433, c'est bien cela ? | |
| 0 | |
| Désolé, pouvez-vous de nouveau saisir les 1 à 8 premiers caractères ? | |
| fvfd3433 | |
| Merci. J'ai fvfd3433, c'est bien ça ? | |
| oui | |
| D'accord. Dites-moi les 1 à 8 caractères suivants de la séquence. | |
| Je n'ai plus besoin d'aide | |
| Merci de votre confirmation. La séquence alphanumérique finale que j'ai reçue est fvfd3433. C'est bien cela ? | |
| oui | |
| Fantastique, j'ai collecté la séquence alphanumérique. |
Nouvelles tentatives infructueuses
L'utilisateur final ne peut pas fournir une séquence alphanumérique de 1 à 8 caractères après trois tentatives, et le composant quitte le flux.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123N | |
| Merci. J'ai atteint 123 M, c'est bien cela ? | |
| 0 | |
| Désolé, pouvez-vous de nouveau saisir les 1 à 8 premiers caractères ? | |
| 123N | |
| Merci. J'ai atteint 123 M, c'est bien cela ? | |
| 0 | |
| Désolé, pouvez-vous indiquer de nouveau les 1 à 8 premiers caractères ? Veuillez épeler chaque lettre de votre séquence par un mot commençant par chaque lettre. Par exemple, si votre séquence est AB123, dites "Apple Baby 123". |
|
| 123 Nest | |
| Merci. J'ai reçu 123N, c'est bien ça ? | |
| 0 | |
| Malheureusement, le nombre de tentatives autorisées est dépassé. Échec de la collecte de la séquence alphanumérique. |
Alphabet phonétique
L'utilisateur final fournit une séquence alphanumérique. L'agent l'invite à nouveau à la confirmer. L'utilisateur final dit "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 avec succès.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123N | |
| Merci. J'ai atteint 123 M, c'est bien cela ? | |
| 0 | |
| Désolé, pouvez-vous de nouveau saisir les 1 à 8 premiers caractères ? | |
| 123N | |
| Merci. J'ai atteint 123 M, c'est bien cela ? | |
| 0 | |
| Désolé, pouvez-vous indiquer de nouveau les 1 à 8 premiers caractères ? Veuillez épeler chaque lettre de votre séquence par un mot commençant par chaque lettre. Par exemple, si votre séquence est AB123, dites "Apple Baby 123". |
|
| 123 N comme dans Nancy | |
| Merci. J'ai reçu 123N, c'est bien ça ? | |
| oui | |
| D'accord. Dites-moi les 1 à 8 caractères suivants de la séquence. | |
| 567 av. J.-C. | |
| Merci. J'ai trouvé 567BC, c'est bien ça ? | |
| C'est tout | |
| Merci de votre confirmation. La dernière séquence alphanumérique que j'ai obtenue est 123N56BC. Est-ce bien cela ? | |
| oui | |
| Fantastique, j'ai collecté la séquence alphanumérique. |
Longueur de séquence non valide
L'utilisateur final fournit une séquence alphanumérique dont la longueur dépasse les longueurs minimale et maximale prédéfinies de la séquence alphanumérique. L'agent invite l'utilisateur final à recommencer, il refuse et le composant quitte le flux.
| 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 terminer la collecte. Vous pouvez également dire "lecture" à tout moment pour vérifier la séquence collectée actuelle. | |
| 123M | |
| Merci. J'ai atteint 123 M, c'est bien cela ? | |
| OK | |
| Désolé, la séquence alphanumérique que vous avez fournie ne dépasse pas la limite de 5 à 30 caractères. Tu veux recommencer ? | |
| 0 | |
| Malheureusement, le nombre de tentatives autorisées est dépassé. Échec de la collecte de la séquence alphanumérique. |
Conventions de nommage
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes:
| Caractéristique | Format | Exemple |
|---|---|---|
| Flow | [Nom du composant] | Collection alphanumérique |
| Intent spécifique au composant | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_alphanumeric_collection_support_continue |
| Paramètres | [nom_param] | 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 dans le flux pour déterminer le comportement du composant. Les paramètres de portée flux doivent être définis sur la page d'accueil 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 d'accueil de ce composant.
Vous pouvez configurer les longueurs minimale et maximale acceptées par capture et pour la séquence collectée finale en modifiant les préréglages des paramètres sur la page d'accueil 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 morceau qu'un utilisateur peut fournir à chaque tour. La valeur par défaut est 1. |
entier |
| $flow.upper_limit | Longueur maximale du segment 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 les instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Build (Compilation).
- Cliquez sur le composant importé dans la section Flux.
- Cliquez sur "Page d'accueil" dans la section Pages.
- Cliquez sur true Route sur la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs Parameter Presets (Préréglages de paramètres) si nécessaire.
- Cliquez sur Enregistrer.
Paramètres de sortie
Les paramètres de sortie sont des paramètres de session qui restent actifs après avoir quitté le 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. | chaîne |
Configuration de base
Pour configurer ce composant prédéfini:
Terminé
Votre agent devrait maintenant être configuré et prêt à être testé.