Configurando tempos limite para capturar a entrada do usuário com um bot Lex V2 - Guia do desenvolvedor

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

Configurando tempos limite para capturar a entrada do usuário com um bot Lex V2

O streaming do Amazon Lex V2 API permite que um bot detecte automaticamente declarações na entrada do usuário. Ao criar uma intenção ou um espaço, você pode configurar aspectos de um enunciado, como a duração máxima de um enunciado, o tempo limite durante a espera pela entrada do usuário ou o caractere final da entrada. DTMF Você pode personalizar o comportamento de um bot para seu caso de uso. Por exemplo, você pode limitar o número de dígitos de um número de cartão de crédito a 16.

Você também pode configurar tempos limite por meio de atributos de sessão ao iniciar uma conversa com um bot e sobrescrevê-los em sua função do Lambda, se necessário.

As chaves de configuração de um atributo usam a sintaxe a seguir:

x-amz-lex:<InputType>:<BehaviorName>:<IntentName>:<SlotName>

InputType pode ser audio, dtmf ou text.

Você pode definir as configurações padrão para todas as intenções ou slots em um bot especificando * como a intenção ou o nome do slot. Qualquer configuração específica de intenção ou slot tem precedência sobre as configurações padrão.

O Amazon Lex V2 fornece atributos de sessão predefinidos para gerenciar a forma como as StartConversationoperações funcionam com texto, voz ou DTMF entrada para seu bot. Todos os atributos predefinidos estão no namespace x-amz-lex.

Você pode definir as configurações padrão para todas as intenções, slots ou subslots em um bot especificando * como a intenção ou o nome do slot. Qualquer configuração específica de intenção ou slot tem precedência sobre as configurações padrão. Use esses padrões para todos os tempos limite abaixo.

Para um subslot de um slot composto, você pode separar por .. Por exemplo:

<slotName>.<subSlotName>
x-amz-lex:allow-interrupt:<intentName>:<slotName>.<subSlotName>
Expressão Cenário
Intenção: Slot. SubSlot Aplicável somente ao subslot chamado 'SubSlot' dentro do slot composto chamado 'Slot'
Intent:Slot.* Aplicável a qualquer subslot dentro do slot composto chamado 'Slot'
Intenção: *. SubSlot Aplicável somente ao subslot chamado 'SubSlot' dentro de qualquer slot composto
Intent:*.* Aplicável a qualquer subslot dentro de qualquer slot composto

Como o comportamento de interrupção funciona em um bot Lex V2

Você pode configurar o comportamento de interrupção do bot. O atributo é definido pelo Amazon Lex V2.

Permitir interrupção

x-amz-lex:allow-interrupt:<intentName>:<slotName>

Define se o usuário pode interromper o prompt reproduzido pelo bot do Amazon Lex V2. Você pode desativá-lo seletivamente.

Padrão: Verdadeiro

Defina os tempos limite para entrada de voz

Você pode definir valores de tempo limite para interação de voz com seu bot usando atributos de sessão. Os atributos são definidos pelo Amazon Lex V2. Esses atributos permitem que você especifique quanto tempo o Amazon Lex V2 espera até que um cliente termine de falar antes de coletar a fala de entrada.

Todos esses atributos estão no namespace x-amz-lex:audio.

Comprimento máximo do enunciado

x-amz-lex:audio:max-length-ms:<intentName>:<slotName>

Define quanto tempo o Amazon Lex V2 espera antes que a entrada de fala seja truncada e a fala retorne à sua aplicação. Você pode aumentar o tamanho da entrada quando houver expectativa de respostas longas, ou se quiser dar mais tempo para os clientes fornecerem informações.

Padrão: 13 mil milissegundos (13 segundos). O valor máximo é 15 mil milissegundos (15 segundos)

Se você definir o atributo max-length-ms para mais de 15 mil milissegundos, o valor padrão será 15 mil milissegundos.

Tempo limite de voz

x-amz-lex:audio:start-timeout-ms:<intentName>:<slotName>

Quanto tempo o bot espera antes de presumir que o cliente não vai falar. Você pode aumentar o tempo em situações nas quais o cliente precise de mais tempo para localizar ou recuperar informações antes de falar. Por exemplo, talvez queira dar mais tempo para os clientes encontrarem o cartão de crédito para inserir o número.

Padrão: 4 mil milissegundos (4 segundos)

Tempo limite do silêncio

x-amz-lex:audio:end-timeout-ms:<intentName>:<slotName>

Quanto tempo um bot espera após o cliente parar de falar para presumir que o enunciado foi concluído. Você pode aumentar o tempo em situações nas quais os períodos de silêncio são esperados ao fornecer entradas.

Padrão: 600 milissegundos (0,6 segundos)

Permitir entrada de áudio

x-amz-lex:allow-audio-input:<intentName>:<slotName>

Você pode habilitar esse atributo para que o bot aceite a entrada do usuário somente por meio da modalidade de áudio. O bot não aceitará entrada de áudio se esse sinalizador for definido como falso. Por padrão, o valor é definido como verdadeiro.

Padrão: Verdadeiro

Tempos limite para entrada de texto

Use o atributo de sessão a seguir para especificar como seu bot se comporta com o modo de conversação por texto.

Esse atributo está no namespace x-amz-lex:text.

Limite de tempo limite de início

x-amz-lex:text:start-timeout-ms:<intentName>:<slotName>

Quanto tempo o bot espera antes de solicitar novamente ao cliente a entrada de texto. É possível aumentar o tempo em situações nas quais você deseja que o cliente tenha mais tempo para localizar ou recuperar informações antes de fornecer a entrada de texto. Por exemplo, você pode desejar que os clientes tenham mais tempo para encontrar detalhes do pedido. Como alternativa, você pode reduzir o limite para avisar os clientes mais cedo.

Padrão: 30 mil milissegundos (30 segundos)

Definir configuração para DTMF entrada

Use os seguintes atributos de sessão para especificar como seu bot Amazon Lex V2 responde à DTMF entrada ao usar uma conversa de áudio.

Todos esses atributos estão no namespace x-amz-lex:dtmf.

Caractere de exclusão

x-amz-lex:dtmf:deletion-character:<intentName>:<slotName>

O DTMF caractere que limpa os DTMF dígitos acumulados e finaliza imediatamente a entrada.

Padrão: *

Caractere final

x-amz-lex:dtmf:end-character:<intentName>:<slotName>

O DTMF caractere que encerra imediatamente a entrada. Se o usuário não pressionar esse caractere, a entrada terminará após o tempo limite de término.

Padrão: #

Tempo limite do fim

x-amz-lex:dtmf:end-timeout-ms:<intentName>:<slotName>

Quanto tempo o bot deve esperar desde a entrada do último DTMF caractere antes de assumir que a entrada foi concluída.

Padrão: 5 mil milissegundos (5 segundos)

Número máximo de DTMF dígitos por enunciado

x-amz-lex:dtmf:max-length:<intentName>:<slotName>

O número máximo de DTMF dígitos permitido em um enunciado. Por exemplo, você pode definir esse valor como 16 para limitar o número de caracteres que podem ser inseridos para um número de cartão de crédito. Este valor não pode ser aumentado.

Padrão: 1024 caracteres

Permitir DTMF entrada

Você pode definir o tipo de entrada que o bot pode aceitar usando os atributos da sessão. Os atributos são definidos pelo Amazon Lex V2.

x-amz-lex:allow-dtmf-input:<intentName>:<slotName>

Você pode ativar esse atributo para que o bot aceite a entrada do usuário por meio da DTMF modalidade. O bot não aceitará DTMF entradas se esse sinalizador for definido como falso. Por padrão, o valor é definido como verdadeiro.

Padrão: Verdadeiro