集合 API 注意事項

下表顯示 v1 和 v2 集合 API 之間的重要差異。

查詢附註

• v2 查詢會傳回專案中所有集合的結果。 若要限制查詢只使用專案內的特定集合，請使用 collection_ids 查詢參數。 您無法使用一個 v2 查詢要求來查詢新增至不同專案的多個集合。

• v2 結果包含 confidence 欄位，但不包含 score 欄位。

  信任評分已取代 v1中的評分資訊，但基於舊版相容性而保留評分。 在 v2中，只會傳回 confidence 欄位。

• 使用 POST 呼叫 (而非 GET 呼叫)，以 v2來提交查詢。

• v1 查詢接受許多參數。 查詢參數比較 表格會將 v1 參數對映至 v2 參數。

  查詢參數比較

  v1 參數	v2 參數	附註
  N/A	collection_ids	在 v2 中使用這個參數來指定集合 ID。
  過濾器	過濾器	相同的表示式語言。
  查詢	查詢	相同的表示式語言。
  natural_language_query	natural_language_query	無附註。
  passages	passages	在 v2中，段落格式已變更且已加強。 passages:true 參數已變更為 passages.enable:true。 除了 count、characters 及 fields 選項之外，您還可以指定 per_document(依文件品質對文件進行分級)，然後傳回每個文件的最高等級段落。 您也可以指定 find_answers 來傳回每個段落的回答物件，其中包含查詢的簡潔回答。
  聚集	聚集	相同的表示式語言。
  計數	計數	無附註。
  偏移	偏移	無附註。
  RETURN	RETURN	無附註。
  排序	排序	無附註。
  highlight	highlight	如果 passages.enabled 和 passages.per_document 是 true，則會傳回每一個文件的段落，而不是強調顯示。
  拼字建議	拼字建議	無附註。
  deduplicate	N/A	v2 中不支援。
  similar	similar	格式在 v2中已變更。 similar:true 參數已變更為 similar.enable:true。 document_ids 和 fields 參數已從字串變更為字串陣列。 如果 enabled 為 true，則現在需要 document_ids 參數。
  bias	N/A	v2 中不支援。