通則

搜尋結果

最多可傳回多少結果？

由於實作詳細資料不同，每個查詢傳回的結果數量上限也會有所差異。系統最多保證傳回 500 個結果。如果要求更多，系統可能無法滿足要求數量。

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

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

您可以根據自己的實驗設定門檻。如要設定門檻，請根據每個項目標籤設定門檻。也就是說，您應為「鞋子」設定結果分數門檻，與「包包」等每個標籤無關。

如何得知特定結果的排名高於其他結果的原因？

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

使用 productGroupedResults 與使用 Vision API 的物件定位器功能有何不同？

productGroupedResults 回應會傳回偵測到的項目清單、預測標籤和分數、周框，以及每個項目的產品搜尋結果排名清單。這項回應等同於先將查詢圖片傳送至 Vision API 的物件定位器功能，然後將圖片連同每個產品項目的周框 (篩選至相關標籤) 傳送至 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 的準確度，最好的方法是為產品新增更多優質的參考圖片。如果已上傳代表性的產品圖片，但仍想提高部分產品的準確度，可以使用其他現有圖片，或為這些產品收集更多圖片。

如要使用其他現有圖片，請確保圖片清楚呈現產品，且沒有其他會造成干擾的物體。舉例來說，你可能擁有模特兒穿著特定襯衫和長褲的相片。這張圖片本身不適合做為襯衫產品的參考圖片。不過，如果提供襯衫的定界框，或裁剪圖片只保留襯衫，就會是很好的參考圖片。您可以使用 Vision API 的物件定位器功能建議方塊。這個方法可與人工提供的註解搭配使用，或取代人工提供的註解。

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

加入現有參考圖片的擴增版本 (例如左右翻轉、對比度抖動等) 的想法很合理，但通常對提高準確度沒有太大幫助。

資料管理

在正式環境中更新產品組合時，建議採取什麼做法？

隨著庫存變動，更新產品組合並加入新產品。如果變更幅度不大，可以視需要新增或刪除產品。或者，如果目錄或參考圖片有重大變更，您可以建立新的產品組合並進行變更，然後先測試搜尋品質，再全面改用新的組合。無論是哪種情況，您都應儲存批次匯入 CSV 檔案，以便輕鬆參考或還原，追蹤產品集中有哪些產品和圖片。