הרכיב המובנה מראש הזה מתעד את השם הפרטי, שם המשפחה ושם אמצעי אופציונלי, וגם רווחים, מקפים או גרשיים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, לרכיב המוכן מראש הזה יש את המגבלות הבאות:
- הרכיב הזה לא תומך בשמות עם תווים מיוחדים, למעט רווחים, גרשיים ומקפים.
תכונות נוספות
הרכיב המובנה מראש הזה מספק את הפונקציות הנוספות הבאות:
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הסוכן בתחילת השיחה.
שם מלא
משתמש הקצה מספק שם מלא בפנייה הראשונה, והסוכן מקבל אותו בהצלחה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מהו שמך המלא? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך כזה? | |
| סונדאר פיצ'אי (Sundar Pichai) | |
| כדי לוודא, השם הפרטי שלך הוא סונדאר ושם המשפחה שלך הוא פיצ'אי. האם איות השם המלא שלך נכון? | |
| כן | |
| יש לך שם אמצעי? | |
| לא | |
| תודה, Sundar. |
שם מלא בחלקים
משתמש הקצה לא הצליח לספק שם מלא בניסיון הראשון. משתמש הקצה מספק את השם הפרטי, שם המשפחה והשם האמצעי שלו בתורות נפרדות, והסוכן מקבל את המידע בהצלחה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מהו שמך המלא? מה השם הפרטי, שם המשפחה והשם האמצעי שלך, אם יש לך כזה? | |
| תחושה נעימה | |
| סליחה, לא הבנתי נכון. בוא ננסה שוב להקליט את השם. לפני שאקליט את השם שלך, אשמח אם תעזור לי לוודא אם יש בשם שלך מקפים, רווחים מיותרים או גרשיים. |
|
| לא | |
| בוא נתחיל בשם הפרטי שלך. מה השם הפרטי שלך? |
|
| 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 | הפרמטר הזה מחזיר את השם האמצעי שהמשתמש סיפק ונרשם על ידי הרכיב. אם לא נאסף שם אמצעי, הפרמטר יהיה מחרוזת ריקה | מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המובנה הזה:
הושלמה
הסוכן אמור להיות מוגדר ומוכן לבדיקה.