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

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

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

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

אלפבית פונטי

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

קלט של משתמשים	רצף שצולם
alpha bravo charlie 123	abc123
A B Cat 1 2 3	ABC123
‫A כמו apple, ‏ B כמו banana, ‏ C כמו chili, ‏ one fifteen	ABC115

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

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

• חזרה
• חדר המתנה
• הפעלה

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

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

מקטע יחיד

משתמש הקצה מספק רצף אלפאנומרי בחלק אחד ואומר 'סיימתי'; הסוכן מקבל את הרצף בהצלחה.

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

כמה מקטעים

משתמש הקצה מספק רצף אלפאנומרי ב-2 חלקים; הסוכן מקבל אותו בהצלחה.

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

ניסיון חוזר מוצלח

משתמש הקצה מספק רצף אלפאנומרי; הסוכן מבקש ממשתמש הקצה לאשר אותו. משתמש הקצה אומר 'לא' לאישור ומספק שוב רצף אלפאנומרי. הסוכן מקבל אותו בהצלחה.

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

ניסיונות חוזרים לא מוצלחים

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

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

אלפבית פונטי

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

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

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

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

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

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

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

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	Alphanumeric Collection
כוונת רכישה ספציפית לרכיב	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. בקטע דפים, לוחצים על דף הפתיחה.
7. לוחצים על המסלול true בדף הפתיחה.
8. בחלון Route (מסלול), עורכים את הערכים של Parameter Presets (הגדרות קבועות מראש של פרמטרים) לפי הצורך.
9. לוחצים על Save.

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

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

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

הגדרה בסיסית

כדי להגדיר את הרכיב המובנה הזה:

1. מייבאים את הרכיב שנוצר מראש.

הושלמה

הסוכן אמור להיות מוגדר ומוכן לבדיקה.