本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 提交意見回饋以進行增量學習
<a name="submitting-feedback"></a>

**注意**  
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您正在使用的索引類型和搜尋 API 是否支援此功能，請參閱[索引類型](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)。

Amazon Kendra 使用累加式學習來改善搜尋結果。使用來自查詢的意見回饋，累加式學習可改善排名演算法，並最佳化搜尋結果以提高準確性。

例如，假設您的使用者搜尋片語「醫療保健優勢」。如果使用者一致地從清單中選擇第二個結果，隨著時間 Amazon Kendra 推移，該結果會提升為第一個結果。提升會隨著時間減少，因此如果使用者停止選取結果， Amazon Kendra 則通常會將其移除，並改為顯示另一個更熱門的結果。這有助於根據相關性、存留期和內容來排定結果的 Amazon Kendra 優先順序。

為所有索引和所有[支援的文件類型](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)啟用增量學習。

Amazon Kendra 只要您提供意見回饋， 就會開始學習，但可能需要 24 小時才能查看意見回饋的結果。 Amazon Kendra 提供三種提交意見回饋的方法： AWS 主控台、您可以包含在搜尋結果頁面上的 JavaScript 程式庫，以及您可以使用的 API。

Amazon Kendra 接受兩種類型的使用者意見回饋：
+ **按一下** - 有關使用者選擇哪些查詢結果的資訊。意見回饋包含結果 ID 和選取搜尋結果的日期和時間的 Unix 時間戳記。

  若要提交點選意見回饋，您的應用程式必須從使用者的活動收集點選資訊，然後將該資訊提交至 Amazon Kendra。您可以使用 主控台、JavaScript 程式庫和 Amazon Kendra API 收集點選資訊。
+ **Relevance** - 有關使用者通常提供的搜尋結果相關性的資訊。意見回饋包含結果 ID 和相關性指標 (`RELEVANT` 或 `NOT_RELEVANT`)。使用者決定相關性資訊。

  若要提交關聯性意見回饋，您的應用程式必須提供意見回饋機制，允許使用者為查詢結果選擇適當的關聯性，然後將該資訊提交給 Amazon Kendra。您只能使用 主控台和 Amazon Kendra API 收集相關資訊。

回饋會在索引處於作用中狀態時使用。意見回饋只會影響提交到的索引，無法跨索引或用於不同的帳戶。

當您查詢 Amazon Kendra 索引時，應該提供額外的使用者內容。當您提供使用者內容時， Amazon Kendra 能夠判斷意見回饋是由單一使用者或多個使用者提供，並相應地調整搜尋結果。

當您提供使用者內容時，查詢的意見回饋會與內容中提供的特定使用者相關聯。如果您未指定使用者內容，您可以提供用於分組和彙總查詢的訪客 ID。

如果您未提供使用者內容或訪客 ID，則意見回饋會匿名，並與其他匿名意見回饋彙總。

下列程式碼說明如何將使用者內容包含為字符或訪客 ID。

```
response = kendra.query(
    QueryText = query,
    IndexId = index,
    UserToken = {
        Token = "{{token}}"
    })
    
    OR
    
    response = kendra.query(
    QueryText = query,
    IndexId = index,
    VisitorId = "{{visitor-id}}")
```

對於 Web 應用程式，您可以使用 Cookie、位置或瀏覽器使用者來為每個使用者產生訪客 ID。

對於頭部查詢，提供點擊回饋的最大查詢量提供足夠的資訊來提高整體準確性。對於尾端查詢，很少見的主題專家應提交相關和非相關的意見回饋，以提高這些查詢的準確性。

除了 主控台之外，您還可以使用兩種方法之一：JavaScript 程式庫或 [SubmitFeedback](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html) API。您應該只使用一種收集意見回饋的方法。為了獲得最佳結果，您應該在提出查詢的 24 小時內提交意見回饋。

**Topics**
+ [使用 Amazon Kendra JavaScript 程式庫提交意見回饋](feedback-javascript.md)
+ [使用 Amazon Kendra API 提交意見回饋](feedback-api.md)