רכיב מוכן מראש של אוסף אלפאנומרי

הרכיב המוגדר מראש לאיסוף תווים אלפאנומריים אוסף רצפים אלפאנומריים ממשתמש הקצה. אפשר להגדיר את האורך המינימלי והמקסימלי המקובל באמצעות פרמטרים של קלט.

הרכיב מתעד קבוצות של תווים מהמשתמש בכל שלב בשיחה ומחבר אותן כדי ליצור את הרצף הסופי. אפשר להגדיר את האורך המינימלי והמקסימלי של כל קטע באמצעות פרמטרים של קלט.

ההקלטה של הרצף תימשך עד שמשתמש הקצה יציין שהוא סיים את הרצף באמצעות קלט שתואם לכוונה prebuilt_components_confirmation_done.

אלפבית פונטי

הרכיב הזה תומך בשימוש באלפבית פונטי, כמו האלפבית הפונטי של נאט"ו.

קלט של משתמשים	הרצף שצולם
אלפא בראבו צ'ארלי 123	abc123
A B Cat 1 2 3	ABC123
A כמו apple, ‏ B כמו banana, ‏ C כמו chili, ‏ 115	ABC115

פונקציות נוספות

הרכיב המוגדר מראש הזה מספק את הפונקציות הנוספות הבאות:

• חזרה
• חדר המתנה
• שידור חוזר

דוגמאות לדו-שיח

השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.

מקטע יחיד

משתמש הקצה מספק רצף אלפאנומרי בחלק אחד ואומר "סיימתי". הנציג מקבל את הרצף בהצלחה.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
fvfd3433
	בסדר. הבנתי נכון? fvfd3433?
כן
	בסדר. מהם 1 עד 8 התווים הבאים ברצף?
סיימתי
	תודה על האישור. הרצף האלפאנומרי הסופי שקיבלתי הוא fvfd3433, זה נכון?
כן
	מעולה, קיבלתי את הרצף האלפאנומרי.

מספר מקטעים

משתמש הקצה מספק רצף אלפאנומרי בשני חלקים, והנציג מקבל אותו בהצלחה.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
fvfd3433
	בסדר. הבנתי נכון? fvfd3433?
כן
	בסדר. מהם 1 עד 8 התווים הבאים ברצף?
gh67
	בסדר. הבנתי נכון? gh67?
כן
	בסדר. מהם 1 עד 8 התווים הבאים ברצף?
סיימתי
	תודה על האישור. הרצף האלפאנומרי הסופי שקיבלתי הוא fvfd3433gh67, זה נכון?
כן
	מעולה, קיבלתי את הרצף האלפאנומרי.

ניסיון חוזר שהצליח

משתמש הקצה מספק רצף אלפאנומרי, והנציג מבקש ממשתמש הקצה לאשר אותו. משתמש הקצה אומר "לא" לאישור ומספק שוב רצף אלפאנומרי. הנציג מקבל אותו בהצלחה.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
fvfd3433
	בסדר. הבנתי נכון? fd3433?
לא
	סליחה על הטרחה, אפשר לקבל שוב את 1 עד 8 התווים הראשונים?
fvfd3433
	בסדר. הבנתי נכון? fvfd3433?
כן
	בסדר. מהם 1 עד 8 התווים הבאים ברצף?
סיימתי
	תודה על האישור. הרצף האלפאנומרי הסופי שקיבלתי הוא fvfd3433, זה נכון?
כן
	מעולה, קיבלתי את הרצף האלפאנומרי.

ניסיונות חוזרים שנכשלו

משתמש הקצה לא מצליח לספק רצף אלפאנומרי של 1 עד 8 תווים תוך שלושה ניסיונות, והרכיב יוצא מהתהליך.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
123N
	בסדר. הבנתי שהמספר הוא 123M, זה נכון?
לא
	סליחה על הטרחה, אפשר לקבל שוב את 1 עד 8 התווים הראשונים?
123N
	בסדר. הבנתי שהמספר הוא 123M, זה נכון?
לא
	סליחה, אפשר לקבל שוב את 1 עד 8 התווים הראשונים? צריך לאיית כל אות ברצף באמצעות מילה שמתחילה באות הזו. לדוגמה, אם הרצף הוא AB123, אומרים "Apple Baby 123".
‫123 Nest
	בסדר. הבנתי 123N, זה נכון?
לא
	מצטער, ניסיתי יותר מדי פעמים ולא הצלחתי לאסוף את הרצף האלפאנומרי.

אלפבית פונטי

משתמש הקצה מספק רצף אלפאנומרי, והנציג מבקש ממשתמש הקצה לאשר אותו. משתמש הקצה אומר "לא" לאישור פעמיים ברציפות, ההמרה הפונטית מופעלת ומשתמש הקצה מספק שוב רצף אלפאנומרי. הנציג מקבל אותו בהצלחה.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
123N
	בסדר. הבנתי שהמספר הוא 123M, זה נכון?
לא
	סליחה על הטרחה, אפשר לקבל שוב את 1 עד 8 התווים הראשונים?
123N
	בסדר. הבנתי שהמספר הוא 123M, זה נכון?
לא
	סליחה, אפשר לקבל שוב את 1 עד 8 התווים הראשונים? צריך לאיית כל אות ברצף באמצעות מילה שמתחילה באות הזו. לדוגמה, אם הרצף הוא AB123, אומרים "Apple Baby 123".
‫123 N כמו Nancy
	בסדר. הבנתי 123N, זה נכון?
כן
	בסדר. מהם 1 עד 8 התווים הבאים ברצף?
567 לפנה"ס
	בסדר. הבנתי נכון?
זה הכול
	תודה על האישור. הרצף האלפאנומרי הסופי שקיבלתי הוא 123N56BC. זה נכון?
אכן
	מעולה, קיבלתי את הרצף האלפאנומרי.

אורך הרצף לא תקין

משתמש הקצה מספק רצף אלפאנומרי באורך שהוא מחוץ לאורך המינימלי והמקסימלי שהוגדר מראש לרצף האלפאנומרי. הנציג מבקש ממשתמש הקצה להתחיל מחדש, משתמש הקצה מסרב והרכיב יוצא מהתהליך.

קלט של משתמשים	התשובה של הסוכן
	כדי להתחיל, צריך לומר את 1 עד 8 התווים הראשונים ברצף האלפאנומרי. בסיום, אומרים "סיימתי" כדי לסיים את האיסוף. אתם יכולים גם להגיד "playback" (הפעלה) בכל שלב כדי לבדוק את הרצף הנוכחי שנאסף.
123M
	בסדר. הבנתי שהמספר הוא 123M, זה נכון?
סיום
	הזנת רצף אלפאנומרי שלא עומד בדרישה של 5 עד 30 תווים. רוצה להתחיל מחדש?
לא
	מצטער, ניסיתי יותר מדי פעמים ולא הצלחתי לאסוף את הרצף האלפאנומרי.

מוסכמות למתן שמות

הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	אוסף אלפאנומרי
כוונה ספציפית לרכיב	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_alphanumeric_collection_support_continue
פרמטר	[param_name]	alphanumeric_max_length

פרמטרים של קלט

פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע איך הרכיב צריך להתנהג. צריך להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.

כדי להגדיר את האורך המינימלי והמקסימלי של כל הקלטה ושל הרצף הסופי שנאסף, משנים את הפרמטרים המוגדרים מראש בדף הפתיחה של התהליך.

הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:

שם הפרמטר	תיאור	פורמט הקלט
$flow.alphanumeric_min_length	האורך המינימלי של הרצף האלפאנומרי הסופי. ערך ברירת המחדל הוא 1.	מספר שלם
$flow.alphanumeric_max_length	האורך המקסימלי של הרצף האלפאנומרי הסופי. ערך ברירת המחדל הוא 30.	מספר שלם
$flow.lower_limit	האורך המינימלי של הקטע שהמשתמש יכול לספק בכל תור. ערך ברירת המחדל הוא 1.	מספר שלם
$flow.upper_limit	האורך המקסימלי של קטע הטקסט שמשתמש יכול לספק בכל תור. ערך ברירת המחדל הוא 8.	מספר שלם

כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה Build.
5. לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
6. בקטע Pages, לוחצים על Start Page.
7. לוחצים על המסלול true בדף הפתיחה.
8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
9. לוחצים על Save.

פרמטרים של פלט

פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המוכן מראש הזה מספק ערכים לפרמטרים הבאים של פלט:

שם הפרמטר	תיאור	פורמט הפלט
alphanumeric_collection_alphanumeric_sequence	הפרמטר הזה מחזיר את הרצף האלפאנומרי שנקלט על ידי הרכיב	מחרוזת

הגדרה בסיסית

כדי להגדיר את הרכיב המוכן מראש:

1. מייבאים את הרכיב שהוגדר מראש.

הושלמה

עכשיו הנציג אמור להיות מוגדר ומוכן לבדיקה.