הרכיב המוגדר מראש הזה מתעד שם פרטי, שם משפחה ושם אמצעי אופציונלי, יחד עם רווחים, מקפים או גרשיים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא תומך בשמות עם תווים מיוחדים, חוץ מרווחים, גרשיים ומקפים.
תכונות נוספות
הרכיב המוגדר מראש הזה מספק את הפונקציות הנוספות הבאות:
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
שם מלא
משתמש הקצה מספק שם מלא בפנייה הראשונה, והנציג מקבל אותו.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם המלא שלך? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך? | |
| סונדאר פיצ'אי (Sundar Pichai) | |
| רק כדי לוודא, השם הפרטי שלך הוא סונדאר ושם המשפחה הוא פיצ'אי. האם השם המלא שלך מאוית נכון? | |
| כן | |
| יש לך שם אמצעי? | |
| לא | |
| תודה, סונדאר. |
השם המלא בחלקים
משתמש הקצה לא יכול לספק שם מלא בניסיון הראשון. לאחר מכן, משתמש הקצה מספק את השם הפרטי, שם המשפחה והשם האמצעי שלו בתורות נפרדות, והנציג מקבל אותם בהצלחה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם המלא שלך? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך? | |
| נחמד | |
| סליחה, לא הבנתי נכון. נתחיל שוב בתהליך של תיעוד השם. לפני שנתעד את השם, אפשר לבדוק אם יש בשם מקפים, רווחים מיותרים או גרשיים? |
|
| לא | |
| נתחיל בשם הפרטי שלך. מה השם הפרטי שלך? |
|
| Lawrence | |
| לורנס. האם השם הפרטי שלך מאוית נכון? | |
| כן | |
| מה שם המשפחה שלך? | |
| דף | |
| דף. האם כתבתי את שם המשפחה שלך נכון? | |
| כן | |
| יש לך שם אמצעי? | |
| כן | |
| מה השם האמצעי שלך? | |
| אדוארד | |
| אדוארד. האם השם האמצעי שלך מאוית נכון? | |
| כן | |
| תודה, Lawrence. |
תווים מיוחדים
משתמש הקצה לא יכול לספק שם מלא בניסיון הראשון. לאחר מכן, משתמש הקצה מספק את השם הפרטי, שם המשפחה והשם האמצעי שלו בתורות נפרדים עם תווים מיוחדים, והנציג מקבל אותם בהצלחה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם המלא שלך? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך? | |
| נחמד | |
| סליחה, לא הבנתי נכון. נתחיל שוב בתהליך של תיעוד השם. לפני שנתעד את השם, אפשר לבדוק אם יש בשם מקפים, רווחים מיותרים או גרשיים? |
|
| כן, יש לי | |
| הבנתי. האם התווים המיוחדים האלה מופיעים בשם הפרטי, בשם האמצעי או בשם המשפחה שלך? | |
| שם פרטי | |
| מה החלק הראשון של השם הפרטי שלך, לפני תווים מיוחדים? | |
| אוון | |
| אוון. האם החלק הראשון מאוית נכון? | |
| כן | |
| מה התו הבא? רווח, גרש או מקף. | |
| מקף | |
| "hyphen". האם התו המפריד בשם אחרי החלק הראשון של השם הפרטי שלך נכון? | |
| כן | |
| צריך לאיית את החלק הבא של השם הפרטי, אחרי המקף. אומרים רק את האותיות, למשל J-O-H-N. | |
| ג'יימס | |
| ג'יימס. אפשר להגיד לי אם זה לא נכון, אם זה הסוף או מה בא אחר כך: רווח, גרש או מקף. | |
| סיימתי | |
| מה שם המשפחה שלך? | |
| Mady | |
| Mady. האם כתבתי את שם המשפחה שלך נכון? | |
| כן | |
| יש לך שם אמצעי? | |
| לא | |
| תודה, Evan-James. |
אין קלט
הרכיב יוצא מהתהליך אחרי שמשתמש הקצה לא מספק קלט שלוש פעמים.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם המלא שלך? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך? | |
| [No-input] | |
| סליחה, לא הצלחתי לשמוע אותך. מה השם המלא שלך? | |
| [No-input] | |
| הממ, אני עדיין לא שומע אותך. כדאי לנסות לדבר בקול רם יותר או לעבור למקום שקט יותר. | |
| [No-input] | |
| סליחה, לא הבנתי את התשובה שלך. |
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | שם האוסף |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_name_collection_special_characters_decider |
| סוג ישות | prebuilt_components_[component_name]_[entity_type_name] | prebuilt_components_name_collection_first_name |
| פרמטר | [param_name] | user_provided_first_name |
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המוכן מראש הזה מספק ערכים לפרמטרים הבאים של פלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| name_collection_first_name | הפרמטר הזה מחזיר את השם הפרטי שהמשתמש סיפק, שנאסף על ידי הרכיב. | מחרוזת |
| name_collection_last_name | הפרמטר הזה מחזיר את שם המשפחה שהמשתמש סיפק, שנאסף על ידי הרכיב. | מחרוזת |
| name_collection_middle_name | הפרמטר הזה מחזיר את השם האמצעי שהמשתמש סיפק, שנאסף על ידי הרכיב. אם לא נאסף שם אמצעי, הפרמטר יהיה מחרוזת ריקה | מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
הושלמה
עכשיו הנציג אמור להיות מוגדר ומוכן לבדיקה.