חיפוש תמונות באתרים

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

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

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

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

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

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

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

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

  2. מבצעים קריאה ל-method‏ engines.servingConfigs.search ומציינים 1 עבור search_type. בוחרים את תחביר השיטה בהתאם לסוג השאילתה: טקסט או בייטים של תמונה.

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

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    השאילתה היא תמונה

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/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",
"imageQuery": {"imageBytes":"IMAGE_BYTES"},
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

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

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

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

    • ‫QUERY: הטקסט של שאילתת החיפוש. לדוגמה, "מכוניות עם פנסים עגולים" או "תראה לי שמלה עם פסים".

    • ‫IMAGE_BYTES: התמונה בבייטים בקידוד Base64. הפורמטים הנתמכים הם JPEG,‏ PNG ו-BMP.

    • ‫PAGE_SIZE: אופציונלי. מספר התוצאות שהוחזרו על ידי החיפוש. ערך ברירת המחדל הוא 10 לחיפוש באתר.

      • ערכים שקטנים מ-0 גורמים לשגיאה.
      • אם הערך יהיה מעל 100, המערכת תגדיר אותו ל-100.

    • ‫OFFSET: אופציונלי. האינדקס ההתחלתי של התוצאות. ערך ברירת המחדל הוא 0.

      לדוגמה, אם ההיסט הוא 2 וגודל הדף הוא 10, התוצאות שיוחזרו הן 2 עד 11.

  3. בודקים את התשובה. בטבלה הבאה מפורטים תיאורי השדות:

    שדה תיאור
    title הכותרת של דף האינטרנט שמכיל את התמונה, בטקסט פשוט
    htmlTitle הכותרת, ב-HTML, של דף האינטרנט שמכיל את התמונה
    displayLink גרסה מקוצרת של כתובת ה-URL של תוצאת החיפוש, בדרך כלל שם הדומיין – לדוגמה, www.example.com
    link כתובת ה-URL של התמונה
    image.contextLink קישור להקשר: כתובת URL שמפנה לדף האינטרנט שמכיל את התמונה
    image.byteSize גודל התמונה, בבייטים
    image.width רוחב התמונה, בפיקסלים
    image.height גובה התמונה, בפיקסלים
    image.thumbnailWidth הרוחב של התמונה הממוזערת, בפיקסלים
    image.thumbnailHeight הגובה של התמונה הממוזערת, בפיקסלים
    image.thumbnailLink כתובת ה-URL של התמונה הממוזערת
    mime סוג ה-MIME של התמונה
    fileFormat פורמט הקובץ של התמונה