הערה: חבילת המסמכים הזו מיועדת למהדורות Standard,‏ Plus,‏ תשלום לפי שימוש ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

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

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

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

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

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

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

בודקים את הגדרות ההשלמה האוטומטית של האפליקציה ועורכים אותן לפי הצורך. מידע נוסף זמין במאמר עדכון הגדרות ההשלמה האוטומטית.
במאגרי נתונים קטנים יותר, מגדירים את הפעלת ההשלמה האוטומטית לערך עכשיו. אנחנו ממליצים על כך כי יכול להיות שמאגרי נתונים קטנים לא יכילו מספיק נתונים כדי לספק הצעות מדויקות.
אם מאגרי הנתונים שלכם מכילים פרטים אישיים מזהים (PII) או אם אתם משתמשים במודל של היסטוריית החיפושים או במודל של הצעות לשאילתות של אירועי משתמשים, כדאי לעיין במאמר הגנה מפני דליפות של פרטים אישיים מזהים (PII) ולהגדיר אמצעי הגנה למניעת אובדן נתונים (DLP) שעשויים להיות נחוצים כדי למנוע דליפות של פרטים אישיים מזהים.
אם אתם מתכננים להשתמש בהצעות לחיפושים אחרונים (RECENT_SEARCH), חשוב לוודא שאתם מתעדים אירועי משתמשים של חיפוש. ‫Gemini Enterprise לא מאכלס באופן אוטומטי את אינדקס החיפוש האחרון כשמבצעים חיפושים באמצעות השיטה SearchService.Search. כדי להחזיר שאילתות אחרונות, צריך לתעד אירועי משתמשים בחיפוש באמצעות השיטה userEvents.write. לפני שמתחילים עם שאילתות אחרונות.

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

כך שולחים בקשות מתקדמות להשלמה אוטומטית באמצעות ה-method‏ completionConfig.completeQuery.

REST

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

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.

מבצעים קריאה ל-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. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מבצעים קריאה ל-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: הקוד בן שתי האותיות של שפה אחת או יותר, במירכאות עם תו בריחה. לדוגמה, \"fr\", \"es\" כדי להחיל את ערך ההגברה על ספרדית וצרפתית.
- ‫BOOST_VALUE: מספר נקודה צפה (floating-point) בין 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. אפשר לראות ולערוך את מיפויי המאפיינים העיקריים בכרטיסייה Schema בדף של מאגר הנתונים.

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

דוגמה

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

העובד מתחיל להקליד 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	חשבון	ליד (lead)	הזדמנות
ServiceNow	אירוע	ידע
Sharepoint Online	הקובץ המצורף	אירוע	קובץ	דף
Slack	הודעה

התהליך

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

REST

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.

מבצעים קריאה ל-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"
  }]
}

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

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

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

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

כדי לאחזר שאילתות אחרונות באמצעות השלמה אוטומטית, צריך לתעד את החיפושים של המשתמשים כאירועי חיפוש של משתמשים באמצעות קריאה ל-method‏ userEvents.write.

אם אירועי החיפוש של המשתמשים לא נכתבים, בקשות אל completionConfig.completeQuery עם suggestionTypes: ["RECENT_SEARCH"] מחזירות רשימה ריקה של הצעות ({}).

כדי לתעד אירוע חיפוש של משתמש, שולחים בקשת POST ל-method‏ userEvents.write עם הערכים הבאים:

‫eventType: מוגדר לערך "search"
‫userPseudoId: מוגדר למזהה הפסאודונימי הייחודי של המשתמש
‫engine: צריך להגדיר את שם המשאב של המנוע
searchInfo.searchQuery: מוגדר למחרוזת של שאילתת החיפוש שהמשתמש הזין

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/LOCATION/userEvents:write" \
  -d '{
        "eventType": "search",
        "userPseudoId": "USER_PSEUDO_ID",
        "engine": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
        "searchInfo": {
          "searchQuery": "SEARCH_QUERY"
        }
      }'

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

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: המיקום של האפליקציה או של מאגר הנתונים (לדוגמה, global או us).
‫APP_ID: מזהה האפליקציה.
‫USER_PSEUDO_ID: מזהה פסאודונימי של המשתמש. הערך הזה חייב להיות זהה לערך של userPseudoId שמועבר בבקשות הבאות של completionConfig.completeQuery.
‫SEARCH_QUERY: מחרוזת השאילתה שהמשתמש חיפש.

מידע נוסף זמין במאמר תיעוד אירועי משתמשים בזמן אמת באמצעות השיטה userEvents.write.

דוגמה

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

‫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. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.

מבצעים קריאה ל-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"
    }
  ]
}

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

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

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

למידע על יצירה ושימוש ב<a href="/search/docs/advanced/denylists/use-denylist">רשימת ישויות שנחסמו להשלמה אוטומטית</a>, ראו שימוש ברשימת ישויות שנחסמו להשלמה אוטומטית.

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

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

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

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

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

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

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

REST

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

REST

פקודה לדוגמה

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

דוגמה

מגבלות

התהליך

REST

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

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

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

דוגמה

התהליך

REST

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

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

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

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