הזמנת תוצאות ממאגרי נתונים מובְנים

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

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

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

סוגי הנתונים הנתמכים לסידור התוצאות

אלה סוגי השדות שאפשר למיין לפיהם את תוצאות החיפוש:

• string
• number
• datetime
• geolocation

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

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

איך מסדרים את תוצאות החיפוש

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

REST

כדי להשתמש ב-API כדי להזמין את תוצאות החיפוש של אפליקציה עם נתונים מובְנים או נתונים לא מובְנים עם מטא-נתונים, משתמשים בשיטה engines.servingConfigs.search:

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

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

   1. נכנסים לדף AI Applications במסוף Google Cloud .

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

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

2. יוצרים שאילתת חיפוש וכוללים את השדה orderBy.

   מונח מרכזי: בחיפוש מבוסס סוכנים, המונח אפליקציה יכול לשמש לחלופין למונח מנוע בהקשר של ממשקי API.

   curl -X POST -H "Authorization: Bearer $(gcloud auth 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",
   "orderBy": "ORDER_BY"
   }'
   

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

   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
   • ‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
   • ‫QUERY: טקסט השאילתה לחיפוש.
   • ‫ORDER_BY: הסדר שבו התוצאות מסודרות. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. לדוגמה, אם מציינים date התוצאות יוחזרו מהישנה לחדשה. כדי לקבל סדר מיון יורד, מוסיפים desc לערך date – לדוגמה, date desc. דוגמאות נוספות זמינות במאמר דוגמאות לorderBy.

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

   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-app/servingConfigs/default_search:search" \
   -d '{
       "query": "hotel",
       "orderBy": "rating desc"
      }'
       
   
   {
   "results": [
   {
     "id": "10d480b19c256bb1",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10d480b19c256bb1",
       "id": "10d480b19c256bb1",
       "structData": {
         "available_date": "2023-11-05",
         "amenities": [
           "Lake Views",
           "Private Beach",
           "Spa",
           "Water Activities"
         ],
         "room_types": [
           "Lakefront Suite",
           "Deluxe Room",
           "Cottage"
         ],
         "location": {
           "address": "988 Serenity Circle, Tranquil Town, NV 89501, USA"
         },
         "rating": 4.6,
         "id": 11,
         "price_per_night": 220.5,
         "title": "Serenity Springs Hotel"
       }
     }
   },
   {
     "id": "9ffae8af37cc8b63",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/9ffae8af37cc8b63",
       "id": "9ffae8af37cc8b63",
       "structData": {
         "title": "Riverfront Plaza Hotel",
         "rating": 4.2,
         "location": {
           "address": "101 Main St, Anytown, CA 94501, USA"
         },
         "price_per_night": 145.8,
         "amenities": [
           "Fitness Center",
           "Conference Rooms",
           "Restaurant",
           "Valet Parking"
         ],
         "id": 3,
         "room_types": [
           "Executive Suite",
           "King Room",
           "Double Queen"
         ],
         "available_date": "2023-11-15"
       }
     }
   },
   {
     "id": "3be9e854d8f3a47f",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/3be9e854d8f3a47f",
       "id": "3be9e854d8f3a47f",
       "structData": {
         "amenities": [
           "Oceanfront Views",
           "Pool",
           "Spa",
           "Beachside Dining"
         ],
         "available_date": "2023-09-18",
         "location": {
           "address": "449 Oceanfront Drive, Seaside Resort, CA 92007, USA"
         },
         "id": 13,
         "title": "Ocean Breeze Hotel",
         "room_types": [
           "Ocean View Suite",
           "Deluxe Room",
           "Family Suite"
         ],
         "rating": 4.1,
         "price_per_night": 180
       }
     }
   }
   ],
   "totalSize": 3,
   "attributionToken": "wAHwvwoMCNDYz7UGEMCklrsCEiQ2NmIzYmU5My0wMDAwLTIxMDUtYmUyNy01ODI0MjljMzdlZTQiB0dFTkVSSUMqgAHd1akt3e2ILebtiC2CspoigLKaIpjeqC-q-LMtjr6dFeqCsS2W3qgvwvCeFaz4sy2jgJcinta3LeiCsS3b7Ygt5O2ILa3Eii3Usp0Vpp-VLZzWty359rMt-_azLaCJsy3dj5oixcvzF6vEii2iibMttreMLd_VqS3bj5oipJ-VLQ",
   "guidedSearchResult": {},
   "summary": {}
   }
       

   בדוגמה הזו, המסמכים שמכילים את המילה hotel מסודרים לפי דירוג, מהמלון Serenity Springs עם דירוג של 4.6 ועד המלון Ocean Breeze עם דירוג של 4.1.

orderBy דוגמאות

כדי להזמין בשדה מחרוזת שנקרא title:

• "orderBy": "title" כדי להחזיר את המסמכים בסדר אלפביתי עולה לפי שם.

• ‫"orderBy": "title desc" כדי להחזיר את המסמכים ממוינים בסדר אלפביתי הפוך (מ-Z עד A) לפי הכותרת.

כדי להזמין בשדה מספר שנקרא rating:

• ‫"orderBy": "rating" כדי למיין מהדירוג הנמוך ביותר לגבוה ביותר.

• ‫"orderBy": "rating desc" כדי לסדר את המסמכים מהדירוג הגבוה ביותר לנמוך ביותר.

כדי להזמין בשדה של תאריך ושעה שנקרא available_date:

• ‫"orderBy": "available_date" כדי להזמין מהמסמך הקרוב ביותר למועד ההזמנה ועד למסמך הרחוק ביותר.

• ‫"orderBy": "available_date desc" כדי להזמין מהמסמך עם התאריך הזמין המרוחק ביותר ועד המסמך עם התאריך הזמין הקרוב ביותר.

כדי להזמין לפי מיקום גיאוגרפי בשדה שנקרא location:

• ‫"orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" ממיין את המסמכים לפי המרחק שלהם מ-Mountain View, מהקרוב ביותר ועד הרחוק ביותר.

• ‫"orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" ממיין את המסמכים לפי המרחק מהמיקום 37.38°N ו-122.08°W, מהרחוק ביותר לקרוב ביותר.