在網站上搜尋圖片

透過 Vertex AI Search，您可以使用含有網站資料的應用程式搜尋圖片。您以文字字串或圖片的形式提供查詢，而 default_config.search 方法會傳回該查詢的圖片。

注意： 無法使用 Google Cloud 控制台進行圖片搜尋。

事前準備

請確認您符合下列必要條件。需求條件因搜尋方式而異， 包括使用文字查詢或圖片查詢。

• 如果您在網站搜尋應用程式中使用文字查詢進行搜尋，請確認已啟用下列功能：Enterprise 版功能

• 如果您在網站搜尋應用程式中使用圖片查詢搜尋，請確認已啟用下列項目：

  • Enterprise 版功能

  • 進階網站索引建立功能

預覽圖片搜尋結果

如要使用指令列預覽網站的圖片搜尋結果，請使用 engines.servingConfigs.search 方法：

注意：您可以使用 engines.servingConfigs.search 方法搜尋應用程式，並使用 dataStores.servingConfigs.search 方法搜尋資料儲存庫。Google 建議您使用 engines.servingConfigs.search 方法進行搜尋，以完成下列程序。

1. 找出應用程式 ID。如果已有應用程式 ID，請跳到下一個步驟。

   1. 前往 Google Cloud 控制台的「AI Applications」頁面。

      前往「應用程式」

   2. 在「應用程式」頁面中，找出應用程式名稱，然後從「ID」欄取得應用程式的 ID。

2. 呼叫 engines.servingConfigs.search 方法，並為 search_type 指定 1。根據查詢內容是文字還是圖片位元組，選擇方法語法。

   重要詞彙：在 Vertex AI Search 中，API 相關的「應用程式」一詞可與「引擎」互換使用。

   查詢是文字字串

   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：您的專案 ID。

   • APP_ID：應用程式 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	這項搜尋的結果網址縮寫版，通常是網域名稱，例如 www.example.com
   link	圖片的網址
   image.contextLink	內容連結：指向包含圖片的網頁網址
   image.byteSize	圖片大小 (以位元組為單位)
   image.width	圖片寬度 (以像素為單位)
   image.height	圖片高度 (以像素為單位)
   image.thumbnailWidth	縮圖的寬度 (以像素為單位)
   image.thumbnailHeight	縮圖的高度 (以像素為單位)
   image.thumbnailLink	縮圖網址
   mime	圖片的 MIME 類型
   fileFormat	圖片的檔案格式