Snippet de Comportamento para o próximo Prompt

As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.

O snippet de Comportamento para o próximo prompt permite que você personalize os comportamentos de um turno específico da conversa. Se você quiser definir comportamentos padrão para todas as rodadas na conversa, use um Default Next Prompt Behaviors snippet. Os comportamentos que você pode definir são ruído de conforto, detecção de DTMFClosed Tons de sinalização gerados quando um contato pressiona uma tecla do teclado do telefone., atrasos e tempos limite, e interrupção. Você pode saber mais sobre esses comportamentos na página de ajuda Prompt Behaviors.

Use este snippet com ações que têm a propriedade nextPromptBehavior, como a Cloud Transcribe ação, ou a Voicebot Exchange ação. Você deve criar este snippet em seu script.

Tempo necessário para cada turno de conversa

Lembre-se de calcular a quantidade de tempo necessária para cada turno na conversa. Por exemplo, enunciar um número com 14 dígitos pode levar de oito a quinze segundos se não houver pausa, mas responder Sim ou Não leva apenas um segundo ou dois. Para capturar todo o número, o turno da conversa onde o número é enunciado deve ser mais longo que o turno da resposta Sim/Não.

No turno onde o número é falado, você deve aumentar maxUtteranceMilliseconds para uma quantidade maior que a configuração padrão. Além disso, você também pode querer tornar maxPostEnergySilenceMS mais longo para esse turno.Isso ajudará a garantir que o contato tenha tempo suficiente para enunciar o número.

Para alterar esses valores durante um turno, coloque uma ação SNIPPET antes e depois da ação Voicebot Exchange referente a esse turno. No SNIPPET antes de Voicebot Exchange, altere as configurações necessárias. No SNIPPET depois de Voicebot Exchange, restaure as configurações ao estado anterior.

Adicionar um snippet de Comportamento para o próximo prompt

  1. Abra seu script no Studio.
  2. Add a Snippet action to your script. The location depends on your use case: 
    • Agente virtual sem Voicebot Gateway: coloque o Snippet antes da Voicebot Exchange ação na qual você deseja realizar os comportamentos especificados.
    • Agente virtual com Voicebot Gateway: Coloque o Snippet antes da ação Continuous Transcription.
    • Casos de uso de agente não virtual: Coloque o Snippet antes da ação Transcrição na Nuvem.
  3. Conecte as ações no script.
  4. Adicione a seguinte declaração de objeto ao snippet:

    DYNAMIC nextPromptBehaviors
    <add behaviors as needed>
    ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"
  5. Adicione os comportamentos que quer que a ação execute usando esta sintaxe:

    ASSIGN nextPromptBehaviors.[behavior] = [value]

    Nesta sintaxe,[behavior] inclui o nome da propriedade e todos os nomes de membros e submembros associados. Consulte o exemplo de código do Snippet na seção a seguir para mais informações.

  6. Configure a propriedade nextPromptBehavior da ação Voicebot Exchange ou Cloud Transcribe com a variável usada para armazenar o conteúdo JSON do objeto nextPromptBehaviors. No código do exemplo, isso é nextPromptBehaviorsJson.

    Se você estiver trabalhando com um agente virtual que usa o Voicebot Gateway, configure a propriedade nextPromptBehavior da ação Voicebot Exchange em seu script.

Propriedades de Comportamento do Prompt

A tabela a seguir descreve as propriedades disponíveis para os snippets Comportamento do Próximo Prompt . As propriedades permitem configurar os comportamentos do próximo prompt. Os comportamentos estão totalmente descritos na página de ajuda Comportamentos de Prompt do Agente virtual. Os comportamentos funcionam conforme descrito quando usados com aplicativos que não são do agente virtual de Turn-by-Turn Transcription.

O exemplo a seguir de um Snippet de Comportamento do Próximo Prompt mostra os nomes completos de membro e submembro do objeto a serem usados para cada propriedade.

Propriedade Comportamento Detalhes
audioFilePath Conforto acústico durante atrasos do Agente virtual

Insira a localização do arquivo de áudio de ruído de conforto. O arquivo deve estar localizado na estrutura de arquivos do seu sistema. Inclua o caminho completo se o arquivo estiver em uma pasta. A estrutura do arquivo é aplicada como seria para outro comportamento de prompt.

Use com:

  • botResponseDelayTolerance
  • engageComfortSequence
bargeOnUtteranceBeginRatherThanEnd Barge

Controla se o barge pode ser acionado na primeira palavra ou palavras detectadas, ou se não pode ser acionado até que um enunciado completo seja detectado.

Defina esse parâmetro como 1 para habilitar a interrupção (barge) em qualquer momento durante a expressão, ou como 0 se desejar que o serviço espere até o final de uma expressão.

Se o seu agente virtual usar Voicebot Gateway, defina esse parâmetro como 1.

botResponseDelayTolerance Conforto acústico durante atrasos do Agente virtual

Insira a quantidade de tempo em milissegundos que aciona o arquivo de áudio de ruído de conforto.

Use com:

  • audioFilePath
  • engageComfortSequence

Esta propriedade é para uso somente com o comportamento conforto acústico. Ele não controla quando o script segue a ramificação userInputTimeout. millisecondsToWaitForUserResponse é a propriedade que controla quando este ramal é tomado.

clearDigits Coleta de DTMF

Defina essa propriedade como true se quiser limpar o buffer de tom DTMF quando a ação começar. O buffer armazena em cache os tons Dtmf quando o contato pressiona uma tecla no teclado do telefone.

Esta propriedade é semelhante à propriedade clearDigits na ação Menu.

Esta propriedade deve ser usada com detectDtmf. Há opções adicionais relacionadas a DTMF que você pode configurar com propriedades adicionais.

Observação: Seu agente virtual deve estar configurado para processar Entradas dtmf no console de gestão do provedor. Mesmo que você tenha clearDigits definido como true, seu agente virtual deve ser capaz de processar erros causados por dígitos DTMF extras ou atrasos entre entradas. A ação VOICEBOT EXCHANGE transmite a entrada coletada do contato para o agente virtual.

detectDtmf Coleta de DTMF

Configure esta propriedade como true se desejar que a ação capture entradas dtmf.

Esta propriedade ativa a coleta de tons DTMF. Para configurar outras opções relacionadas a DTMF, você deve incluir outras propriedades:

  • clearDigits
  • terminationCharacters
  • stripTerminator
  • interDigitTimeoutMilliseconds
  • maxDigits
enableSpeakerBarge Interromper

Defina esta propriedade como true para habilitar interromper. Esta propriedade deve ser habilitada (true) para a maioria das interações de bot, mas pode ser desabilitada false) quando o áudio contém informações que o chamador é obrigado a ouvir, tais como renúncias legais.

Esta propriedade pode ser usada sozinha.

engageComfortSequence Conforto acústico durante atrasos do Agente virtual

Defina a propriedade como true se desejar ativar o ruído de conforto para esta ação. Defina como false se não quiser que essa ação use ruído de conforto.

Use com:

  • botResponseDelayTolerance
  • audioFilePath
interDigitTimeoutMilliseconds

Coleta de DTMF

Tratamento de limite de tempo de contato

Insira a quantidade de tempo em milissegundos que o sistema aguarda após um contato inserir um dígito para determinar se o contato inserirá outro dígito.

Esta propriedade é semelhante à propriedade InterDigitTimeout na Menu ação.

Esta propriedade deve ser usada com detectDtmf. Há opções adicionais relacionadas a DTMF que você pode configurar com propriedades adicionais.

maxDigits Coleta de DTMF

Insira o número máximo de dígitos que o contato pode inserir para o prompt desta ação. Por exemplo, se o prompt instruir o contato a inserir os quatro últimos dígitos de seu número de ID, defina essa propriedade como 4. Quando o valor maxDigits é atingido, o script continua a ser executado.

Esta propriedade é semelhante à propriedade MaxDigits na ação Menu.

Esta propriedade deve ser usada com detectDtmf. Há opções adicionais relacionadas a DTMF que você pode configurar com propriedades adicionais.

maxPostSilenceMS Espaçamento entre turnos

Configure por quanto tempo, em milissegundos, o agente virtual espera após o contato terminar de falar antes de responder. Isso permite evitar que o agente virtual fale ao mesmo tempo que o contato.

O valor mínimo é 100 milissegundos (1/10 segundo) e o valor máximo é 1000 milissegundos (um segundo). O padrão é 100.

Escolha a configuração que confere ao seu agente virtual a duração de pausa que pareça mais natural para a persona do agente virtual. Uma pausa mais longa pode ser educada, mas uma pausa que se prolonga por muito tempo pode começar a parecer lenta ou fazer com que os contatos se preocupem que a interação tenha sido desconectada.

Nota: Esta propriedade só pode ser definida no Snippet Comportamentos padrão do próximo prompt. Isso ocorre porque os parâmetros de script que afetam a transcrição não podem ser modificados após o início de Continuous Stream Transcription.

maxPostEnergySilenceMS Tratamento de limite de tempo de contato

Configure a quantidade de tempo em milissegundos que o bot espera após as pausas de contato enquanto fala. O valor padrão é 500 milissegundos.

Você pode aumentar a duração da pausa para reduzir as chances de interrupção dos contatos do bot. Quanto mais longa for a pausa, mais latência as trocas da interação terão. A melhor prática é aumentar este valor somente quando se espera que a resposta do contato seja digitada.

Esta propriedade pode ser usada sozinha. Não use essa propriedade se seu agente virtual usar Voicebot Gateway.

maxUtteranceMilliseconds (utteranceConfig)

Tratamento de ruído de plano de fundo

Tratamento de limite de tempo de contato

Somente para utteranceConfig.maxUtteranceMilliseconds.

Configure a quantidade de tempo, em milissegundos, que o agente virtual espera após detectar o primeiro áudio do contato. Esta configuração define o quão longa uma resposta pode ser.

Quando o maxUtteranceMilliseconds limite é atingido, o agente virtual tenta determinar uma intenção a partir do áudio capturado. Isto é útil quando há muitos ruídos de fundo na linha. Para mais detalhes sobre como essa propriedade funciona, consulte a página Virtual Agent Prompt Behaviors.

Esta propriedade usa como padrão as mesmas configurações de millisecondsToWaitForUserResponse, mesmo que você tenha personalizado millisecondsToWaitForUserResponse. Talvez você precise alterar maxUtteranceMilliseconds, dependendo de quão longa é a resposta esperada do contato. Por exemplo, 10 segundos (10.000 milissegundos) é razoável para uma resposta curta de uma palavra, como sim, não, ou suporte técnico. respostas esperadas mais longas exigiriam mais tempo. O valor máximo é de cinco minutos (300.000 milésimos de segundo).

Esta propriedade deve ser usada com millisecondsToWaitForUserResponse. Não use essa propriedade se o seu agente virtual usar Voicebot Gateway.

maxUtteranceMilliseconds (continuousTranscriptionUtteranceConfig) Rambler Interrupção

Somente para continuousTranscriptionUtteranceConfig. maxUtteranceMilliseconds.

Configure a quantidade de tempo, em milissegundos, que o agente virtual espera enquanto o contato fala. Quando esse limite é atingido, o bot interromperá o contato. Isso permite evitar que o contato fale por muito tempo. Por exemplo, se você definir essa propriedade como 120000, o contato poderá falar por dois minutos antes que o agente virtual aja.

O alcance para esta propriedade é de 1000milissegundos (um segundo) a 180000 milissegundos (três minutos). O padrão é 6000.

Nota: Esta propriedade só pode ser definida no Snippet Comportamentos padrão do próximo prompt. Isso ocorre porque os parâmetros de script que afetam a transcrição não podem ser modificados após o início de Continuous Stream Transcription.

millisecondsToWait
ForUserResponse

Tratamento de limite de tempo de contato

Tratamento de ruído de plano de fundo

Enter a quantidade de tempo em milissegundos que a ação espera por uma resposta do contato antes de atingir o limite de tempo. Quando esse limite de tempo é atingido, o script segue a ramificação userInputTimeout.

Esta propriedade pode ser usada sozinha.

Ao configurar seu agente virtual para lidar com ambientes ruidosos, essa propriedade deve ser usada com maxUtteranceMilliseconds.

Se o seu agente virtual usar Voicebot Gateway, quando o contato não disser nada durante o período de tempo configurado nessa propriedade, isso aciona o envio da solicitação SILENCE ao agente virtual. O script deve seguir a ramificação userInputTimeout.

numberOfWordsTo
TriggerUtteranceBegin
Intervir

Configure o número de palavras que o contato deve falar antes que o agente virtual permita ser interrompido. Por exemplo, se essa propriedade estiver definida como 3 e o contato disser "Espere, estou confuso", o agente virtual vai parar de falar. Mas se o contato disser "Espere", o agente virtual vai continuar a falar.

O alcance para esta propriedade é de 1 a 10 palavras. O padrão é 1.

Este parâmetro é ignorado se bargeOnUtteranceBeginRatherThanEnd estiver definido como 0.

Nota: Esta propriedade só pode ser definida no Snippet Comportamentos padrão do próximo prompt. Isso ocorre porque os parâmetros de script que afetam a transcrição não podem ser modificados após o início de Continuous Stream Transcription.

stripTerminator Coleta de DTMF

Configure esta propriedade como true se desejar remover o valor do caractere de terminação dos tons DTMF capturados.

Esta propriedade deve ser usada com detectDtmf. Há opções adicionais relacionadas a DTMF que você pode configurar com propriedades adicionais.

terminationCharacters Coleta de DTMF

Insira o caractere que você deseja que os contatos insiram para indicar que terminaram de inserir os dígitos. Por exemplo, você pode querer que os contatos pressionem a tecla sustenido (#) quando terminarem de inserir um número de conta.

Esta propriedade é semelhante à propriedade Termination na ação Menu.

Esta propriedade deve ser usada com detectDtmf. Há opções adicionais relacionadas a DTMF que você pode configurar com propriedades adicionais.

trimSilence Tratamento de limite de tempo de contato

true se você deseja que o silêncio do início da fala seja removido do áudio enviado ao agente virtual. Isto é útil para reduzir a quantidade de tempo necessário para processar cada enunciado. Isto pode ajudar a reduzir a latência.

O valor padrão para trimSilence é false.

Esta propriedade pode ser usada sozinha.

useContinuousTranscription Interromper Defina esta propriedade como 1 (true) ao habilitar o barge in quando seu agente virtual estiver configurado com Voicebot Gateway. Continuous Stream Transcription é uma parte obrigatória do Voicebot Gateway.