As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando a Amazon Kendra JavaScript biblioteca para enviar feedback

Amazon Kendra fornece uma JavaScript biblioteca que você pode usar para adicionar feedback de cliques à sua página de resultados de pesquisa. Para usar a biblioteca, você insere uma tag de script no código do cliente que exibe o resultado da pesquisa e, em seguida, adiciona informações a cada um dos links do documento na sua lista de resultados. Quando um usuário escolhe um link para visualizar um documento, as informações de clique são enviadas para o Amazon Kendra.

A biblioteca funciona com navegadores compatíveis com a JavaScript versãoES6/ES2015.

Etapa 1: inserir uma tag de script em seu aplicativo Amazon Kendra de pesquisa

No código do cliente que renderiza os resultados da Amazon Kendra pesquisa, insira uma <script>tag e adicione uma referência à 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>

O script baixa de forma assíncrona a JavaScript biblioteca de um servidor Amazon Kendra hospedado CDN e inicializa uma variável global chamada kendraFeedback que permite definir parâmetros opcionais.

Substituir library download URL e feedback endpoint com um identificador da tabela a seguir com base na região que hospeda seu Amazon Kendra índice.

Por exemplo, se seu índice estiver no Leste dos EUA (Norte da Virgínia), library download URL é https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js e feedback endpoint éhttps://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit.

Há duas configurações opcionais que você pode fazer para a Amazon Kendra JavaScript biblioteca:

Etapa 2: adicionar o token de comentários aos resultados da pesquisa

Na sua página de resultados, adicione um HTML atributo chamado data-kendra-token à tag âncora ou tag div primária imediata que contém um link para o documento a partir da resposta da consulta. Por exemplo:

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

Uma resposta de consulta contém um token no campo de feedbackToken. O token identifica a resposta de forma exclusiva se o usuário a escolher. Atribua o valor do token ao atributo de data-kendra-token. A Amazon Kendra JavaScript biblioteca procura esse token quando o usuário escolhe o resultado e o envia para um Amazon Kendra endpoint como feedback.

A Amazon Kendra JavaScript biblioteca envia apenas o token de feedback e outros metadados, como a hora em que o resultado foi escolhido e um ID de visitante exclusivo.

Etapa 3: testar o script de comentários

Para garantir que a JavaScript biblioteca esteja configurada corretamente e enviando feedback para o endpoint correto, faça o seguinte. Este exemplo usa o navegador do Chrome.