בדף הזה מפורטות שיטות מומלצות לשימוש בתכונה 'השלמה חכמה' של Agent Assist. מידע נוסף על הטמעה של התכונה הזו באמצעות קריאה ישירה ל-API זמין במדריך ההוראות של התכונה 'השלמה חכמה'. הוראות להטמעה של התכונה הזו באמצעות מסוף Agent Assist זמינות במדריך למסוף.
הסברים על המונחים
המונחים הבאים משמשים בתכונה 'כתיבה מהירה'.
טקסט הבסיס של ההצעה
בקטע הזה מוגדרת הטרמינולוגיה שמשמשת לתיאור Agent Assist.
טקסט הבסיס של ההצעה הוא הטקסט שהוקלד באופן חלקי ושהתכונה 'כתיבה מהירה' משתמשת בו כדי ליצור את ההצעה לטקסט מלא. זה הטקסט ב-current_text_input.text של SuggestSmartComposeAnswersRequest.
דוגמה: אם נציג אנושי מקליד "מה", אחת ההצעות האפשריות יכולה להיות "מה שלומך". במקרה הזה, "Ho" הוא הטקסט הבסיסי וההצעה היא "how are you".
הצעה לטקסט מורחב
הטקסט המורחב של הצעה נוצר על ידי מיזוג ההצעה עם טקסט הבסיס שלה. אם טקסט הבסיס מכיל סיומת שתואמת לקידומת של ההצעה, החלק התואם ימוזג. התכונה 'כתיבה מהירה' מתאימה סיומות ותחיליות באופן לא תלוי-רישיות. כדי להימנע מתוצאות שליליות שגויות, מומלץ להציג הצעה רק אם יש לה קידומת לא ריקה שתואמת לסיומת בטקסט הבסיסי.
דוגמה: אם טקסט הבסיס הוא "Ho" וההצעה היא "how are you", הטקסט המורחב של ההצעה יהיה "How are you".
הצעה זמינה
הצעה זמינה אם:
- טקסט הבסיס של ההצעה הוא קידומת של הטקסט שכבר הקלדתם.
- הטקסט שהוקלד הוא קידומת של הטקסט המורחב של ההצעה, אבל הוא לא זהה לו.
דוגמה: ההצעה 'מה שלומך' עם טקסט בסיסי 'מה' היא הצעה זמינה כשהטקסט שכבר הוקלד הוא 'מה של', אבל היא לא הצעה זמינה כשהטקסט שכבר הוקלד הוא 'מ' או 'מה שלומך'.
בקשת הצעה
מומלץ שהשרת ישלח בקשה suggestSmartComposeAnswers על כל תו חדש, אלא אם התו כבר נכלל בהצעה זמינה. כך גדל הסיכוי להצגת הצעות של 'כתיבה חכמה'. שימו לב שהפעולה הזו עלולה ליצור מספר גבוה של בקשות לשנייה: אם הבקשות מוגבלות בגלל מכסות, צריך לפנות אל Google כדי לדון בפתרון. כשיוצרים בקשה, כדאי להגדיר את הערך max_results=3 כדי להגדיל את מספר ההצעות שמתקבלות.
בחירת הצעה
בחירת הצעה היא פונקציונליות חיונית שצריך להטמיע לפני שמטמיעים את התכונה 'כתיבה מהירה' בממשק משתמש של סוכן. ההקלדה יכולה להיות מהירה, ויש השהיה מסוימת בהצעות לכתיבה מהירה. לכן, יכול להיות שההצעות לא יהיו תקפות כשהן יגיעו לממשק המשתמש של הסוכן. כדי לצמצם את הבעיה הזו, מומלץ להציג בממשק המשתמש רק קבוצת משנה של ההצעות הזמינות. עבור טקסט מוקלד נתון, צריך לבחור הצעה אם:
- ההצעה זמינה לטקסט שהוקלד.
- הטקסט הבסיסי שלו מכיל את המספר הגדול ביותר של תווים מבין כל ההצעות הזמינות.
- אם יש כמה הצעות עם אותו טקסט בסיס ארוך ביותר, בוחרים באפשרות עם דירוג ההצעה הכי גבוה.
תהליך עבודה לדוגמה:
- סוכן מקליד "Ho".
- נשלחת בקשה עם ההודעה הנוכחית 'הו'.
- הנציג המשיך להקליד 'איך'.
- ההצעה {"Hope you", "how are you", "How are you doing today?"} (על סמך הערך המקורי Ho) מגיע לממשק המשתמש של הסוכן.
- במקרה הזה, ההצעה 'Hope you' כבר לא תקפה, כי הנציג הקליד מילה אחרת. במקום זאת, צריך להציע את השאלה "מה נשמע?".
שמירה במטמון
מומלץ להטמיע שמירה במטמון כמפת מפתח/ערך, כשהקידומת היא המפתח וההצעות שמוחזרות על ידי ה-API הן הערך. צריך לבדוק אם יש במפה מפתח שתואם לקלט של הסוכן. אם המפה לא מכילה מפתח תואם, צריך להסיר תווים מסוף קלט הסוכן אחד בכל פעם, ולבדוק את המפה בכל איטרציה. התהליך הזה צריך להימשך עד שנמצאת הצעה תואמת, עד שלא נשארו יותר תווים להסרה מקלט הסוכן או עד שמגיעים למגבלת איטרציה (50 איטרציות הוא מספר סביר). כשנמצא מפתח תואם, צריך לבצע איטרציה על ההצעות. כדי לקבוע אם ההצעה תקפה, המערכת ממזגת את המפתח (מחרוזת משנה של הקידומת) עם ההצעה, ואז בודקת אותה מול הקלט של הסוכן. ההצעה הממוזגת והקלט של הסוכן צריכים להיות זהים לחלוטין החל מהתווים הראשונים. אם לא, צריך לבדוק את ההצעה הבאה.
דוגמה לשימוש במטמון:
- "Agent" types "H".
- המערכת בודקת את המיפוי של זוגות מפתח/ערך כדי להציע הצעות לקידומת 'H'. אין כאלה, ואין עוד תווים להסרה מסוף הקלט, ולכן נשלחת בקשה להצעות עבור 'H'.
- הנציג ממשיך להקליד 'Ho'.
- המערכת בודקת את מיפוי זוגות המפתח/ערך כדי להציע הצעות לקידומת 'Ho'. אין הצעות, המיפוי של זוגות מפתח/ערך נבדק לגבי הצעות לקידומת 'H'. אין כאלה, ואין עוד תווים להסרה מסוף הקלט, ולכן מתבצעת בקשה להצעות עבור 'Ho'.
- מתקבלת תגובה ללא הצעות מהבקשה שנשלחה בשלב 2, והתגובה נוספת למטמון עבור המפתח 'H'.
- מתקבלת תגובה עם ההצעות {"Hope you", "how are you", "How are you doing today?"} מהבקשה שנשלחה בשלב 4, וההצעות מתווספות למטמון עבור המפתח "Ho".
- המערכת בודקת את המיפוי של זוגות מפתח/ערך כדי למצוא הצעות לקידומת 'Ho'. יש הצעות. ההצעות חוזרות על עצמן, והמפתח וההצעה משולבים ונבדקים מול הקלט של 'הסוכן'. הקלט 'Ho' של הסוכן חופף להצעה הראשונה 'Hope you', ולכן ההצעה 'pe you' מוצגת לסוכן.
- הנציג ממשיך להקליד 'איך'.
- המערכת בודקת את מיפוי המפתח-ערך כדי להציע הצעות לקידומת 'איך'. אין הצעות, המיפוי של זוגות מפתח/ערך נבדק כדי למצוא הצעות לקידומת Ho, יש הצעות. ההצעות חוזרות על עצמן, ומילת המפתח וההצעה משולבות ונבדקות מול הקלט של 'הסוכן'. הקלט 'איך' של הסוכן חופף להצעה הראשונה 'מה שלומך', ולכן ההצעה 'מה שלומך' מוצגת לסוכן.
היסטוריית השיחות
כדי שהתכונה 'כתיבה מהירה' תפעל בצורה תקינה, היא מסתמכת על היסטוריית השיחות. אם אתם משתמשים בתשובות חכמות או בתכונות אחרות של Agent Assist דרך analyzeContentAPI, אתם כבר מכוסים. אחרת, צריך לקרוא ל-analyzeContentAPI בכל הודעה שהושלמה לפני שמשתמשים ב-suggestSmartComposeAnswers כדי לקבל הצעות לכתיבה חכמה. פרטים נוספים זמינים במדריך לשימוש בתכונה 'השלמה חכמה'.