Controle de entrada do usuário Seleção dinâmica

Exibição da lista de seleção

A lista de Seleção dinâmica contém até 10 itens por página. Quando há mais de 10 itens, os usuários têm a opção de exibir os itens adicionais e também filtrar os resultados da pesquisa.O aviso da lista de seleção contém um ícone de pesquisa que os usuários podem selecionar para filtrar os resultados.

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.

O controle Seleção dinâmica também dá a opção de adicionar um cartão de cabeçalho que é exibido acima da lista de seleção. Os cartões de cabeçalho são compatíveis com canais da Web e para celular.

O cartão de cabeçalho pode conter uma imagem grande ou pequena ou uma placa de vídeo do YouTube, junto com um texto descritivo. A lista de seleção contém até cinco itens por padrão, mas o recurso de pesquisa está suprimido. Se houver mais de cinco itens, os usuários poderão escolher mostrar os itens adicionais.
Para controlar o número de itens exibidos abaixo de um cartão de cabeçalho, adicione a propriedade do sistema com.glide.cs.web_header_picker_page_limit. Use o Valor para especificar o número de itens na lista de seleção. Para obter detalhes sobre como criar uma propriedade do sistema, consulte Adição de uma propriedade do sistema.

Propriedades de controle de entrada do usuário Seleção dinâmica para descoberta de tópico LLM


Propriedade	Descrição
Nome do nó	Nome que identifica este nó de controle do usuário Seleção dinâmica no fluxo do tópico.
Descrição do detalhe	A única informação necessária do usuário. Por exemplo, `peça ao usuário para selecionar um incidente.`
Opções
Preencher opções por	Tipo de variável dinâmica a ser usada. Selecione uma das seguintes opções. Registro: retorna registros da tabela selecionada. Os valores para estas opções são objetos GlideRecord. Script: expressão que retorna uma matriz de opções.
Tabela	Se você selecionou Registro como o método para preencher opções, selecione a tabela que será pesquisada. Este campo está disponível somente quando a opção Registro é selecionada.
Opções de filtro	Opção de usar o construtor de condição Designer do Virtual Agent ou fornecer um script. Selecione uma das seguintes propriedades: Construtor de condição: cria um filtro usado para selecionar um subconjunto de registros da tabela. Script: define a lista de enumeração para a opções (lista de seleção) a serem exibidas. O par nome-valor é armazenado como um objeto de cadeia de caracteres. Este campo está disponível somente quando a opção Registro é selecionada.
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 usuário Seleção dinâmica para descoberta de tópico LLM

Nota:

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


Propriedades de entrada	Aviso de lista
Figura 1. Propriedades básicas do controle de entrada do usuário Seleção dinâmica Figura 2. Opções de entrada do usuário Seleção dinâmica avançada para descoberta de tópico LLM	Figura 3. Aviso da lista de Seleção dinâmica na IU da Web A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados são retornados: A lista inclui um link no final para mostrar mais resultados. Um ícone de pesquisa () é exibido no aviso para filtrar os resultados da pesquisa. Os usuários selecionam o ícone para abrir uma caixa de pesquisa e inserir o filtro.

Propriedades de controle de entrada do usuário Seleção dinâmica para descoberta de tópico NLU


Propriedade	Descrição
Nome do nó	Nome que identifica este nó de controle do usuário Seleção dinâmica 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 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.
Opções
Preencher opções por	Tipo de variável dinâmica a ser usada. Selecione uma das seguintes opções. Registro: retorna registros da tabela selecionada. Os valores para estas opções são objetos GlideRecord. Script: expressão que retorna uma matriz de opções.
Tabela	Se você selecionou Registro como o método para preencher opções, selecione a tabela que será pesquisada. Este campo está disponível somente quando a opção Registro é selecionada.
Opções de filtro	Opção de usar o construtor de condição Designer do Virtual Agent ou fornecer um script. Selecione uma das seguintes propriedades: Construtor de condição: cria um filtro usado para selecionar um subconjunto de registros da tabela. Script: define a lista de enumeração para a opções (lista de seleção) a serem exibidas. O par nome-valor é armazenado como um objeto de cadeia de caracteres. Este campo está disponível somente quando a opção Registro é selecionada.
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
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.
Cabeçalho de cartão
Inserir	Comutador de alternância para inserir um cartão de cabeçalho acima da lista de seleção. Você pode usar a caixa de diálogo Adicionar cartão ou um script. Para informações detalhadas, consulte Inserir um cartão de cabeçalho em um controle de escolha estática ou escolha dinâmica.
Você gostaria de ajuda?	Opção de usar a interface Designer do Virtual Agent ou fornecer um script. Escolha uma das opções a seguir: Sim: para criar o cartão de cabeçalho sem script, selecione Adicionar cartão. Não, usarei script: para abrir a caixa de diálogo de script, clique em Adicionar script. Este campo está disponível somente quando a opção de cartão de cabeçalho está habilitada.
Adicionar caixa de diálogo de cartão
Esta seção estará disponível somente quando o Cartão de cabeçalho for habilitado.
Tipo de cartão	Tipo de cartão de cabeçalho. Escolha uma das opções a seguir: Imagem grande contendo texto Imagem pequena contendo texto Placa de vídeo do YouTube Os campos na caixa de diálogo mudam de acordo com sua escolha.
Título	Imagem ou título do vídeo. Insira o texto do link ou use uma cápsula de dados ou script para especificar o link.
Link do título	URL do hiperlink do título do vídeo. Insira o texto do link ou use uma cápsula de dados ou script para especificar o link. Se este campo estiver vazio, o título será exibido como texto simples. Este campo estará disponível somente quando a opção Placa de vídeo do YouTube for selecionada.
Descrição	Breve explicação da imagem ou do vídeo.
ID do vídeo do YouTube	Cadeia de caracteres alfanumérica no final da URL do YouTube. Po exemplo, na URL https://www.youtube.com/watch?v=AacDp2mUQ1I, o ID do vídeo do YouTube é AacDp2mUQ1I. Este campo estará disponível somente quando a opção Placa de vídeo do YouTube for selecionada.
Link e URL da Imagem	Link da URL para a imagem ou o arquivo de imagem. Para definir este campo, siga um dos processos a seguir: Especifique o link da URL inserindo o texto do link, usando uma cápsula de dados ou usando um script. Carregue um arquivo de imagem selecionando Carregar imagem. Este campo estará disponível somente quando a opção Imagem grande com texto ou Imagem pequena com texto for selecionada.
Texto alternativo da imagem	Texto alternativo legível na tela que descreve a imagem para programas de acessibilidade. Este texto é usado junto com a imagem. Insira o texto usando o campo de texto, a cápsula de dados ou o script. Este campo estará disponível somente quando a opção Imagem grande com texto ou Imagem pequena com texto for selecionada.
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 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 usuário Seleção dinâmica 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 de entrada	Aviso de lista
Figura 4. Propriedades básicas do controle de entrada do usuário Seleção dinâmica	Figura 5. Aviso da lista de Seleção dinâmica na IU da Web A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados são retornados: A lista inclui um link no final para mostrar mais resultados. Um ícone de pesquisa () é exibido no aviso para filtrar os resultados da pesquisa. Os usuários selecionam o ícone para abrir uma caixa de pesquisa e inserir o filtro.
	Figura 6. Aviso de lista de Seleção dinâmica na IU da Web com cartão de cabeçalho A lista de seleção contém cinco itens por página. Quando cinco ou mais resultados são retornados, a lista fornece uma opção para mostrar mais resultados. Nota: O recurso de pesquisa é suprimido quando um cartão de cabeçalho é usado.

Exemplo de expressão de valor da lista de Seleção dinâmica

(function execute(table) {
        var options = [];
        var gr = new GlideRecordSecure(table);
        gr.addEncodedQuery('active=true');
        gr.setLimit(5);
        gr.query();
        while(gr.next()) {
            options.push({ 'value': gr.getUniqueValue(), 'label': gr.getValue('short_description') });
        }
        return options;
})(table)

O script na propriedade Expressão de valor da seleção define e retorna uma matriz de opções. No exemplo, o script cria uma matriz chamada opções e adiciona cada registro encontrado em uma consulta GlideRecord a esta matriz. Cada elemento na matriz recebe um valor nas chaves de valor e rótulo usando dados desse GlideRecord. A propriedade Tabela do controle define a tabela usada pelo script. Este script de exemplo usa gr.setLimit(5) para limitar o número de registros retornados a 5. O uso deste método ajuda a impedir que os registros retornados criem uma lista de seleção muito grande.

Tabela 1. Chaves de expressão de valor do controle Seleção dinâmica
Chave	Descrição
valor	O valor para a opção. Quando um usuário seleciona uma opção no controle, este valor é armazenado na variável nomeada na propriedade Nome da variável.
rótulo	O rótulo que aparece para esta opção na lista de seleção.

Suporte ao canal

Tabela 2. Suporte ao canal para o controle de entrada do usuário Seleção dinâmica
Canal	Suporte	Restrições
IU da Web	Com suporte	Nenhum
IU para celular	Com suporte	Nenhum
Painel do Now Assist	Compatível	Nenhum
Microsoft Teams	Com suporte	Nenhum
Slack	Compatível	Não há suporte para cartões de cabeçalho.
Workplace	Compatível	Não há suporte para cartões de cabeçalho.
Facebook Messenger	Sem suporte	Não aplicável
SMS Twilio	Compatível	Não há suporte para cartões de cabeçalho.
LINE	Sem suporte	Não aplicável
WhatsApp	Com suporte	Nenhum
Apple Messages for Business	Com suporte	Nenhum
Alexa (Voz)	Com suporte	Para dispositivos de tela, use a rolagem de toque; não há suporte para clicar em links. Para dispositivos que não são de tela, use a paginação por voz.