Usar la Amazon Kendra JavaScript biblioteca para enviar comentarios

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Amazon Kendra proporciona una JavaScript biblioteca que puedes usar para añadir comentarios sobre los clics a tu página de resultados de búsqueda. Para utilizar la biblioteca debe insertar una etiqueta de cadena en su código cliente que muestre el resultado de búsqueda y, a continuación, añadir información a cada uno de los enlaces de los documentos de su lista de resultados. Cuando un usuario elige un enlace para ver un documento, se envía la información sobre los clics a Amazon Kendra.

La biblioteca funciona con navegadores compatibles con la JavaScript versión ES6/ES2015.

Paso 1: Inserta una etiqueta de script en tu aplicación Amazon Kendra de búsqueda

En el código de cliente que muestra los resultados de la Amazon Kendra búsqueda, inserta una <script>etiqueta y añade una referencia a la JavaScript biblioteca:

<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>

El script descarga la JavaScript biblioteca de forma asíncrona desde una CDN Amazon Kendra alojada e inicializa una variable global denominada así kendraFeedback que permite establecer parámetros opcionales.

Sustituya library download URL y feedback endpoint por un identificador de la siguiente tabla en función de la región que aloja el índice. Amazon Kendra

Por ejemplo, si su índice está en EE. UU. Este (Norte de Virginia), library download URL es https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js y feedback endpoint eshttps://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit.

Hay dos ajustes opcionales que puede realizar para la Amazon Kendra JavaScript biblioteca:

Paso 2: Añadir el token de valoración a los resultados de búsqueda

En su página de resultados, añada un atributo HTML llamado data-kendra-token a la etiqueta delimitadora o a la etiqueta div principal inmediata que contenga un enlace al documento desde la respuesta a la consulta. Por ejemplo:

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

La respuesta a una consulta contiene un token en el campo feedbackToken. El token identifica la respuesta de forma única si el usuario la elige. Asigne el valor del token al atributo data-kendra-token. La Amazon Kendra JavaScript biblioteca busca este token cuando el usuario elige el resultado y lo envía a un Amazon Kendra punto final como comentario.

La Amazon Kendra JavaScript biblioteca solo envía el token de comentarios y otros metadatos, como la hora en que se eligió el resultado y un identificador de visitante único.

Paso 3: Probar la cadena de valoración

Para asegurarte de que la JavaScript biblioteca está configurada correctamente y de que envía los comentarios al punto final correcto, haz lo siguiente. En este ejemplo, se utiliza el navegador Chrome.