Controle de entrada do usuário ao carrossel

Dica:

Se quiser mudar o número padrão de itens listados por página, modifique a propriedade do sistema com.glide.cs.picker_page_limit. O valor padrão é 10.

Propriedades de controle de entrada do carrossel para descoberta de tópico LLM


Propriedade	Descrição
Nome do nó	Nome que identifica este nó de controle de entrada do usuário ao carrossel no fluxo do tópico.
Descrição do detalhe	Nome da variável que armazena a seleção feita pelo usuário. O nome da variável é automaticamente criado a partir da propriedade Nome do nó.
Definir itens do carrossel	Use um script para criar itens para seleção no seu carrossel. O script deve retornar uma matriz contendo um ou mais itens. Veja o exemplo de expressão do item de carrossel abaixo.
Avançado
Impor aviso do usuário	Alterne para abrir um campo para uma mensagem personalizada mostrada ao usuário em vez da mensagem gerada pelo LLM.
Instruções adicionais para LLM	Mais instruções para o LLM, como adicionar formatos de dados, restrições ou valores padrão para respostas do usuário. Você pode criar instruções adicionais em linguagem simples, inserir um script ou definir condições com o seletor de cápsula de dados.
Ocultar este nó
Mostrar este nó condicionalmente se	Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira.

Exemplo de controle de entrada do carrossel para descoberta de tópico LLM


Propriedades do carrossel	Aviso do carrossel
Figura 1. Propriedades básicas do controle de entrada do usuário do carrossel Figura 2. Opções de entrada do usuário do Carrossel avançado para descoberta de tópico LLM	Figura 3. Aviso do carrossel na IU da Web

Propriedades de controle de entrada do carrossel para descoberta de tópico NLU


Propriedade	Descrição
Nome do nó	Nome que identifica este nó de controle de entrada do usuário ao carrossel no fluxo do tópico.
Nome da variável	Nome da variável que armazena a seleção feita pelo usuário. O nome da variável é automaticamente criado a partir da propriedade Nome do nó.
Aviso	Aviso ou pergunta para o usuário. O aviso pode ser uma cadeia de caracteres de texto ou um script que retorna texto. Este valor é usado somente quando o valor padrão não é especificado. Por exemplo: `Qual é o seu nome?`
Entidade NLU	Opção para associar uma entidade NLU associada ao nó. Se uma entidade NLU estiver associada à variável de entrada para este nó, o Virtual Agent poderá preencher o slot do valor especificado com base no enunciado do usuário. Selecione uma entidade na lista de entidades associadas à intenção do tópico. Quando você especifica uma entidade para o nó, o comutador Não solicitar que os usuários confirmem a entidade reconhecida é exibido. Quando habilitado, os usuários não são solicitados a confirmar a entidade extraída. Este campo estará disponível somente quando a descoberta do NLU for habilitada na instância.
Definir itens do carrossel	Use um script para criar itens para seleção no seu carrossel. O script deve retornar uma matriz contendo um ou mais itens. Veja o exemplo de expressão do item de carrossel abaixo.
Nenhuma mensagem de resposta de registros	Mensagem para o usuário indicando que nenhum registro foi encontrado. A mensagem pode ser uma cadeia de caracteres de texto ou um script que retorna texto.
Avançado
Valor padrão
Predefinir um valor para a entrada do usuário	Valor predefinido para a resposta do usuário à pergunta ou ao prompt. A resposta definida no campo Confirmação de valor padrão solicita que o usuário confirme o valor padrão. Se o usuário responder com `não`, o valor se tornará nulo. A valor padrão pode ser uma cadeia de caracteres de texto ou um script que retorna texto. Por exemplo, se você estiver usando a referência com pontos, o valor padrão poderá ser: `Variáveis de script> Último nome de usuário`. Ou, se você estiver usando um script, o valor padrão poderá ser: `{{vaScripts.lastUsername}}`.
Mensagens de confirmação
Confirmação de conclusão de entrada	Resposta do bot mostrada ao usuário quando a interação do nó é concluída. A mensagem pode ser uma cadeia de caracteres de texto ou um script que retorna texto. Por exemplo, se você estiver usando a referência com pontos: `Obrigado, (Variáveis de entrada> Nome de usuário)!` Ou, se você estiver usando um script, a confirmação poderá ser: `Agradecemos, {{vaInputs.username}}!`
Confirmação de valor padrão	Mensagem que solicita ao usuário que verifique se o valor no campo Valor padrão está correto. Esta mensagem é usada em vez de um valor no campo Aviso. Pode conter uma cadeia de caracteres de texto ou um script que retorna texto. Por exemplo, se você estiver usando a referência com pontos: `Você é, (Variáveis de entrada> Nome de usuário)?` Ou, se você estiver usando um script, o valor padrão poderá ser: `Você é{{vaScripts.lastUsername}}?`.
Alternância de tópicos
Esta seção estará disponível somente quando a descoberta de NLU for habilitada na instância.
Habilitar NLU para alternar tópicos	Opção para habilitar a previsão de NLU para este nó. Se habilitada, os usuários podem inserir texto para responder a perguntas, independentemente do tipo de controle de entrada que está sendo usado. O Virtual Agent usa esse enunciado para corresponder a outra intenção existente, permitindo que o usuário alterne os tópicos.
Ocultar ou ignorar este nó
Mostrar este nó condicionalmente se	Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira.
Permitir que o usuário ignore este nó se	Uma declaração de condição sem código ou script de baixo código que permite que usuários finais pulem este nó na conversa.

Exemplo de controle de entrada do carrossel para descoberta de tópico NLU

Nota:

Designer do Virtual Agent os controles podem ser exibidos e funcionar de forma diferente em outros canais.


Propriedades do carrossel	Aviso do carrossel
	Figura 4. Aviso do carrossel na IU da Web
	Figura 5. aviso do carrossel ServiceNow Mobile

Exemplos de expressão do item do carrossel

(function execute() {
    var options = [];
       options.push(
            {
                'Name': 'Item 1',
                'Value': 'item_1',
                'Description': 'Acme keyboard model 200',
                'Body': 'https://images.pexels.com/photos/688666/pexels-photo-688666.jpeg'
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
            }
       );
       return options;

})()

O script na propriedade Expressão do item do carrossel define e retorna uma matriz que contém os itens que aparecem no seu carrossel. Os elementos desta matriz devem conter chaves de Nome, Valore Corpo. No exemplo, o script cria uma matriz chamada opções e adiciona dois elementos, cada um com as chaves necessárias. As imagens aqui estão codificadas como exemplo.

Tabela 1. Exemplo de chave de código
Chave	Descrição
Nome	Nome do item do carrossel. Este nome é mostrado abaixo da imagem no carrossel.
Valor	Valor do item. Quando um usuário seleciona um item do carrossel, este valor é armazenado na variável nomeada na propriedade Nome da variável.
Descrição	Cadeia de caracteres de texto que descreve o item do carrossel. A descrição é mostrada abaixo do nome da imagem. Um carrossel com mais de três itens exibe setas para a esquerda e para a direita para rolar pelas imagens e um botão de Selecionar em cada item. Se uma descrição tiver mais de 140 caracteres, os usuários poderão expandir o conteúdo.
Corpo	Imagem usada no item do carrossel. O valor é um URL para um arquivo de imagem.

Suporte ao canal

Tabela 2. Suporte ao canal para o controle de entrada do usuário ao carrossel
Canal	Suporte	Restrições
IU da Web	Com suporte	Nenhum
IU para celular	Com suporte	Nenhum
Painel do Now Assist	Sem suporte Compatível	Nenhum
Microsoft Teams	Com suporte	Nenhum. Se o carrossel tiver mais de 10 itens, os usuários deverão selecionar Avançar para revisar os itens restantes.
Slack	Com suporte	Nenhum
Workplace	Com suporte	Nenhum
Facebook Messenger	Com suporte	O título de uma imagem tem um limite máximo de 40 caracteres. O texto da imagem tem um limite máximo de 60 caracteres. Um usuário pode exibir apenas 10 imagens por vez. Se houver mais de 10 imagens, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de imagens em um carrossel para uma página é definido na propriedade do sistema sn_va_fb_messenger.max_carousel_cards. Esta propriedade é encontrada na tabela Propriedade do sistema [sys_properties].
SMS Twilio	Sem suporte	Não aplicável
LINE	Com suporte	O título de uma imagem tem um limite máximo de 40 caracteres. O texto da imagem tem um limite máximo de 60 caracteres. Um usuário pode exibir apenas 10 imagens por vez. Se houver mais de 10 imagens, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de imagens no carrossel para uma página é definido na propriedade do sistema sn_va_line.max.carousel.cards. A propriedade está localizada na tabela Propriedade do sistema [sys_properties].
WhatsApp	Com suporte	Nenhum
Apple Messages for Business	Com suporte	Nenhum
Alexa (Voz)	Compatível	Para dispositivos de tela, use a rolagem de toque. Para dispositivos que não são de tela, use a paginação por voz.