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

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

סינון חיפושים לפי רלוונטיות ברמת המסמך (מאמר שמתייחס לגרסה קודמת)

הערה: התכונה הזו היא מוצר בגרסת טרום-GA, והשימוש בה כפוף ל "תנאי השימוש במוצרים בגרסת טרום-GA" בתנאים הספציפיים לשירותי GCP. יכול להיות שהתמיכה במוצרים ובתכונות בגרסת טרום-GA תהיה מוגבלת, ושהשינויים במוצרים ובתכונות בגרסת טרום-GA לא יהיו תואמים לגרסאות אחרות של טרום-GA. מידע נוסף זמין בקטע תיאורים של שלבי ההשקה. בנוסף, השימוש בתכונה הזו מבטא את הסכמתכם לתנאים ולהגבלות של גרסת טרום-ההשקה (Preview) של AI גנרטיבי ("תנאי גרסת טרום-ההשקה"). אתם יכולים להשתמש בתכונה הזו כדי לעבד מידע אישי כמו שמפורט בנספח לעיבוד נתונים ב-Cloud, בכפוף להגבלות ולמחויבויות הרלוונטיות בהסכם (כפי שמוגדר בתנאי השימוש בגרסת טרום-ההשקה).

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

מידע על סינון לפי רלוונטיות ברמת המסמך

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

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

סוגי הנתונים והאפליקציות שנתמכים במסנן הרלוונטיות ברמת המסמך

אפשר להחיל את מסנן הרלוונטיות ברמת המסמך על מאגרי נתונים עם סוגי הנתונים הבאים:

נתוני אתרים עם תהליך מתקדם להוספת אתרים לאינדקס
נתונים לא מובְנים בהתאמה אישית
נתונים מובְנים בהתאמה אישית

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

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

סוגים אחרים של מסננים

מסנן הרלוונטיות ברמת המסמך הוא לא הדרך היחידה לסנן נתונים שמוחזרים על ידי שאילתות. אפשר גם להשתמש בביטויי סינון כדי לסנן תוצאות על סמך מטא-נתונים (בנתונים לא מובְנים עם מאגרי נתונים של מטא-נתונים) וערכי שדות (במאגרי נתונים מובְנים).

מידע נוסף זמין במאמר בנושא סינון חיפושים באמצעות מטא-נתונים.

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

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

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

חיפוש וסינון תוצאות לפי רלוונטיות ברמת המסמך

כדי לסנן לפי רלוונטיות:

הערה: אפשר לחפש באפליקציה באמצעות השיטה engines.servingConfigs.search, ואפשר לחפש במאגר נתונים באמצעות השיטה dataStores.servingConfigs.search. כדי לבצע את הפעולה הבאה, Google ממליצה לחפש באמצעות engines.servingConfigs.search.

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

כדי לסנן את החיפוש לפי רלוונטיות ברמת המסמך, משתמשים בשדה relevanceThreshold עם השיטה engines.servingConfigs.search.

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש לחלופין למונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
 "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"relevanceThreshold": "RELEVANCE_THRESHOLD"
}'

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

‫PROJECT_ID: מזהה הפרויקט.
‫APP_ID: המזהה של האפליקציה שרוצים לשלוח אליה שאילתה.
‫QUERY: טקסט השאילתה לחיפוש.
‫RELEVANCE_THRESHOLD: אחת מהאפשרויות הבאות: HIGH, ‏ MEDIUM, ‏ LOW,‏ LOWEST.

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

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search",
"query": "What is the check grounding API",
"relevanceThreshold": "HIGH"
}'

{
"results": [
{
  "id": "a082e70352c073a4443502477255bd2a",
  "document": {
    "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/a082e70352c073a4443502477255bd2a",
    "id": "a082e70352c073a4443502477255bd2a",
    "derivedStructData": {
      "displayLink": "cloud.google.com",
      "link": "https://cloud.google.com/example/docs/check-grounding",
      "htmlTitle": "Check grounding | Example | Google Cloud",
      "title": "Check grounding | Example | Google Cloud"
    }
  }
}
],
"totalSize": 1,
"attributionToken": "f_B-CgwIidzwswYQyue15gESJDY2N2M1NmJkLTAwMDAtMjk3Ni1iMGI4LTg4M2QyNGZmNTZhOCIHR0VORVJJQypAjr6dFavEii3b7Ygt3o-aIoCymiLC8J4Vo4CXIra3jC3Usp0V24-aIt7tiC3n7YgtrsSKLeTtiC2DspoixsvzFw",
"guidedSearchResult": {},
"summary": {}
}

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

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