הגדרת השלמה אוטומטית מתקדמת

בדף הזה מוסבר על התכונה המתקדמת להשלמה אוטומטית ב-Gemini Enterprise.

בדומה להשלמה אוטומטית בסיסית, השלמה אוטומטית מתקדמת יוצרת הצעות לשאילתות על סמך התווים הראשונים שהוזנו בשאילתה.

לפני שקוראים את הדף הזה, כדאי להכיר את ההשלמה האוטומטית הבסיסית של Gemini Enterprise. איך מגדירים השלמה אוטומטית

תכונות עיקריות של השלמה אוטומטית מתקדמת

התכונות העיקריות של ההשלמה האוטומטית המתקדמת שמבדילות אותה מההשלמה האוטומטית הבסיסית הן:

• חיפוש משולב: אפשר להשתמש בהשלמה אוטומטית מתקדמת עם אפליקציות שמחוברות ליותר ממאגר נתונים אחד.

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

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

• סוגים שונים של הצעות: באמצעות השלמה אוטומטית מתקדמת, במקום הצעות רגילות להשלמה אוטומטית של שאילתות, אפשר לציין שרוצים סוגים שונים של הצעות:

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

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

לפני שמתחילים

לפני שמתחילים להשתמש בהשלמה אוטומטית מתקדמת, צריך לבצע את הפעולות הבאות:

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

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

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

שליחת בקשות להשלמה אוטומטית

בדוגמה הבאה אפשר לראות איך לשלוח בקשות מתקדמות להשלמה אוטומטית באמצעות השיטה completionConfig.completeQuery.

REST

כדי לשלוח בקשה להשלמה אוטומטית באמצעות ה-API, פועלים לפי השלבים הבאים:

1. מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.

   1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

      מעבר אל 'אפליקציות'

   2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

2. מבצעים קריאה ל-method‏ completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING"
       }'
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט.

   • ‫APP_ID: מזהה האפליקציה.

   • ‫QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור הצעות.

שליחת בקשה להשלמה אוטומטית עם שיפור שפה

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

ערך ההגברה צריך להיות בין ‎-1 ל-1. הגדרת מספר שלילי 'קוברת' את ההצעות להשלמה אוטומטית בשפה הזו, והגדרת מספר חיובי משפרת את השפה.

משתמשים בתגי שפה בני שתי אותיות שמוגדרים על ידי BCP 47 – לדוגמה, en,‏ fr,‏ hi ו-zh.

REST

כדי לשלוח בקשה להשלמה אוטומטית שכוללת ערך של הגברת שפה, פועלים לפי השלבים הבאים:

1. מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.

   1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

      מעבר אל 'אפליקציות'

   2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

2. מבצעים קריאה ל-method‏ completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "boostSpec": {
            "conditionBoostSpecs": [{
              "condition": "(langCode: ANY(LANG_CODE))",
              "boost": BOOST_VALUE
            }]
         }
       }'
   
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט.

   • ‫APP_ID: מזהה האפליקציה.

   • ‫QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור הצעות.

   • ‫LANG_CODE: קוד בן שתי אותיות של שפה אחת או יותר, במירכאות עם תווי escape. לדוגמה, \"fr\", \"es\" כדי להחיל את ערך ההגדלה על ספרדית וצרפתית.

   • ‫BOOST_VALUE: מספר בשיטת נקודה צפה בין ‎-1 ל-1. אם הערך שלילי, ההצעות האוטומטיות בשפה יופיעו במקום נמוך יותר ברשימת ההצעות. אם הערך חיובי, ההצעות מקודמות (הן מופיעות גבוה יותר ברשימה).

   פקודה לדוגמה

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
        "query": "hol",
        "boostSpec": {
           "conditionBoostSpecs": [{
             "condition": "(langCode: ANY(\"es\", \"fr\"))",
             "boost": 0.75 }, {
             "condition": "(langCode: ANY(\"en\"))",
             "boost": -1
           }]
         }
       }'
    

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

שליחת בקשה להשלמה אוטומטית והחזרת הצעות מפורטות

ההשלמה האוטומטית המתקדמת מחזירה תוכן (מסמכים) שהכותרות שלו מכילות מילים שמתחילות בשאילתה.

בנוסף לשם המסמך, בקשת ההשלמה האוטומטית מחזירה את הערכים source_type ו-entity_type, ואם הם זמינים, את מאפייני המפתח: uri,‏ create_time ו-update_time. בכרטיסייה סכימה בדף של מאגר הנתונים אפשר לראות ולערוך מיפויים של מאפיינים מרכזיים.

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

דוגמה

עובד שולח שאילתה לאתר האינטראנט של החברה כדי לחפש מידע טכני על הרשאות גישה.

העובד מתחיל להקליד tec, והמסמכים הבאים עשויים להופיע: Data technicians handbook, Access technology guide וגם Techniques for troubleshooting access issues.

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

• שם המסמך (title), קישור למסמך (uri)

• מתי הוא עודכן לאחרונה (update_time)

• המקור (source_type), למשל, אם המסמך נמצא ב-Confluence Cloud או ב-Slack.

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

מגבלות

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

מחבר של צד שלישי	ישויות נתמכות
Box	קובץ
Confluence Cloud	דף	רווח
Dropbox	קובץ
Jira Cloud	שגיאה	רווח
OneDrive	קובץ
Salesforce	חשבון	ליד	הזדמנות
ServiceNow	אירוע	ידע
‫Sharepoint Online	הקובץ המצורף	אירוע	קובץ	דף
Slack	הודעה

התהליך

כדי לשלוח בקשה להשלמה אוטומטית שמחזירה הצעה עשירה, פועלים לפי השלבים הבאים:

REST

1. מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.

   1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

      מעבר אל 'אפליקציות'

   2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

2. מבצעים קריאה ל-method‏ completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["CONTENT"]
       }'
   
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט.

   • ‫APP_ID: מזהה האפליקציה.

   • ‫QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור הצעות.

   דוגמה לפקודה ולתוצאה

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/1234/locations/global/collections/default_collection/engines/my_app/completionConfig:completeQuery" \
   - d {
         "query": "C",
         "suggestionTypes": ["CONTENT"]
       }'
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store"
     }]
   }
   
   

הערה: אם מציינים את suggestionTypes כ-CONTENT, המערכת מתעלמת מכל הפרמטרים boostSpec, queryModel או includeTailSuggestions בפקודת curl.

שליחת בקשת השלמה אוטומטית והחזרת שאילתות מהזמן האחרון

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

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

דוגמה

עובד שולח שאילתה לאתר האינטראנט של החברה כדי לקבל מידע על יציאה לחופשה. העובד ביצע את השאילתות הבאות, שמופיעות מהחדשה לישנה:

‫PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences וגם Can I take unpaid time off?.

עכשיו, בתגובה להקלדה של vac בתיבת החיפוש על ידי העובד, ההצעות להשלמה אוטומטית יהיו:

• Vacation blackout periods
• How much vacation time do I have?
• Vacation policy
• Covering a vacant position during absences

התהליך

כדי לשלוח בקשה להשלמה אוטומטית שמחזירה את השאילתות האחרונות של המשתמש, פועלים לפי השלבים הבאים:

REST

1. מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.

   1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

      מעבר אל 'אפליקציות'

   2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

2. מבצעים קריאה ל-method‏ completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId": "USER_PSEUDO_ID"
       }'
   
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט.

   • ‫APP_ID: מזהה האפליקציה.

   • ‫QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור הצעות.

   • ‫USER_PSEUDO_ID: מזהה של המשתמש שעבר פסאודונימיזציה. אפשר להשתמש בקובץ Cookie של HTTP בשדה הזה, כדי לזהות באופן ייחודי מבקר במכשיר יחיד. אל תגדירו בשדה הזה את אותו מזהה לכמה משתמשים. הפעולה הזו תגרום למיזוג של היסטוריית השאילתות שלהם. אסור לכלול פרטים אישיים מזהים (PII) בשדה הזה.

   דוגמה לפקודה ולתוצאה

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
         "query": "hol",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId": "test_user"
       }'
   
   {
     "recentSearchSuggestions": [
       {
         "suggestion": "holiday readiness",
         "recentSearchTime": "2025-05-19T18:27:07.261698Z"
       },
       {
         "suggestion": "holiday freeze",
         "recentSearchTime": "2025-05-19T18:25:45.744021Z"
       },
       {
         "suggestion": "holiday",
         "recentSearchTime": "2025-05-19T18:20:08.916884Z"
       }
     ]
   }
   

הערה: אם מציינים את suggestionTypes כ-RECENT_SEARCH, המערכת מתעלמת מכל הפרמטרים boostSpec, queryModel או includeTailSuggestions בפקודת curl.

שימוש ברשימת חסימה של השלמה אוטומטית

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

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

מידע על יצירה ושימוש ברשימות חסימה זמין במאמר שימוש ברשימת חסימה של השלמה אוטומטית.

שימוש ברשימה מיובאת של הצעות להשלמה אוטומטית

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

מידע על ייבוא רשימה מופיע במאמר שימוש ברשימה מיובאת של הצעות להשלמה אוטומטית.