בדף הזה מתוארת תכונת ההשלמה האוטומטית הבסיסית של Gemini Enterprise. ההשלמה האוטומטית יוצרת הצעות לשאילתות על סמך התווים הראשונים שהוזנו בשאילתה.
כברירת מחדל, ההשלמה האוטומטית של נתונים מובְנים ולא מובְנים יוצרת הצעות על סמך תוכן המסמכים במאגר הנתונים. אחרי ייבוא המסמכים, כברירת מחדל, ההשלמה האוטומטית לא מתחילה ליצור הצעות עד שיש מספיק נתונים איכותיים, בדרך כלל תוך כמה ימים. אם אתם שולחים בקשות להשלמה אוטומטית דרך ה-API, ההשלמה האוטומטית יכולה ליצור הצעות שמבוססות על היסטוריית החיפושים או על אירועי המשתמשים.
המודל של הצעות לשאילתות קובע באיזה סוג נתונים ההשלמה האוטומטית משתמשת כדי ליצור הצעות. יש ארבעה מודלים של הצעות לשאילתות:
מסמך. מודל המסמכים יוצר הצעות על סמך מסמכים שהמשתמשים מייבאים.
שדות שאפשר למלא. המודל של שדות שניתנים להשלמה מציע טקסט שנלקח ישירות משדות של נתונים מובְנים. רק השדות שמסומנים ב-
completableמשמשים להצעות של ההשלמה האוטומטית. המודל הזה זמין רק לנתונים מובְנים.היסטוריית החיפושים. המודל של היסטוריית החיפושים יוצר הצעות מההיסטוריה של הקריאות ל-API של
SearchService.search. אל תשתמשו במודל הזה אם אין תנועה זמינה לשיטהservingConfigs.search.אירוע משתמש. מודל אירועי המשתמשים יוצר הצעות מאירועי חיפוש שהמשתמשים ייבאו.
בקשות להשלמה אוטומטית נשלחות באמצעות השיטה dataStores.completeQuery.
בטבלה הבאה מוצגים סוגי המודלים של הצעות לשאילתות שזמינים לכל סוג נתונים.
מודל הצעות לשאילתות |
מקור נתונים |
נתונים מהאתר |
נתונים מובְנים |
נתונים לא מובְנים |
|---|---|---|---|---|
| מסמך | יובא על ידי המשתמש | ✔* (ברירת מחדל) | ✔ (ברירת מחדל) | |
| שדות שאפשר למלא | יובא על ידי המשתמש | ✔ | ||
| היסטוריית החיפושים | נאספים באופן אוטומטי | ✔ (ברירת המחדל) | ✔ | ✔ |
| אירועי משתמשים | מיובא על ידי המשתמש או נאסף באופן אוטומטי על ידי הווידג'ט | ✔ | ✔ | ✔ |
* : סכימת המסמך חייבת להכיל את השדות title או description, או שצריכים להיות שדות שצוינו כמאפייני מפתח של title או description. עדכון סכימה של נתונים מובְנים
אם אתם לא רוצים להשתמש במודל ברירת המחדל לסוג הנתונים שלכם, אתם יכולים לציין מודל אחר כשאתם שולחים את בקשת ההשלמה האוטומטית. בקשות להשלמה אוטומטית נשלחות באמצעות השיטה dataStores.completeQuery. למידע נוסף, ראו הוראות ל-API: שליחת בקשה להשלמה אוטומטית כדי לבחור מודל אחר.
תכונות של השלמה אוטומטית
Gemini Enterprise תומך בתכונות ההשלמה האוטומטית הבאות כדי להציג את החיזויים הכי מועילים במהלך החיפוש:
| תכונה | תיאור | דוגמה או מידע נוסף |
|---|---|---|
| תיקון שגיאות הקלדה | לתקן שגיאות הקלדה. | Milc ← Milk.
|
| הסרת מונחים לא בטוחים |
|
טקסט פוגעני, כמו פורנוגרפיה, תוכן נועז, וולגרי או אלים. |
| מניעת הצגה של פרטים אישיים מזהים (PII) בסיסיים | Gemini Enterprise מבוסס על Sensitive Data Protection, ועושה מאמץ סביר כדי למנוע הצגה של סוגים בסיסיים של פרטים אישיים מזהים, כמו מספרי טלפון וכתובות אימייל. |
אם יש כתובת אימייל
כדי להגן בצורה יסודית יותר מפני דליפות של פרטים אישיים מזהים, Google ממליצה להשתמש בפתרון משלכם למניעת אובדן נתונים (DLP) בנוסף לגלאים שמסופקים על ידי Gemini Enterprise. מידע נוסף זמין במאמר הגנה מפני דליפות של פרטים אישיים מזהים (PII). |
| רשימת חסימה |
|
מידע נוסף זמין במאמר שימוש ברשימת חסימה של השלמה אוטומטית. |
| ביטול כפילויות של מונחים |
|
Shoes for Women, Womens Shoes ו-Womans Shoes עוברים ביטול כפילויות,
ורק הפופולרי ביותר מוצע. |
| הצעות להתאמה של מילות מפתח זנב ארוך |
|
מידע נוסף זמין במאמר הצעות להתאמה של סיומת. |
הצעות להתאמה של מילות מפתח זנב ארוך
הצעות להתאמה של סיומת נוצרות באמצעות התאמה מדויקת של תחילית למילה האחרונה במחרוזת השאילתה.
לדוגמה, נניח שהשאילתה "שירים עם" נשלחת בבקשה להשלמה אוטומטית. כשההתאמה לסיומת מופעלת, יכול להיות שההשלמה האוטומטית לא תמצא התאמות לתחילית המלאה "שירים עם המ". עם זאת, המילה האחרונה בשאילתה, "he", היא התאמה מדויקת לתחילית של "hello world" ו-"hello kitty". במקרה כזה, ההצעות שיוחזרו הן "שירים עם Hello World" ו "שירים עם הלו קיטי" כי אין הצעות להתאמה מלאה.
אתם יכולים להשתמש בתכונה הזו כדי לצמצם את מספר התוצאות הריקות של ההצעות ולהגדיל את מגוון ההצעות. זה שימושי במיוחד במקרים שבהם מקורות הנתונים (ספירת אירועי המשתמשים, היסטוריית החיפושים והכיסוי של נושאי המסמכים) מוגבלים. עם זאת, הפעלת הצעות להתאמה לסוף יכולה להפחית את האיכות הכוללת של ההצעות. מכיוון שהתאמה לסוף המחרוזת מתאימה רק למילה האחרונה של הקידומת, יכול להיות שחלק מההצעות שיוחזרו לא יהיו הגיוניות. לדוגמה, שאילתה כמו "שירים עם" עשויה לקבל הצעה להתאמה בסוף כמו "שירים עם מילים".
הצעות להתאמה לזנב מוחזרות רק אם:
הערך של
include_tail_suggestionsמוגדר ל-trueבבקשהdataStores.completeQuery.אין הצעות להתאמה מלאה של הקידומת לשאילתה.
הגנה מפני דליפות של פרטים אישיים מזהים (PII)
ההגדרה של פרטים אישיים מזהים היא רחבה, ויכול להיות שיהיה קשה לזהות אותם. לכן, Gemini Enterprise לא יכול להבטיח שההצעות של ההשלמה האוטומטית לא יכללו פרטים אישיים מזהים.
Gemini Enterprise משתמש בשירות הבדיקה של Sensitive Data Protection כדי לחפש ולחסום סוגים נפוצים של פרטים אישיים מזהים (PII) כדי שלא יופיעו בהצעות. עם זאת, אם מאגרי הנתונים שלכם מכילים פרטים אישיים מזהים, או אם אתם משתמשים במודלים של הצעות לשאילתות של היסטוריית החיפושים או של אירועי משתמשים, כדאי לעיין במידע הבא ולפעול בהתאם:
אם סוגי הפרטים האישיים המזהים שאתם רוצים להגן עליהם הם די סטנדרטיים, כמו מספרי טלפון וכתובות אימייל, התחילו בבדיקה מקיפה של ההצעות של ההשלמה האוטומטית באפליקציה. Gemini Enterprise לא יכול להבטיח שפרטים אישיים מזהים לא יוחזרו בהצעות של ההשלמה האוטומטית.
אם מתגלות דליפות של פרטים אישיים מזהים במהלך בדיקת ההשלמה האוטומטית, או אם אתם כבר יודעים שיש לכם פרטים אישיים מזהים לא סטנדרטיים שצריך להגן עליהם (לדוגמה, מזהי משתמשים קנייניים), נסו לשנות את הסף של ההשלמה האוטומטית ואת הפרמטרים של הצגת התוכן. מידע נוסף זמין במאמר צמצום הסיכון להחזרת הצעות שמכילות פרטים אישיים מזהים.
אם שינוי הפרמטרים לא מספיק כדי למנוע דליפות של פרטים אישיים מזהים, אתם יכולים להטמיע פתרון DLP משלכם. התאימו אישית את פתרון ה-DLP לסוגי הפרטים האישיים המזהים שסביר להניח שיימצאו במאגרי הנתונים, באירועי המשתמשים או בשאילתות החיפוש של המשתמשים. אתם יכולים להשתמש ב-Sensitive Data Protection או בשירות DLP של צד שלישי. אפשר לבחור באחת מהגישות הבאות:
לסנן פרטים אישיים מזהים (PII) לפני שמייבאים את המסמכים ואירועי המשתמשים למאגרי הנתונים.
לבדוק את ההצעות של ההשלמה האוטומטית לפני שהן מוצגות למשתמש בזמן הצגת המודעות, ולחסום את ההצעות שמכילות פרטים אישיים מזהים.
אם אתם משתמשים במודל של היסטוריית החיפושים או של אירועי המשתמשים, הוסיפו טקסט הסבר בשורת החיפוש, שמבקש מהמשתמשים לא להזין פרטים אישיים מזהים בשאילתות החיפוש.
אם יש לכם שאלות או שאתם נתקלים בבעיות ספציפיות בחסימת פרטים אישיים מזהים, פנו ל-Customer Engineer (CE) או לצוות התמיכה בחשבונות Google.
הפעלה או השבתה של ההשלמה האוטומטית בווידג'ט
כדי להפעיל או להשבית את ההשלמה האוטומטית בווידג'ט, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Gemini Enterprise במסוף Google Cloud .
לוחצים על שם האפליקציה שרוצים לערוך.
לוחצים על Configurations (הגדרות).
לוחצים על הכרטיסייה UI.
כדי להפעיל או להשבית את ההצעות של ההשלמה האוטומטית בווידג'ט, מעבירים את המתג הצגת הצעות של ההשלמה האוטומטית למצב הרצוי. אחרי שמפעילים את ההשלמה האוטומטית, ההצעות יתחילו להופיע תוך יום או יומיים.
עדכון ההגדרות של ההשלמה האוטומטית
כדי לקבוע את הגדרות ההשלמה האוטומטית בממשק המשתמש, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Gemini Enterprise במסוף Google Cloud .
לוחצים על שם האפליקציה שרוצים לערוך.
לוחצים על Configurations (הגדרות).
לוחצים על הכרטיסייה השלמה אוטומטית.
מזינים או בוחרים ערכים חדשים להגדרות ההשלמה האוטומטית שרוצים לעדכן:
- מספר ההצעות המקסימלי: המספר המקסימלי של הצעות של ההשלמה האוטומטית שאפשר להציע לשאילתה.
- אורך מינימלי להפעלה: מספר התווים המינימלי שאפשר להקליד לפני שמוצגות הצעות של ההשלמה האוטומטית.
- סדר ההתאמה: המיקום במחרוזת השאילתה שבו ההשלמה האוטומטית יכולה להתחיל להתאים את ההצעות שלה.
- מודל הצעות לשאילתות: המודל שמשמש ליצירת ההצעות לשאילתות. אפשר לשנות את זה ב-
dataStores.completeQueryבאמצעות הפרמטרqueryModel. הפעלת ההשלמה האוטומטית: כברירת מחדל, ההשלמה האוטומטית לא מתחילה להציע הצעות עד שיש לה מספיק נתונים איכותיים, בדרך כלל תוך כמה ימים. אם אתם רוצים לשנות את ברירת המחדל הזו ולהתחיל לקבל הצעות של ההשלמה האוטומטית מוקדם יותר, בחרו באפשרות עכשיו.
גם אם בוחרים באפשרות עכשיו, יכול להיות שיעבור יום עד שההצעות ייווצרו, ועדיין חלק מההצעות של ההשלמה האוטומטית יהיו חסרות או באיכות נמוכה עד שיהיו מספיק נתונים טובים.
רשימת ישויות שנחסמו: ייבוא של רשימת ישויות שנחסמו כקובץ JSON בקטגוריה של Cloud Storage. למידע נוסף על המפרטים והמגבלות של רשימת החסימה, קראו את המאמר שימוש ברשימת חסימה של השלמה אוטומטית.
לוחצים על שמירה ופרסום. השינויים ייכנסו לתוקף תוך כמה דקות במנועים שבהם ההשלמה האוטומטית כבר הופעלה.
הפחתת הסיכון להצגת הצעות שמכילות פרטים אישיים מזהים (PII)
למשתמשי קצה יש כל מיני פרטים אישיים מזהים, כמו רישיונות נהיגה ומספרי טלפון, שהם אמורים לשמור על הפרטיות שלהם. עם זאת, יכול להיות שמשתמשים יקלידו פרטים אישיים מזהים בשורת החיפוש כדי למצוא תוצאות שרלוונטיות ספציפית להם.
אם אתם משתמשים במודל של היסטוריית החיפושים או של אירועי המשתמשים, ויש סיכוי שהמשתמשים יקלידו פרטים אישיים מזהים בשורת החיפוש, אתם יכולים לשנות את הפרמטרים הבאים כדי לצמצם את הסיכון לדליפה של פרטים אישיים מזהים:
queryFrequencyThreshold: מספר הפעמים שצריך להזין שאילתה כדי שהיא תוצג כהצעה של ההשלמה האוטומטית.numUniqueUsersThreshold: מספר המשתמשים הייחודיים שצריכים להזין שאילתה כדי שהיא תוצג כהצעה של ההשלמה האוטומטית. הערך של השדהuserPseudoIdבאירוע המשתמש מסוג חיפוש קובע אם המשתמש ייחודי.
תרחיש לדוגמה
לדוגמה, נניח שלמשתמשים יש מספרי חשבונות שצריכים להישאר פרטיים.
אם משתמשים במודל ההצעות של היסטוריית החיפושים או של אירועי המשתמשים, מספרי החשבונות האלה, יחד עם כל שאר המונחים שמשתמשי הקצה מחפשים, משמשים ליצירת הצעות. לכן, אם מספר החשבון של משתמש א' (YZ-46789A) הוזן שוב ושוב בשורת החיפוש, ולמשתמש ב' יש מספר חשבון YZ-42345B, כשמשתמש ב' יקליד YZ-4 בשורת החיפוש, ההצעה של ההשלמה האוטומטית שתופיע עשויה להיות מספר החשבון של משתמש א'.
כדי להפחית את הסבירות לדליפה כזו, האדמין ב-Gemini Enterprise מחליט:
מגדילים את הערך של הפרמטר
queryFrequencyThresholdל-30. במקרה כזה, לא סביר שמספר חשבון אחד יוזן כל כך הרבה פעמים. עם זאת, שאילתות חיפוש פופולריות יוזנו לפחות בתדירות הזו.מגדילים את הערך של הפרמטר
numUniqueUsersThresholdל-6. האדמין חושב שלא סביר שאותו מספר חשבון יוזן בשורת החיפוש בשישה אירועי חיפוש, שכל אחד מהם משויך ל-userPseudoIdאחר.
התהליך
יש שני פרמטרים של סף להשלמה אוטומטית.
הפרמטרים האלה לא זמינים במסוף Google Cloud , אבל אפשר להגדיר אותם באמצעות קריאה ל-API בארכיטקטורת REST ל-method updateCompletionConfig.
כדי להגדיר את סף ההשלמה האוטומטית, פועלים לפי השלבים הבאים. כל שלב הוא אופציונלי, בהתאם לפרמטר שרוצים לשנות.
REST
מעדכנים את השדה
CompletionConfig.queryFrequencyThreshold:curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig?updateMask=queryFrequencyThreshold \ -d '{ "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig", "queryFrequencyThreshold": QUERY_FREQUENCY_THRESHOLD }'מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.
-
QUERY_FREQUENCY_THRESHOLD: ערך של מספר שלם שמציין את מספר הפעמים המינימלי שצריך להזין שאילתת חיפוש כדי שהיא תוכל לחזור כהצעה של ההשלמה האוטומטית. הספירה מסוכמת על פני חלון זמן מתגלגל של חודשים. ערך ברירת המחדל הוא8.
מעדכנים את השדה
CompletionConfig.numUniqueUsersThreshold:curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig?updateMask=numUniqueUsersThreshold \ -d '{ "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig", "numUniqueUsersThreshold": UNIQUE_USERS }'מחליפים את
UNIQUE_USERSבערך של מספר שלם שמייצג את המספר המינימלי של משתמשים ייחודיים שצריכים להזין שאילתת חיפוש מסוימת כדי שהיא תוצג כהצעה של ההשלמה האוטומטית. הספירה מסוכמת על פני חלון זמן מתגלגל של כמה חודשים. ערך ברירת המחדל הוא3.
עדכון הערות של שדות שניתן להשלים בסכימה
כדי להפעיל את ההשלמה האוטומטית לשדות בסכימה של נתונים מובְנים, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Gemini Enterprise במסוף Google Cloud .
לוחצים על שם האפליקציה שרוצים לערוך. הוא חייב להשתמש בנתונים מובְנים.
לוחצים על נתונים.
לוחצים על הכרטיסייה Schema.
לוחצים על Edit כדי לבחור את שדות הסכימה שרוצים לסמן בתור
completable.לוחצים על שמירה כדי לשמור את הגדרות השדות המעודכנות. ההצעות האלה נוצרות ומוחזרות תוך יום בערך.
שליחת בקשות להשלמה אוטומטית
בדוגמאות הבאות אפשר לראות איך לשלוח בקשות להשלמה אוטומטית.
REST
כדי לשלוח בקשת השלמה אוטומטית באמצעות ה-API, פועלים לפי השלבים הבאים:
מאתרים את מזהה מאגר הנתונים. אם כבר יש לכם את מזהה מאגר הנתונים, דלגו לשלב הבא.
במסוף Google Cloud , נכנסים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
לוחצים על השם של מאגר הנתונים.
בדף Data של מאגר הנתונים, מאתרים את המזהה של מאגר הנתונים.
מבצעים קריאה ל-method
dataStores.completeQuery.curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING"מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור הצעות.
שליחת בקשה להשלמה אוטומטית למודל אחר
כדי לשלוח בקשה להשלמה אוטומטית עם מודל אחר של הצעות לשאילתות, פועלים לפי השלבים הבאים:
מאתרים את מזהה מאגר הנתונים. אם כבר יש לכם את מזהה מאגר הנתונים, דלגו לשלב הבא.
במסוף Google Cloud , נכנסים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
לוחצים על השם של מאגר הנתונים.
בדף Data של מאגר הנתונים, מאתרים את המזהה של מאגר הנתונים.
מבצעים קריאה ל-method
dataStores.completeQuery.curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING&query_model=QUERY_SUGGESTIONS_MODEL"מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה הייחודי של מאגר הנתונים שמשויך לאפליקציה.
QUERY_STRING: הקלט של ההשלמה האוטומטית שמשמש לאחזור ההצעות.
QUERY_SUGGESTIONS_MODEL: המודל של ההצעות לשאילתות שבו משתמשים בבקשה:document,document-completable,search-historyאוuser-event. לנתונים רפואיים:healthcare-default.
C#
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של C# במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise C# API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Go
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Go במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Go API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Java במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Java API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Node.js במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Node.js API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Python במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Python API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Ruby
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי הוראות ההגדרה של Ruby במדריך למתחילים של Gemini Enterprise באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Gemini Enterprise Ruby API.
כדי לבצע אימות ב-Gemini Enterprise, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
שימוש ברשימת חסימה של השלמה אוטומטית
אתם יכולים להשתמש ברשימת חסימה כדי למנוע ממונחים ספציפיים להופיע כהצעות של ההשלמה האוטומטית.
לדוגמה, ניקח חברת תרופות. אם תרופה מסוימת כבר לא מאושרת על ידי ה-FDA אבל היא מוזכרת במסמכים במאגר הנתונים, יכול להיות שהם ירצו למנוע מהתרופה הזו להופיע כשאילתה מוצעת. החברה יכולה להוסיף את שם התרופה לרשימת ישויות שנחסמו כדי למנוע את ההצעה שלה.
המגבלות הבאות חלות:
- רשימת חסימה אחת לכל מאגר נתונים
- העלאה של רשימת ישויות חסומות מחליפה את הרשימה הקיימת במאגר הנתונים הזה
- עד 1,000 מונחים בכל רשימת ישויות שנחסמו
- המונחים לא תלויי-רישיות
- אחרי שמייבאים רשימת חסימה, לוקח יום או יומיים עד שהיא נכנסת לתוקף.
כל רשומה ברשימת החסימה מורכבת מblockPhrase ומmatchOperator:
-
blockPhrase: מזינים מחרוזת בתור המונח ברשימת החסימה. המונחים לא תלויי אותיות רישיות (case-sensitive). -
matchOperator: מקבל את הערכים הבאים:-
EXACT_MATCH: מונעת הצגה של התאמה מדויקת של המונח ברשימת החסימה כהצעה לשאילתה. -
CONTAINS: מונעת את ההצגה של כל הצעה שמכילה את המונח מרשימת החסימה.
-
הנה דוגמה לרשימת ישויות שנחסמו עם ארבע רשומות:
{ "entries": [ {"blockPhrase":"Oranges","matchOperator":"CONTAINS"}, {"blockPhrase":"bAd apples","matchOperator":"EXACT_MATCH"}, {"blockPhrase":"Cool as A Cucumber","matchOperator":"EXACT_MATCH"}, {"blockPhrase":"cherry pick","matchOperator":"CONTAINS"} ] }
לפני שמייבאים רשימת חסימות, צריך לוודא שאמצעי בקרת הגישה הנדרשים מוגדרים לגישת עריכה ב-Discovery Engine.
אפשר לייבא רשימות חסימה מנתוני JSON מקומיים או מ-Cloud Storage. כדי להסיר רשימת ישויות שנחסמו ממאגר נתונים, צריך למחוק באופן סופי את רשימת ישויות שנחסמו.
ייבוא רשימת ישויות שנחסמו מנתוני JSON מקומיים
כדי לייבא רשימת ישויות שנחסמו מקובץ JSON מקומי שמכיל את רשימת ישויות שנחסמו:
יוצרים את רשימת ישויות שנחסמו בקובץ JSON מקומי בפורמט הבא. חשוב לוודא שכל רשומה ברשימת החסימה מופיעה בשורה חדשה בלי מעברי שורה.
{ "inlineSource": { "entries": [ { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" }, { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" } ] } }
שולחים בקשת POST ל-method
suggestionDenyListEntries:import, ומציינים את שם קובץ ה-JSON.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data @DENYLIST_FILE \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"מחליפים את מה שכתוב בשדות הבאים:
-
DENYLIST_FILE: הנתיב המקומי של קובץ ה-JSON שמכיל את רשימת הישויות שנחסמו.
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.
-
אחרי שמייבאים את רשימת ההחרגות, לוקח יום או יומיים עד שההצעות מתחילות לעבור סינון.
ייבוא רשימת חסימה מ-Cloud Storage
כדי לייבא רשימת ישויות שנחסמו מקובץ JSON ב-Cloud Storage, מבצעים את הפעולות הבאות:
יוצרים את רשימת הישויות שנחסמו בקובץ JSON בפורמט הבא ומייבאים אותה לקטגוריה של Cloud Storage. מוודאים שכל רשומה ברשימת החסימה מופיעה בשורה חדשה, בלי מעברי שורה.
{ "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" } { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }
יוצרים קובץ JSON מקומי שמכיל את האובייקט
gcsSource. משתמשים בזה כדי להצביע על המיקום של קובץ רשימת ישויות שנחסמו בקטגוריה של Cloud Storage.{ "gcsSource": { "inputUris": [ "DENYLIST_STORAGE_LOCATION" ] } }
מחליפים את
DENYLIST_STORAGE_LOCATIONבמיקום של רשימת החסימה ב-Cloud Storage. אפשר להזין רק URI אחד. צריך להזין את ה-URI בפורמט הבא:gs://BUCKET/FILE_PATH.שולחים בקשת POST ל-method
suggestionDenyListEntries:import, כולל האובייקטgcsSource.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data @GCS_SOURCE_FILE \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"מחליפים את מה שכתוב בשדות הבאים:
-
GCS_SOURCE_FILE: הנתיב המקומי של הקובץ שמכיל את האובייקטgcsSourceשמפנה לרשימת החסימה.
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.
-
אחרי שמייבאים את רשימת ההחרגות, לוקח יום או יומיים עד שההצעות מתחילות לעבור סינון.
מחיקה סופית של רשימת ישויות חסומות
כדי למחוק באופן סופי רשימת ישויות שנחסמו ממאגר הנתונים:
שולחים בקשת POST ל-method
suggestionDenyListEntries:purge.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:purge"מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.
שימוש ברשימה מיובאת של הצעות להשלמה אוטומטית
אתם יכולים לספק רשימה משלכם של הצעות של ההשלמה האוטומטית, במקום להשתמש בהצעות של ההשלמה האוטומטית שנוצרות ממודל נתונים של השלמה אוטומטית.
- נרמול טקסט. הטקסט של ההצעה מופיע באותיות קטנות, מנורמל לפי Unicode, הרווחים הפנימיים בו מכווצים, הגרשיים המסולסלים (U+2018, U+2019) מקופלים לגרש ASCII (U+0027), והוסרו ממנו תווי המירכאות הכפולות המוטמעים והנקודות בסוף.
- סינון לפי אורך. הצעות עם פחות מ-3 תווים או יותר מ-125 תווים נמחקות.
- ביטול כפילויות באמצעות צבירת ציונים. אם שתי הצעות מיובאות או יותר עוברות נורמליזציה לאותו טקסט (לדוגמה,
"Pixel 10 Pro Moonstone"ו-"Pixel 10 Pro moonstone", או"jobseeker’s allowance"עם גרש מעוגל ו-"jobseeker's allowance"עם גרש ASCII), הן מתמזגות להצעה אחת שהניקוד שלה הוא סכום הניקוד של הקלט. אם אתם רוצים שהניקוד של ההצעה יישמר כמו שהוא, שלחו כל הצעה נפרדת פעם אחת בלבד. - סינון פרטים אישיים מזהים. הצעות שמזוהות כמכילות פרטים אישיים מזהים מסוננות.
- סינון לפי רשימת חסימה. הצעות שתואמות לביטויים ברשימת ההצעות החסומות של מאגר הנתונים מסוננות.
SafeSearch לא חל על הצעות מיובאות. באחריותכם לוודא שההצעות המיובאות מתאימות למשתמשים שלכם.
ברוב האפליקציות, שימוש בהצעות שנוצרו על ידי אחד ממודלי הנתונים של ההשלמה האוטומטית מניב תוצאות טובות יותר. עם זאת, יכולים להיות מקרים נדירים שבהם ההצעות של המודל לא מתאימות לצרכים שלכם, ורשימה נפרדת של הצעות תספק למשתמשים חוויית השלמה אוטומטית טובה יותר.
לדוגמה, חנות ספרים אינטרנטית קטנה מייבאת את רשימת שמות הספרים שלה כהצעות של ההשלמה האוטומטית. כשהלקוח מתחיל להקליד בסרגל החיפוש, ההצעה של ההשלמה האוטומטית תמיד תהיה שם של ספר מהרשימה שיובאה. כשרשימת הספרים משתנה, חנות הספרים מוחקת את הרשימה הנוכחית ומייבאת את הרשימה החדשה. קטע מהרשימה יכול להיראות בערך כך:
{"suggestion": "Wuthering Heights", "globalScore": "0.52" },
{"suggestion": "The Time Machine", "globalScore": "0.26" },
{"suggestion": "Nicholas Nickleby", "globalScore": "0.38" },
{"suggestion": "A Little Princess", "globalScore": "0.71" },
{"suggestion": "The Scarlet Letter", "globalScore": "0.32" }
הערך globalScore הוא מספר בשיטת נקודה צפה בטווח [0, 1] שמשמש לדירוג ההצעה. אפשר גם להשתמש בציון frequency שהוא מספר שלם שגדול מ-1. הציון frequency משמש לדירוג ההצעות כש-globalScore לא זמין (מוגדר כ-null).
לפני שמתחילים
כדי לייבא הצעות של ההשלמה האוטומטית, צריך את התפקיד אדמין ב-Discovery Engine ב-IAM, שכולל את ההרשאה discoveryengine.completionSuggestions.import.
מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.
הגדרה וייבוא של הצעות של ההשלמה האוטומטית
כדי להגדיר ולייבא רשימה של הצעות של ההשלמה האוטומטית מ-BigQuery, צריך לבצע את השלבים הבאים:
יוצרים רשימה של הצעות וטוענים אותה לטבלה ב-BigQuery.
צריך לספק לפחות כל הצעה כמחרוזת וציון גלובלי או תדירות.
צריך להשתמש בסכימת הטבלה הבאה לרשימת ההצעות:
[ { "description": "The suggestion text", "mode": "REQUIRED", "name": "suggestion", "type": "STRING" }, { "description": "Global score of this suggestion. Control how this suggestion would be scored and ranked. Set global score or frequency; not both.", "mode": "NULLABLE", "name": "globalScore", "type": "FLOAT" }, { "description": "Frequency of this suggestion. Used to rank suggestions when the global score is not available.", "mode": "NULLABLE", "name": "frequency", "type": "INTEGER" } ]במאמרי העזרה של BigQuery מוסבר איך ליצור טבלה ב-BigQuery ולטעון את הטבלה עם רשימת ההצעות של ההשלמה האוטומטית.
מייבאים את הרשימה מ-BigQuery.
שולחים בקשת POST ל-method
completionSuggestions:import, כולל האובייקטbigquerySource.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:import" \ -d '{ "bigquery_source": {"project_id": "PROJECT_ID_SOURCE", "dataset_id": "DATASET_ID", "table_id": "TABLE_ID"} }'מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud . -
DATA_STORE_ID: המזהה של מאגר הנתונים. -
PROJECT_ID_SOURCE: הפרויקט שמכיל את מערך הנתונים שרוצים לייבא. -
DATASET_ID: מזהה מערך הנתונים של רשימת ההצעות שרוצים לייבא -
TABLE_ID: מזהה הטבלה של רשימת ההצעות שרוצים לייבא
-
אופציונלי: שימו לב לערך
nameשמוחזר, ופעלו לפי ההוראות במאמר קבלת פרטים על פעולה ממושכת כדי לראות מתי פעולת הייבוא הושלמה.אם לא הפעלתם את ההשלמה האוטומטית באפליקציה, פועלים לפי ההליך עדכון הגדרות ההשלמה האוטומטית. חשוב להגדיר את האפשרות הפעלת השלמה אוטומטית לערך עכשיו.
צריך להמתין כמה ימים עד שההוספה לאינדקס תסתיים וההצעות המיובאות יהיו זמינות.
שליחת בקשה להשלמה אוטומטית
כדי לשלוח בקשה להשלמה אוטומטית שמחזירה הצעה מיובאת במקום הצעה ממודל של השלמה אוטומטית:
- פועלים לפי ההוראות לשליחת בקשה להשלמה אוטומטית למודל אחר ומגדירים את
QUERY_SUGGESTIONS_MODELלערךimported-suggestion.
מחיקת הרשימה של ההצעות המיובאות של ההשלמה האוטומטית
לפני שמייבאים רשימה חדשה של הצעות להשלמה אוטומטית, צריך להסיר את הרשימה הקיימת.
כדי למחוק באופן סופי רשימה קיימת של הצעות של ההשלמה האוטומטית, פועלים לפי השלב הבא:
שולחים בקשת POST ל-method
completionSuggestions:purge.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:purge"מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
DATA_STORE_ID: המזהה של מאגר הנתונים שמשויך לאפליקציה.
אופציונלי: שימו לב לערך
nameשמוחזר, ופעלו לפי ההוראות במאמר קבלת פרטים על פעולה ממושכת כדי לראות מתי פעולת הטיהור מסתיימת.
מודל נתונים מתקדם של מסמכים
Gemini Enterprise מספק מודל נתונים מתקדם להשלמה אוטומטית. מודל הנתונים הזה יוצר הצעות איכותיות להשלמה אוטומטית על סמך המסמכים שאתם מייבאים, באמצעות מודלים גדולים של שפה (LLM) של Google.
התכונה הזו היא ניסיונית. אם אתם רוצים להשתמש בתכונה הזו, פנו לצוות ניהול החשבון שלכם ב- Google Cloud ובקשו להוסיף אתכם לרשימת ההיתרים.
מודל הנתונים המתקדם של מסמכים לא זמין לחיפוש בתחום הבריאות או במספר אזורים בארה"ב ובאיחוד האירופי.