הרכיב המובנה לאיסוף כתובות אוסף כתובת מלקוח ומאמת אותה באמצעות Google Address Validation API.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:
- תומך רק בכתובות ממדינות שמופיעות בפרטי הכיסוי של Address Validation API.
תכונות נוספות
הרכיב המוכן מראש הזה כולל את התכונות הנוספות הבאות:
דוגמאות לדו-שיח
בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.
אימות כתובת מלאה
המשתמש מספק כתובת מלאה, ורכיב איסוף הכתובות מאמת אותה.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| כדי להתחיל, מה הכתובת המלאה שלך? | |
| 1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA | |
| אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא. | |
| כן | |
| מעולה, הכתובת נשמרה. |
כתובת תקינה חלקית עם רכיבים משוערים
- המשתמש מספק כתובת חלקית.
- הסוכן מנחש את החלק החסר ומאמת אותו אחרי שהמשתמש מאשר.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| כדי להתחיל, מה הכתובת המלאה שלך? | |
| 1600 Amphitheatre Parkway | |
| ניחשתי חלק מהכתובת: העיר היא Mountain View, המיקוד הוא 94043, האזור המנהלי הוא CA, המדינה היא ארה"ב. אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא. |
|
| כן | |
| מעולה, הכתובת נשמרה. |
כתובת תקינה חלקית עם רכיבים שהמשתמש סיפק
- המשתמש מספק כתובת חלקית.
- המשתמש דוחה את החלק המשוער ומזין קלט משלו.
- הנציג מקבל את הקלט מהמשתמש ומבקש שוב אישור.
- המשתמש מאשר את הכתובת הסופית.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| כדי להתחיל, מה הכתובת המלאה שלך? | |
| 1600 Amphitheatre Parkway | |
| ניחשתי חלק מהכתובת: העיר היא Mountain View, המיקוד הוא 94043, האזור המנהלי הוא CA, המדינה היא ארה"ב. אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא. |
|
| לא | |
| בסדר. איזה חלק בכתובת צריך לשנות? | |
| מיקוד | |
| מה המיקוד? | |
| 94044 | |
| סיימתי עם העדכון הזה. יש עוד משהו שצריך לשנות? צריך לומר כן או לא. | |
| לא | |
| אחרי האימות, החלפתי את המיקוד ל-94043. אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא. |
|
| כן | |
| מעולה, הכתובת נשמרה. |
קלט לא מזוהה
הרכיב יוצא מהתהליך אחרי שהמשתמש מספק קלט לא מזוהה שלוש פעמים.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| כדי להתחיל, מה הכתובת המלאה שלך? | |
| זה בסדר | |
| סליחה, לא הבנתי. כדי להתחיל, מה הכתובת המלאה שלך? | |
| נחמד | |
| הממ, עדיין לא הצלחתי להבין. כדי להתחיל, מה הכתובת המלאה שלך? | |
| נהניתי מאוד | |
| סליחה, לא הבנתי את התשובה שלך. |
כתובת לא נתמכת
הרכיב יוצא מהתהליך אחרי שהמשתמש מספק כתובת שלא נתמכת על ידי Address Validation API.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| כדי להתחיל, מה הכתובת המלאה שלך? | |
| הודו | |
| מצטער, אין לי אפשרות לאמת כתובות באזור הזה. |
אימות כתובת
בסקירה הכללית על Address Validation API מוסבר איך הרכיב לאיסוף כתובות מאמת את הכתובות.
רכיב איסוף הכתובות מתעד את הקלט של המשתמש באמצעות הישות המערכתית @sys.address ושולח את הכתובת המתועדת אל Address Validation API כדי לחלץ רכיבי כתובת לעיבוד נוסף.
Address Validation API מחזיר את רכיבי הכתובת הבאים, שבהם אתם יכולים להשתמש כדי לאסוף ולאמת כתובת מלאה:
administrative_area_level_1archipelagocountrylocalitypostal_coderoutestreet_number
אתם יכולים לנסות את הדגמת Address Validation של Google עם כל כתובת מאזור נתמך.
מוסכמות למתן שמות
הרכיב הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | איסוף כתובות |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_address_collection_locality |
| פרמטר | [param_name] | user_provided_address |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_address_collection:address_validation |
פרמטרים של קלט
פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים האלה כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר פרמטרים ברמת התהליך בדף הפתיחה של הרכיב. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך שיחה או בדף ההתחלה של הרכיב הזה.
המשתמש יכול להגדיר אילו רכיבי כתובת נדרשים על ידי הרכיב הזה באמצעות שינוי של הפרמטרים שמוגדרים מראש בדף ההתחלה של התהליך.
הרכיב הזה מקבל את הפרמטרים הבאים:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.zip_code | אם רכיב הכתובת של המיקוד נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.city | אם רכיב הכתובת של העיר נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.admin_area | אם רכיב הכתובת של האזור המנהלי נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.street_number | אם רכיב הכתובת של מספר הבית נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.route | אם רכיב הכתובת של המסלול נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.country | אם רכיב הכתובת של המדינה נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.island | אם רכיב הכתובת של האי נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. |
בוליאני |
| $flow.retry_num | הגדרת המספר המקסימלי של ניסיונות חוזרים לקריאות לפונקציות Webhook של Maps Address Validation API. | מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה יצירה.
- לוחצים על הרכיב המיובא בקטע Flows.
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב.
הרכיב המוכן מראש מספק את פרמטרי הפלט הבאים:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| address_collection_address | הפרמטר הזה מחזיר את אובייקט הכתובת אם הרכיב תיעד כתובת | { |
| address_collection_status | הפרמטר הזה מחזיר את הסטטוס של הכתובת שנאספה. הערך שמוחזר הוא אחד מהבאים:VALID_ADDRESS: הכתובת נאספה ואומתה על ידי Address Validation API.INVALID_ADDRESS: הכתובת אושרה על ידי המשתמש, אבל רכיב אחד או יותר לא אומתו או סומנו כ-UNCONFIRMED_BUT_PLAUSIBLE על ידי Address Validation API.MAPS_API_ERROR: הכתובת לא נאספה בגלל שגיאה ב-Address Validation API.COUNTRY_NOT_SUPPORTED: הכתובת לא נאספה כי Address Validation API לא תומך באזור הזה.NO_USER_CONFIRMATION: הכתובת לא אושרה כי המשתמש לא אישר כתובת. |
string |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב המוגדר מראש.
- מפעילים את Address Validation API.
- מגדירים את ה-webhook הגמיש שסופק עם מפתח ה-Maps API. מידע נוסף זמין בקטע הגדרת Webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי לאמת כתובות באמצעות Address Validation API, צריך להגדיר את ה-webhook הגמיש שסופק עם פרטי הכניסה הנכונים.
webhook לאימות כתובת
ה-webhook הזה מבצע את הפעולות הבאות:
- מעבד את הפרמטרים שנקלטו ב-Dialogflow CX, יוצר את הבקשה ומאמת את הכתובת באמצעות Address Validation API.
- חילוץ רכיבי כתובת מאושרים, לא מאושרים, חסרים ומשוערים מהתגובה של Address Validation API.
כדי להגדיר את ה-webhook לרכיב הזה, צריך לעדכן את ההגדרות של ה-webhook עם מפתח ה-API הנכון של Maps API.
כדי לאחזר את מפתח ה-API, נכנסים אל Google Cloud Console > APIs & Services > Credentials, בוחרים את מפתח ה-API של מפות Google ומעתיקים את השדה של מפתח ה-API.
כדי להגדיר את ה-webhook:
- נכנסים למסוף Dialogflow CX.
- בוחרים את הפרויקט ב- Google Cloud .
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook של
prebuilt_components_address_collection:address_validation. - בשדה Webhook URL ב-Dialogflow CX, מחליפים את כתובת ה-URL בכתובת שכוללת את מפתח ה-Maps API:
https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>. - בהגדרות Authentication, מגדירים את שם המשתמש בתור
keyומגדירים את הסיסמה למפתח Maps API. - לוחצים על Save.
הושלמה
הרכיב המוגדר מראש וה-webhook שלו מוגדרים עכשיו ומוכנים לבדיקה.