

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

# Exemplo: criar um bot de perguntas frequentes para um índice do Amazon Kendra.
<a name="faq-bot-kendra-search"></a>

Este exemplo cria um bot do Amazon Lex V2 que usa um índice do Amazon Kendra para fornecer respostas às perguntas dos usuários. O bot de perguntas frequentes gerencia a caixa de diálogo para o usuário. Ele usa a intenção `AMAZON.KendraSearchIntent` para consultar o índice e apresentar a resposta ao usuário. Aqui está um resumo de como você criará seu bot de perguntas frequentes usando um índice da Amazon Kendra:

1. Criar um bot com o qual seus clientes vão interagir para obter respostas do bot.

1. Criar uma intenção personalizada. Como `AMAZON.KendraSearchIntent` e `AMAZON.FallbackIntent` são intenções secundárias, seu bot exige pelo menos uma outra intenção que contenha pelo menos um enunciado. Essa intenção permite que o bot crie, mas não seja usado de outra forma. Portanto, seu bot de perguntas frequentes conterá pelo menos três intenções, como na imagem abaixo:   
![Um bot de perguntas frequentes da Kendra com três intenções](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/kendra-faqbot/kendra-intents.png)

1. Adicionar a intenção `AMAZON.KendraSearchIntent` ao bot e configurá-lo para trabalhar com o [índice do Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html). 

1. Teste o bot fazendo uma consulta e verificando se os resultados do seu índice Amazon Kendra são documentos que respondem à consulta.

**Pré-requisitos**

Antes de usar este exemplo, é necessário criar um índice do Amazon Kendra. Para mais informações, consulte [Começar a usar um console do Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/gs-console.html) no *Guia do desenvolvedor do Amazon Kendra*. Para este exemplo, escolha o conjunto de dados de amostra (**Documentação da AWS de amostra**) como sua fonte de dados.

**Como criar um bot de perguntas frequentes:**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. No painel de navegação, escolha **Bots**. 

1. Escolha **Criar bot**.

   1.  Para **Método de criação**, escolha **Criar um bot em branco**. 

   1.  Na seção **Configuração do bot**, dê ao bot um nome que indique sua função, como **KendraTestBot**, e uma descrição opcional. O nome deve ser exclusivo em sua conta. 

   1.  A seção **Permissões do IAM**, a opção **Criar um perfil com permissões básicas do Amazon Lex**. Isso criará uma função do [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) com as permissões que o Amazon Lex V2 precisa para executar seu bot. 

   1.  Na seção **Lei de Proteção à Privacidade Online para Crianças (COPPA)**, escolha **Não**. 

   1.  Nas seções **Tempo limite da sessão ociosa** e **Configurações avançadas**, deixe as configurações padrão e escolha **Avançar**. 

   1.  Agora você está na seção **Adicionar idioma ao bot**. No menu, em **Interação por voz**, selecione **Nenhuma. Este é apenas um aplicativo baseado em texto**. Mantenha as configurações padrão para os campos restantes. 

   1.  Selecione **Concluído**. O Amazon Lex V2 cria seu bot e uma intenção padrão chamada **NewIntent**, e leva você à página para configurar essa intenção. 

Para criar um bot com sucesso, você deve criar pelo menos uma intenção separada de `AMAZON.FallbackIntent` e de `AMAZON.KendraSearchIntent`. Essa intenção é necessária para criar o bot do Amazon Lex V2, mas não é usada para a resposta de perguntas frequentes. Essa intenção deve conter pelo menos um exemplo de enunciado e ele não deve se aplicar a nenhuma das perguntas feitas pelo cliente.

**Como criar a intenção necessária:**

1.  Na seção **Detalhes da intenção**, dê um nome à intenção, como **RequiredIntent**. 

1.  Na seção **Exemplos de enunciados**, digite um enunciado na caixa ao lado de **Adicionar enunciado**, como **Required utterance**. Em seguida, escolha **Adicionar enunciado**. 

1. Selecione **Salvar intenção**.

Crie a intenção de pesquisar um índice do Amazon Kendra e a mensagem de resposta que deve ser retornada.

**Para criar uma AMAZON. KendraSearchIntent mensagem de intenção e resposta:**

1.  Selecione **Voltar à lista de intenções** no painel de navegação para retornar à página **Intenções** do seu bot. Escolha **Adicionar intenção** e selecione **Usar intenção incorporada** no menu suspenso. 

1.  Na caixa que aparece, selecione o menu em **Intenção incorporada**. Insira **AMAZON.KendraSearchIntent** na barra de busca e então escolha-a na lista. 

1.  Dê à entrada um nome, como **KendraSearchIntent**. 

1.  No menu suspenso **Índice do Amazon Kendra**, escolha o índice que a intenção deve pesquisar. O índice que você criou na seção **Pré-requisitos** deve estar disponível. 

1.  Selecione **Adicionar**. 

1. No editor de intenções, role para baixo até a seção **Processamento**, selecione a seta para a direita para expandir a seção e adicione a seguinte mensagem na caixa em **Em processamento bem-sucedido**: 

   ```
   I found a link to a document that could help you: ((x-amz-lex:kendra-search-response-document-link-1)).
   ```  
![Adicione a resposta de processamento](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/kendra-faqbot/kendra-fulfillment-response.gif)

    Para mais informações sobre a resposta de pesquisa do Amazon Kendra, consulte [Usando a resposta de pesquisa](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html#kendra-search-response). 

1. Escolha **Salvar intenção** e selecione **Criar** para criar o bot. Quando o bot estiver pronto, o banner na parte superior da tela ficará verde e exibirá uma mensagem de sucesso. 

Por fim, use a janela de teste do console para testar as respostas do bot.

**Para testar o bot de perguntas frequentes:**

1.  Depois que o bot for construído com sucesso, selecione **Testar**. 

1.  Insira **What is Amazon Kendra?** na janela de teste do console. Verifique se o bot responde com um link. 

1.  Para obter mais informações sobre configuração`AMAZON.KendraSearchIntent`, consulte [https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-kendra-search.html)e. [KendraConfiguration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_KendraConfiguration.html) 