Controle de entrada do usuário do carrossel

Dica:

Se você quiser mudar o número padrão de itens listados por página, você pode modificar o. com.glide.cs.picker_page_limitpropriedade do sistema. O valor padrão é 10.

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

Nota:

O controle de entrada do usuário do carrossel não é compatível com Now Assist em Virtual Agent.


Propriedade	Descrição
Nome do nó	Nome que identifica esse nó no fluxo do tópico.
Nome da variável	Nome da variável que armazena a resposta do usuário a este aviso. O nome da variável é automaticamente criado a partir da propriedade Nome do nó.
Permitir preenchimento automático de slot	Alterne para permitir que o valor deste nó seja definido automaticamente por outros nós, bem como durante a descoberta de tópicos. Quando a alternância é ativada, o campo "Descrição detalhada" muda das opções dinâmicas de script e "Selecionador de cápsula de dados" para um campo de texto estático.
Descrição detalhada	Descrição das informações necessárias dos usuários. . Permitir preenchimento automático de slot A alternância está desativada, você pode criar uma descrição detalhada dinâmica selecionando o ícone Seletor de cápsulas de dados Para definir condições ou selecione o ícone Abrir editor para inserir um script. Se a alternância Permitir preenchimento automático de slot estiver ativada, você poderá inserir apenas uma descrição estática.
Defina 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 da seção de expressão do item de carrossel neste tópico.
Avançado (opcional)
Impor prompt do usuário
Impor prompt do usuário	Ative para abrir um campo para exibir uma mensagem personalizada ao usuário em vez da mensagem gerada pelo LLM (Large language model, grande modelo de linguagem). Você pode criar mensagens personalizadas usando linguagem simples, inserir scripts ou definir condições com o seletor de cápsula de dados.
Validação	Adicione um script para validar a entrada do usuário. Por exemplo, verifique se o usuário inseriu um endereço de e-mail válido.
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 selecionador de cápsula de dados.
Oculte ou ignore 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. Este campo não é aplicável quando o nó Carrossel é usado no nó Coletor de entrada.
Permita 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. A condição deve ser avaliada como verdadeira. Você pode definir este campo usando o construtor de condição ou um script. Se os usuários inserirem um valor como `ignorar esta etapa` quando as condições não permitem a opção de ignorar, eles receberão uma mensagem informando que o nó não pode ser ignorado e serão solicitados a fornecer uma resposta novamente.

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


Propriedades do carrossel	Prompt do carrossel
	Figura 1. Prompt do carrossel de IU da web

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


Propriedade	Descrição
Nome do nó	Nome que identifica esse nó no fluxo do tópico.
Nome da variável	Nome da variável que armazena a resposta do usuário a este aviso. 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 de NLU	Opção para associar uma entidade de NLU ao nó. Se uma entidade de NLU estiver associada à variável de entrada para esse 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 botão de opção "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.
Defina 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 da seção de expressão do item de carrossel neste tópico.
Nenhuma mensagem de resposta de registros	Mensagem exibida ao usuário quando a pesquisa da tabela não retorna nenhum registro. A mensagem pode ser uma cadeia de caracteres de texto ou um script que retorna texto.
Avançado
Valor padrão
Valor-padrão	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 do 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}}?`.
Troca de conversa
Esta seção estará disponível somente quando a descoberta de NLU for ativada na instância.
Ative para permitir que os usuários mudem o assunto	Opção para ativar a previsão de NLU para esse nó. Quando essa opção está ativada, os usuários podem inserir texto para responder a perguntas, independentemente do tipo de controle de entrada em uso. O Virtual Agent usa esse enunciado para corresponder a outra intenção existente, permitindo que o usuário alterne tópicos.
Oculte ou ignore 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.
Permita 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. A condição deve ser avaliada como verdadeira. Você pode definir este campo usando o construtor de condição ou um script.
Se	Uma declaração de condição sem código ou script de baixo código que permite que usuários finais pulem a criação de novos prompts na conversa. Quando um nó anterior for revisitado por meio de um loopback de tópico ou de um Ato de diálogo, o Virtual Agent ignorará esse nó e manterá seu valor original automaticamente.

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

Nota:

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


Propriedades do carrossel	Prompt do carrossel
	Figura 2. Prompt do carrossel de IU da web
	Figura 3. ServiceNow Mobile prompt do carrossel

Exemplo de expressão de 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'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 200","description":"The model 200 keyboard is a ten-key-less keyboard."}
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 300","description":"The model 300 keyboard is a full-size keyboard with a ten-key pad."}
            }
       );
       return options;

})()

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

Tabela 1. Chave de código de exemplo
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, esse valor é armazenado na variável nomeada em Nome da variável propriedade.
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 Selecione botão abaixo de 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.
Card_name	Cabeçalho da cadeia de caracteres de texto que identifica o cartão mostrado no carrossel.
Card_data	Matriz que contém cadeias de caracteres de texto a serem apresentadas no cartão. Os valores incluem identificador, cabeçalho e descrição.

Suporte de canal

Tabela 2. Suporte de canal para o controle de entrada do usuário do carrossel
Canal	Suporte a LLM	Suporte a NLU/palavra-chave	Restrições
IU da web	Sem Suporte	Compatível	Nenhum(a)
IU para celular	Sem Suporte	Compatível	Nenhum(a)
Painel do Now Assist	Sem Suporte	Compatível	Nenhum(a)
Microsoft Teams	Sem Suporte	Compatível	Nenhum. Se o carrossel contiver mais de 10 itens, os usuários deverão selecionar Próximo para revisar os itens restantes.
Slack	Sem Suporte	Compatível	Nenhum(a)
Workplace	Sem Suporte	Compatível	Nenhum(a)
Facebook Messenger	Sem Suporte	Compatível	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 no sn_va_fb_messenger.max_carousel_cardspropriedade do sistema. Esta propriedade é encontrada na tabela Propriedades do sistema [sys_properties].
SMS Twilio	Sem Suporte	Sem suporte	Não aplicável
LINE	Sem Suporte	Compatível	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 de uma página é definido no sn_va_line.max.carousel.cardspropriedade do sistema. A propriedade está localizada na tabela Propriedades do sistema [sys_properties].
WhatsApp	Sem Suporte	Compatível	Nenhum(a)
Apple Messages for Business	Sem Suporte	Compatível	Nenhum(a)
Alexa (Voz)	Sem Suporte	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.