通則

搜尋結果

傳回的結果數上限為何？

由於實作細節不同，每個查詢傳回的結果數量上限也會有所不同。系統保證會傳回的結果數量上限為 500 個。如果要求的數量超過此上限，可能無法滿足要求。

我可以為結果設定分數門檻嗎？

搜尋結果分數未經校正。也就是說，特定查詢的結果分數會可相互比較 (這是結果的排名方式)。不過，查詢 A 和查詢 B 的結果分數不一定可相互比較。也就是說，沒有一個固定的門檻適合所有用途。

您可以根據自己的實驗設定門檻。如果您想設定門檻，請根據個別商品標籤設定這個門檻。也就是說，您應為每個標籤的「鞋子」和「包包」等設定個別的結果分數門檻。

有沒有辦法瞭解特定結果的排名為何高於其他結果？

目前 Vision API Product Search 不支援任何可說明為何傳回特定結果的功能。

使用 productGroupedResults 和使用 Vision API 的 Object Localizer 功能有何差異？

productGroupedResults 回應會傳回已偵測到的項目清單、預測標籤和分數、邊界框，以及每個項目的產品搜尋結果排名清單。這個回應等同於先將查詢圖片傳送至 Vision API 的 Object Localizer 功能，然後再將圖片連同每個產品項目邊界框 (篩選為相關標籤) 傳送至 Vision API Product Search。

使用 productGroupedResults 的好處之一，是它只會發出單一 API 呼叫，因此速度更快且更直接。不過，如果在物件偵測和搜尋查詢之間需要實作一些自訂應用程式邏輯，則兩步驟方法是個不錯的做法。舉例來說，您可以根據物件標籤新增 Vision API 產品搜尋篩選器。

如果我知道圖片中產品的位置，應先裁剪圖片，再使用該圖片查詢 API 嗎？

舉例來說，如果使用者可以畫出要搜尋項目的邊界框，就可能發生這種情況。一般來說，您不應在將圖片傳送至 API 前先裁剪圖片。原因是我們的 API 會同時使用查詢邊界框來傳回指定結果和整體圖片內容，這通常有助於改善結果。

參考圖片

什麼是好的產品參考圖片？

好的參考圖片應清楚顯示產品，且圖片中不得有任何其他物件。「包裝照」圖片就是優質參考圖片的典型範例。這類圖片經常用於在產品頁面或廣告中向使用者展示產品，通常會在白色背景前拍攝。產品在其他環境中的圖片也是不錯的參考圖片，前提是圖片中沒有任何其他產品。請使用所有可用於參考圖片的圖片。

參考圖片和用於搜尋產品的圖片，理想的圖片大小為何？

理想的圖片會以產品為主角，且產品會佔據圖片的大部分空間；如果圖片中只有小部分或模糊不清的產品，就無法獲得理想的結果。因此，圖片中的產品實際大小比特定圖片大小更重要。不過，一般建議你使用最長邊為 600 像素以上的圖片做為參考和搜尋圖片。

特定產品的參考圖片數量應為多少？

即使只有一張產品參考圖片，Vision API Product Search 也能正常運作。通常 3 到 8 張圖片就能提供必要資訊，讓 Vision API Product Search 提供適當的結果，尤其是這些圖片有變化時。這些變化包括產品的不同方向、不同光線或背景。您可以將其他參考圖片新增至索引，這通常不會降低準確度。

如何取得更多產品參考圖片？

如要提高 Vision API Product Search 的準確度，最好的方法就是為產品新增更多良好的參考圖片。如果您已上傳代表性產品圖片組，但仍想提高部分產品的準確度，可以使用其他現有圖片，或為這些產品收集更多圖片。

如要使用其他現有圖片，請確保圖片清楚呈現產品，且沒有其他干擾物。舉例來說，您可能有模特兒穿著特定襯衫和褲子的相片。這張圖片本身並非襯衫產品的理想參考圖片。不過，如果您提供圍繞 T 恤的定界框，或是裁剪圖片只保留 T 恤，這會是很好的參考圖片。您可以使用 Vision API 的物件定位器功能，提出建議的方塊。這個方法可與人工提供的邊界框註解一併使用，也可以取代該註解。

在產品組合中新增資料擴增資料，是否有助於提升 API 的準確度？

雖然新增現有參考圖片的擴增版本 (例如左右翻轉、抖動對比等) 的想法很合理，但通常不會提高準確度。

資料管理

在實際工作環境中更新產品組合的建議做法為何？

隨著商品目錄變更，請更新產品組合，加入新產品。如果變更幅度不大，您可以視需要新增或刪除產品。或者，如果廣告空間或參考圖片有重大變更，你可以建立新的產品組合，並在完全改用新組合前測試搜尋品質。無論是哪種情況，您都應儲存批次匯入 CSV 檔案，以便追蹤產品集中的產品和圖片，方便參考或回復。