Diretrizes e práticas recomendadas

Consulte as diretrizes e as práticas recomendadas a seguir para otimizar o comportamento e as interações do seu bot com os clientes.

Assinatura de solicitações

Todas as solicitações de runtime e construção de modelos do Amazon Lex V2 na Referência da API usam a assinatura V4 para autenticar as solicitações. Para mais informações sobre a autenticação de solicitações, consulte Processo de cadastramento do Signature versão 4 na Referência geral da AWS.

Proteção das informações confidenciais

As operações da API runtime RecognizeText e RecognizeUtterance usam uma ID de sessão como parâmetro obrigatório. Os desenvolvedores podem configurar isso para qualquer valor que atenda às restrições descritas na API. Recomendamos que você não use esse parâmetro para enviar informações confidenciais como logins de usuário, e-mails ou números de seguro social. Esse ID é usado principalmente para identificar de forma exclusiva uma conversa com um bot.

Como capturar valores de slots a partir de declarações dos usuários

O Amazon Lex V2 usa os valores de enumeração fornecidos em uma definição de tipo de slot para treinar seus modelos de machine learning. Suponha que você defina uma intenção chamada GetPredictionIntent com o seguinte utterance de amostra:

"Tell me the prediction for {sign}"

em que {sign} é um slot com o tipo personalizado de ZodiacSign que tem 12 valores de enumeração: Aries até Pisces. Agora, suponha que o usuário diga “Diga-me a previsão para terra”:

• O Amazon Lex V2 infere que “terra” é um valor de ZodiacSign se você realizar uma das ações a seguir:

  • Definir o campo valueSelectionStrategy comoORIGINAL_VALUE usando a operação CreateSlotType

  • Selecionar Expandir valores no console

• O Amazon Lex V2 não reconhece o valor “terra” se você limitar o reconhecimento aos valores definidos para o tipo de slot executando uma das seguintes ações:

  • Definir o campo valueSelectionStrategy comoTOP_RESOLUTION usando a operação CreateSlotType

  • Selecionar Restringir a valores de slot e sinônimos no console

Quando você define sinônimos para valores de slot, eles são reconhecidos como sendo iguais a um valor de slot. No entanto, o valor do slot é retornado em vez do sinônimo.

Como o Amazon Lex V2 passa esse valor para seu aplicativo cliente ou para a função do Lambda, você deve verificar se os valores dos slots são válidos antes de usá-los na atividade de atendimento.

Quando o Amazon Lex chama uma função do Lambda ou traz o resultado de uma interação de fala com o cliente, a capitalização dos valores do slot não é garantida. Em interações de texto, a capitalização dos valores de slot corresponde ao texto inserido ou ao valor de slot, dependendo do valor do campo valueResolutionStrategy.

Siglas nos valores dos slots

Quando for definir valores de slot que contêm siglas, use os seguintes padrões:

• Letras maiúsculas separadas por pontos (D.V.D.)

• Letras maiúsculas separadas por espaços (D V D)

Slots integrados para data e hora

Os tipos de slot integrado AMAZON.Data e AMAZON.Hora capturam as datas e horas absolutas e relativas. As datas e horários relativos são resolvidos na hora e na data em que o Amazon Lex V2 recebe a solicitação e na região em que processa a solicitação.

Para o tipo de slot integrado AMAZON.Time, se o usuário não especificar que um horário é antes ou depois do meio-dia, o horário será ambíguo. Nesse caso, o Amazon Lex V2 fará uma nova solicitação ao usuário. Recomendamos que um horário absoluto seja escolhido para as solicitações. Por exemplo, use uma solicitação como "Em qual horário você deseja que a pizza seja entregue? Você pode dizer 18h ou 6 da tarde".

Como evitar ambiguidades nos dados de treinamento do bot

Fornecer dados de treinamento confusos no bot reduz a capacidade de o Amazon Lex V2 compreender a entrada do usuário. Suponha que você tenha dois intents (OrderPizza e OrderDrink) no bot e inclua “Quero fazer o pedido” como exemplo de declaração. Quando você cria seu bot, o Amazon Lex V2 não consegue mapear essa expressão a um intent específico. Como resultado, quando um usuário insere esse enunciado em runtime, o Amazon Lex V2 não consegue escolher uma intenção com alto grau de confiança.

Se você tiver dois intents com o mesmo exemplo de declaração, use contextos de entrada para ajudar o Amazon Lex V2 a distinguir entre os dois intents no runtime. Para mais informações, consulte Configurar contexto de intenção.

Como usar o alias TSTALIASID

• O alias TSTALIASID do bot aponta para a versão de rascunho e deve ser usada somente para testes manuais. O Amazon Lex limita o número de solicitações de runtime que você pode fazer para o alias TSTALIASID do bot.

• Quando você atualiza a versão de rascunho do bot, o Amazon Lex encerra todas as conversas em andamento para qualquer aplicativo cliente usando o alias TSTALIASID do bot. Em geral, você não deve usar o alias TSTALIASID de um bot em produção, pois a versão de rascunho pode ser atualizada. Em vez disso, publique e use uma versão e um alias.

• Quando você atualiza um alias, o Amazon Lex leva alguns minutos para incorporar as alterações. Quando você modifica a versão de rascunho do bot, a alteração é capturada imediatamente pelo alias TSTALIASID.