Escolha dinâmica de entrada do usuário

Use o controle de entrada do usuário de Escolha dinâmica em um Virtual Agentpara criar dinamicamente uma lista de opções disponíveis para seus usuários. Crie essas opções consultando uma tabela ou usando um script para criá-las dinamicamente.

Exibição da lista de opções

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

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.

Se a seleção de várias opções estiver ativada, você poderá pesquisar no Pesquisar opções campo para filtrar resultados da pesquisa. Selecione ou digite todas as opções aplicáveis e selecione o ícone de envio . Quando você envia suas escolhas por meio de um tópico de LLM, o LLM responde se suas escolhas atendem aos critérios de validação.

Você também pode selecionar uma ou mais opções de uma lista em uma conversa de LLM inserindo um enunciado na janela de bate-papo. Se não houver correspondência para sua entrada, o. Virtual Agentinforma que não é uma opção válida e solicita que você tente uma entrada diferente.

O controle Seleção dinâmica também fornece 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 móveis.

• O cartão de cabeçalho pode conter uma imagem grande ou pequena ou um cartão de vídeo do YouTube, juntamente com um texto descritivo. A lista de seleção contém até cinco itens por padrão, mas o recurso de pesquisa é suprimido. Se houver mais de cinco itens, os usuários poderão optar por mostrar os itens adicionais.

• Para controlar o número de itens exibidos abaixo de um cartão de cabeçalho, adicione com.glide.cs.web_header_picker_page_limitpropriedade do sistema. 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 Adicione uma propriedade do sistema .

Nota:

Se você preencher um nó da Lista de seleção dinâmica com apenas uma opção, ao testar ou usar o nó, você receberá uma mensagem de leitura "Temos [choice] como [nome do nó], está correto?" . Use várias opções no nó da lista de seleção dinâmica para evitar receber esta mensagem.



Você também pode alterar o conteúdo da mensagem navegando até TODOS > sys_properties.list e editando o. glide.cs.retry_question_messagepropriedade do sistema. Este valor de mensagem é, por padrão, uma cadeia de caracteres Temos (0) como (1), está correto? E é usado para preenchimento de slot em vários casos fora da lista de seleção dinâmica. Todas as mudanças feitas são refletidas em cada uso desta propriedade.

Propriedades de controle de entrada do usuário de escolha dinâmica para descoberta de tópico de LLM

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? Você pode criar rich text para alterar o estilo do prompt: Use asteriscos únicos ou sublinhados para gerar texto em itálico. Por exemplo, *text* ou _text_. Use asteriscos ou sublinhados duplos para gerar texto em negrito. Por exemplo, **text** ou __text__. Use asteriscos ou sublinhado triplos para gerar texto em itálico e negrito. Por exemplo, ***texto*** ou ___texto___. Use um hífen espaçado para adicionar um marcador a uma linha. Por exemplo, - texto. Use um colchete angular espaçado e voltado para a direita para criar uma citação em bloco. Por exemplo, > texto. Use de uma a seis cerquilhas para criar cabeçalhos. Por exemplo, #texto# ou ######texto###### Use colchetes e parênteses para criar um hiperlink. Por exemplo, [Texto do link](url). Adicione um ponto de exclamação a um hiperlink para exibir uma imagem. Por exemplo, 
Entidade 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.
Escolhas
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. Nota: Para obter resultados de retorno de paginação mais eficientes para um grande conjunto de dados ao usar uma expressão de script, revise o script a seguir e determine se você deseja usar este script: (function execute() { var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", null, "user_name,name", "active=true", null, vaVars); var gr = pagingUtil.getPagingGlideRecordSecure("name", false); var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name','name']); return options; })() Para obter mais informações sobre os detalhes de script anteriores, revise as informações sobre GlideRecords e as informações adicionais: fieldName: o nome do campo é uma informação opcional. Passar com nulo. table: nome da tabela a ser consultada para exibir as opções disponíveis. pageSize: o tamanho da página é uma informação opcional. Passar com nulo. searchColumns: colunas de tabela em uma lista delimitada por vírgulas que se aplica a qualquer searchText. encodedQuery: consulta inicial a ser aplicada às linhas da tabela. Por exemplo, active=true. searchText: o texto de pesquisa é uma informação opcional. Passar com nulo. vaVars: referência às variáveis de contexto do Virtual Agent (vaVars). orderByColumn: coluna da tabela usada para ordenar as opções. orderDescending: as opções aparecem em ordem decrescente. Somente valores verdadeiro ou falso aceitos. gr: nome do registro do Glide. startRow: a linha inicial é uma informação opcional. Passar com nulo. valueColumn: nome da coluna da tabela a ser usada como o valor de cada opção. labelColumns: matriz de colunas de tabela a serem usadas para cada exibição de opção.
Tabela	Tabela para pesquisa; disponível somente se você selecionou Registro como o método para preencher opções.
Opções de filtro	Opção de usar o Construtor de condições Designer do Virtual Agent ou fornecer um script. Selecione uma das seguintes propriedades: Construtor de condições: 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 de valores de nome é armazenado como um objeto de cadeia de caracteres. Este campo está disponível somente quando a opção Registro é selecionada.
Permitir que o usuário selecione mais de uma opção	Opção para permitir que os usuários escolham várias opções na lista de seleção.
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
Cabeçalho de cartão	Ative para abrir um campo e adicionar cartões que podem incluir imagens ou vídeos do YouTube. Para obter mais informações, consulte Insira um cartão de cabeçalho em um controle Escolha estática ou Escolha dinâmica.
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}}?.
Mudança 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.
Ocultar ou ignorar este nó
Mostrar condicionalmente este nó 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.

Controle de entrada do usuário de Escolha dinâmica para descoberta de tópico de LLM

Nota:

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

Propriedades de entrada

Listar prompt do usuário

Figura 1. Exemplo de prompt de lista de seleção dinâmica da IU da web A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados forem retornados: A lista inclui um link no final da lista para mostrar mais resultados. Um ícone de pesquisa exibido no prompt para filtrar os resultados da pesquisa. Os usuários selecionam o ícone para abrir uma caixa de pesquisa e inserir o filtro. Ao selecionar várias opções, você pode pesquisar no Pesquisar opções campo para filtrar resultados da pesquisa. Selecione ou digite todas as opções aplicáveis e selecione o ícone de envio . Quando você envia suas escolhas, o LLM responde se suas escolhas atendem aos critérios de validação.

Propriedades de controle de entrada do usuário de escolha dinâmica 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? Você pode criar rich text para alterar o estilo do prompt: Use asteriscos únicos ou sublinhados para gerar texto em itálico. Por exemplo, *text* ou _text_. Use asteriscos ou sublinhados duplos para gerar texto em negrito. Por exemplo, **text** ou __text__. Use asteriscos ou sublinhado triplos para gerar texto em itálico e negrito. Por exemplo, ***texto*** ou ___texto___. Use um hífen espaçado para adicionar um marcador a uma linha. Por exemplo, - texto. Use um colchete angular espaçado e voltado para a direita para criar uma citação em bloco. Por exemplo, > texto. Use de uma a seis cerquilhas para criar cabeçalhos. Por exemplo, #texto# ou ######texto###### Use colchetes e parênteses para criar um hiperlink. Por exemplo, [Texto do link](url). Adicione um ponto de exclamação a um hiperlink para exibir uma imagem. Por exemplo, 
Entidade 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.
Escolhas
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. Nota: Para obter resultados de retorno de paginação mais eficientes para um grande conjunto de dados ao usar uma expressão de script, revise o script a seguir e determine se você deseja usar este script: (function execute() { var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", null, "user_name,name", "active=true", null, vaVars); var gr = pagingUtil.getPagingGlideRecordSecure("name", false); var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name','name']); return options; })() Para obter mais informações sobre os detalhes de script anteriores, revise as informações sobre GlideRecords e as informações adicionais: fieldName: o nome do campo é uma informação opcional. Passar com nulo. table: nome da tabela a ser consultada para exibir as opções disponíveis. pageSize: o tamanho da página é uma informação opcional. Passar com nulo. searchColumns: colunas de tabela em uma lista delimitada por vírgulas que se aplica a qualquer searchText. encodedQuery: consulta inicial a ser aplicada às linhas da tabela. Por exemplo, active=true. searchText: o texto de pesquisa é uma informação opcional. Passar com nulo. vaVars: referência às variáveis de contexto do Virtual Agent (vaVars). orderByColumn: coluna da tabela usada para ordenar as opções. orderDescending: as opções aparecem em ordem decrescente. Somente valores verdadeiro ou falso aceitos. gr: nome do registro do Glide. startRow: a linha inicial é uma informação opcional. Passar com nulo. valueColumn: nome da coluna da tabela a ser usada como o valor de cada opção. labelColumns: matriz de colunas de tabela a serem usadas para cada exibição de opção.
Tabela	Tabela para pesquisa; disponível somente se você selecionou Registro como o método para preencher opções.
Opções de filtro	Opção de usar o Construtor de condições Designer do Virtual Agent ou fornecer um script. Selecione uma das seguintes propriedades: Construtor de condições: 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 de valores de nome é armazenado como um objeto de cadeia de caracteres. Este campo está disponível somente quando a opção Registro é selecionada.
Permitir que o usuário selecione mais de uma opção	Opção para permitir que os usuários escolham várias opções na lista de seleção.
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
Cabeçalho de cartão	Ative para abrir um campo e adicionar cartões que podem incluir imagens ou vídeos do YouTube. Para obter mais informações, consulte Insira um cartão de cabeçalho em um controle Escolha estática ou Escolha dinâmica.
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}}?.
Mudança 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.
Ocultar ou ignorar este nó
Mostrar condicionalmente este nó 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.

Controle de entrada do usuário de Escolha dinâmica para descoberta de tópicos de NLU

Nota:

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

Propriedades de entrada	Prompt de lista
Figura 2. Propriedades básicas do controle de entrada do usuário de escolha dinâmica	Figura 3. Prompt da lista de seleção dinâmica da IU da web A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados forem retornados: A lista inclui um link no final da lista para mostrar mais resultados. Um ícone de pesquisa ( ) é exibido no prompt para filtrar os resultados da pesquisa. Os usuários selecionam o ícone para abrir uma caixa de pesquisa e inserir o filtro. Ao selecionar várias opções, você pode pesquisar no Pesquisar opções campo para filtrar resultados da pesquisa. Se você inserir o script para habilitar os campos secundários encontrados neste tópico, os resultados do filtro de pesquisa também se aplicarão aos campos secundários. Selecione ou insira todas as opções aplicáveis e selecione o ícone de envio .
	Figura 4. Prompt da lista de seleção dinâmica da 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.

Exemplos de script de escolha dinâmica

O exemplo de script a seguir pode ser usado no Defina escolhas campo somente se o valor for Preencha a opção por está definido como Script . Este script permite que os solicitantes vejam suas escolhas selecionadas anteriormente se optarem por editar suas escolhas mais tarde na conversa. Este script também exibe campos secundários para os solicitantes, como endereço de e-mail, marcador de gênero ou ambos, para ajudá-los a diferenciar ainda mais suas opções disponíveis. A exibição do campo secundário para solicitantes pode ser especialmente útil ao lidar com valores semelhantes, como selecionar o nome correto do funcionário ao trabalhar com nomes iguais ou semelhantes (ou seja, Christopher Smith ou Chris Smith).

(function execute() {
    var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", 10, "user_name,name",
      "active=true", null, vaVars);
    var selectedOptions = pagingUtil.getSavedSelectedOptions("user", vaSystem);
    if (!selectedOptions || selectedOptions.length == 0) {
      // Secondary labels can be passed to selected options
       selectedOptions.push({ "value": "abel.tuter", "label": "Abel Tuter"
        ,"secondary_label": ["[e-mail]", "male"]
        });
       selectedOptions.push({ "value": "Beth.anglin", "label": "Beth Anglin"
        ,"secondary_label": ["[e-mail]", "female"] 
        });
    }
    vaSystem.setSelectedOptions(selectedOptions, "user", false);
    // Topic authors have the ability to define which values should go in the 
    // secondary labels by adding secondary label functions
    pagingUtil.addSecondaryLabelFunction(function (gr) {
      return gr.getValue("email");
    });
    pagingUtil.addSecondaryLabelFunction(function (gr) {
      return gr.getValue("gender");
    });
    var gr = pagingUtil.getPagingGlideRecordSecure("name", false);
    var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name']);
    return options;
})()

Expressão de valor da lista de seleção dinâmica de exemplo

(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 no Expressão do valor de escolha a propriedade 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 no valor e. rótulo Chaves que usam dados desse GlideRecord. . Tabela a propriedade 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 de controle de escolha dinâmica

Chave	Descrição
valor	O valor da opção. Quando um usuário seleciona uma opção no controle, esse valor é armazenado na variável nomeada em Nome da variável propriedade.
rótulo	O rótulo que aparece para esta opção na lista de seleção.

Suporte de canal

Tabela 2. Suporte de canal para o controle de entrada do usuário de Escolha dinâmica

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	Compatível	Compatível	Nenhum(a)
Slack	Sem suporte	Compatível	Cartões de cabeçalho não são compatíveis.
Workplace	Sem suporte	Compatível	Cartões de cabeçalho não são compatíveis.
Facebook Messenger	Sem suporte	Sem suporte	Não aplicável
SMS Twilio	Sem suporte	Compatível	Cartões de cabeçalho não são compatíveis.
LINE	Sem suporte	Sem suporte	Não aplicável
WhatsApp	Compatível	Compatível	Nenhum(a)
Apple Messages for Business	Sem suporte	Compatível	Nenhum(a)
Alexa (Voz)	Sem suporte	Compatível	Para dispositivos com tela, use a rolagem sensível ao toque; não há suporte para clicar em links. Para dispositivos que não são de tela, use a paginação por voz.