使用 Amazon Kendra JavaScript 程式庫提交意見回饋

Amazon Kendra 提供 a JavaScript 程式庫，可用來將點選意見回饋新增至搜尋結果頁面。若要使用程式庫，請在用戶端程式碼中插入指令碼標籤，以顯示搜尋結果，然後將資訊新增至結果清單中的每個文件連結。當使用者選擇要檢視文件的連結時，按一下資訊會傳送至 Amazon Kendra。

程式庫適用於支援 JavaScript ES6/ES2015 版本的瀏覽器。

步驟 1：將指令碼標籤插入您的 Amazon Kendra 搜尋應用程式

在轉譯 Amazon Kendra 搜尋結果的用戶端程式碼中，插入 <script> 標籤，並將參考新增至 JavaScript 程式庫：

<script>
 (function(w, d, s, c, g, n) {
   if(!w[n]) {
     w[n] = w[n] || function () {
           (w[n].q = w[n].q || []).push(arguments);
     }
     w[n].st = new Date().getTime();
     w[n].ep = g;
     var e = document.createElement(s),
         j = document.getElementsByTagName(s)[0];
     e.async = 1;
     e.src = c;
     e.type = 'module';
     j.parentNode.insertBefore(e, j);
   }
 })(window, document, 'script', 
 'library download URL', 
 'feedback endpoint',
 'kendraFeedback');
</script>

指令碼會從 Amazon Kendra 託管的 CDN 非同步下載 JavaScript 程式庫，並初始化名為 的全域變數kendraFeedback，可讓您設定選用參數。

Replace (取代) library download URL 以及 feedback endpoint 根據託管 Amazon Kendra 索引的區域，使用下表中的識別符。

區域	下載 URL	意見回饋端點
us-east-1	https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js	單https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/提交
us-east-2	https://d2crv7fufeg244.cloudfront.net/ksf-v1.js	單https://i6h76zwzf3.execute-api.us-east-2.amazonaws.com/prod/提交
us-west-2	https://d2iezfpnpcoujy.cloudfront.net/ksf-v1.js	單https://wg6nim909c.execute-api.us-west-2.amazonaws.com/prod/提交
ca-central-1	https://d1zbkfomowykaq.cloudfront.net/ksf-v1.js	單https://budi8txevj.execute-api.ca-central-1.amazonaws.com/prod/提交
eu-west-1	https://d3gptlxtulu4us.cloudfront.net/ksf-v1.js	單https://po2b11740b.execute-api.eu-west-1.amazonaws.com/prod/提交
ap-southeast-1	https://d1vvuam7g4taoe.cloudfront.net/ksf-v1	單https://9je5uw7t5l.execute-api.ap-southeast-1.amazonaws.com/prod/提交
ap-southeast-2	https://dopqntoe6z0ce.cloudfront.net/ksf-v1.js	單https://oovf4nvjj7.execute-api.ap-southeast-2.amazonaws.com/prod/提交
ap-south-1	https://d1ts9ouelsmk3g.cloudfront.net/ksf-v1.js	單https://k1abnmd43b.execute-api.ap-south-1.amazonaws.com/prod/提交
ap-northeast-1	https://d3w0ybsa293kb4.cloudfront.net/ksf-v1.js	https://wg7rz0uzjh.execute-api.ap-northeast-1.amazonaws.com/prod/提交
eu-west-2	https://d1tsrujswld1d1.cloudfront.net/ksf-v1.js	https://qi7mct3x7f.execute-api.eu-west-2.amazonaws.com/prod/提交

例如，如果您的索引位於美國東部 （維吉尼亞北部），library download URL 是 https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js和 feedback endpoint 是 https://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit。

您可以為 Amazon Kendra JavaScript 程式庫進行兩種選用設定：

• disableCookies – 預設會 Amazon Kendra 設定唯一識別使用者的 Cookie。將此設定為 true 以停用 Cookie。

  kendraFeedback('disableCookie', 'true | false');

  searchDivClassName - 預設情況下， Amazon Kendra 會監控搜尋結果頁面上的所有連結是否有點擊。將此設定為<div>類別名稱，以僅監控指定類別中的連結。

  kendraFeedback('searchDivClassName', 'class name');

步驟 2：將意見回饋字符新增至搜尋結果

在結果頁面上，將名為 的 HTML 屬性data-kendra-token新增至錨點標籤或直接父系 div 標籤，其中包含查詢回應中文件的連結。例如：

<a href="document location" data-kendra-token="feedback token value"></a>
OR
<div data-url="document location" data-kendra-token="feedback token value"></div>

查詢回應包含 feedbackToken 欄位中的字符。如果使用者選擇回應，字符會唯一識別回應。將權杖的值指派給 data-kendra-token 屬性。當 Amazon Kendra 使用者選擇結果並將其提交至 Amazon Kendra 端點做為意見回饋時， JavaScript 程式庫會尋找此字符。

Amazon Kendra JavaScript 程式庫只會提交意見回饋字符和其他中繼資料，例如選擇結果的時間和唯一的訪客 ID。

步驟 3：測試意見回饋指令碼

若要確保 JavaScript 程式庫設定正確，並將意見回饋傳送到正確的端點，請執行下列動作。此範例使用 Chrome 瀏覽器。

1. 在瀏覽器中開啟 Web 開發人員工具。在 Chrome 上，開啟瀏覽器右上角的 Chrome 選單，選擇更多工具，然後選擇開發人員工具。

2. 請確定主控台索引標籤中沒有與 Amazon Kendra JavaScript 程式庫相關的錯誤。

3. 進行搜尋並選擇任何結果。在開發人員工具的網路索引標籤中。您應該會看到傳送至意見回饋端點的請求、結果的字符，以及 200 OK 狀態。