Controle de entrada do usuário Seleção estática

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 10 min. de leitura
  • Use o controle de entrada do usuário Seleção estática em um tópico Virtual Agent para listar as opções predefinidas disponíveis para o usuário. Você pode selecionar apenas um item de uma lista de seleção.

    Exibição de seleção

    A lista de seleção contém até 10 itens por página. Quando houver mais de 10 itens, você terá a opção de exibir os itens adicionais e 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.

    O controle Seleção estática 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 exibidos na lista de seleção. Para obter detalhes sobre como criar uma propriedade do sistema, consulte Adição de uma propriedade do sistema.

    Propriedades do controle de entrada do usuário Seleção estática para descoberta de tópico LLM

    Propriedade Descrição
    Nome Nome que identifica este nó de controle do usuário Seleção estática no fluxo do tópico.
    Descrição do detalhe

    A única informação necessária por parte do usuário. Por exemplo, Pergunte ao usuário de qual item do catálogo de serviços ele precisa.

    Opções
    Nome de exibição
    Para cada seleção, o texto que aparece para o usuário para essa seleção. Use frases curtas em suas listas de seleção.
    • O Slack tem um limite de 30 caracteres para rótulos de lista de seleção.
    • O Workplace tem um limite de 20 caracteres para rótulos de lista de seleção.
    valor Para cada seleção, a cadeia de caracteres armazenada na variável quando a seleção correspondente é selecionada.
    Avançado
    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ó
    Usar 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 estática 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 Seleção estática
    As propriedades de entrada de opção estática incluem o nome do nó, a descrição detalhada e uma lista definida de opções.
    Figura 2. Instruções adicionais para LLM
    Em Instruções adicionais para LLM, insira instruções em linguagem simples ou use o campo de script ou defina condições com o seletor de cápsulas de dados.
    Figura 3. Aviso da lista de Seleção estática na IU da Web
    Um aviso básico da lista de Seleção estática com os seguintes dizeres: "Você poderia me informar o quão urgente é o seu problema? Você pode escolher entre Baixo, Médio e Alto."
    Figura 4. Aviso da lista de Seleção estática na IU da Web com mais de 10 itens
    Lista de Seleção estática na IU da Web com o cabeçalho "Você pode selecionar seus itens de café da manhã preferidos na lista a seguir", seguido por uma lista de mais de 10 itens.
    A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados são retornados, ocorre o seguinte:
    • A lista inclui um link no final para mostrar mais resultados.
    • Um ícone de pesquisa é exibido no aviso para filtrar os resultados da pesquisa. Selecione o ícone para abrir uma caixa de pesquisa e inserir o filtro.

    Propriedades do controle de entrada do usuário Seleção estática para descoberta do tópico NLU

    Propriedade Descrição
    Nome do nó Nome que identifica este nó de controle do usuário Seleção estática no fluxo do tópico.
    Descrição do detalhe A única informação necessária do usuário. Por exemplo, Pergunte ao usuário de qual item do Catálogo de serviços ele precisa.
    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
    Nome de exibição
    Para cada seleção, o texto que aparece para o usuário para essa seleção. Use frases curtas em suas listas de seleção.
    • O Slack tem um limite de 30 caracteres para rótulos de lista de seleção.
    • O Workplace tem um limite de 20 caracteres para rótulos de lista de seleção.
    valor Para cada seleção, a cadeia de caracteres armazenada na variável quando a seleção correspondente é selecionada.
    Avançado
    Cartão de cabeçalho
    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.

    A opção de Cartão de cabeçalho com o comutador de alternância Inserir habilitado. As opções incluem "Gostaria de ajuda - Sim" e "Não, vou usar 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. Especifique o link inserindo o texto do link, usando uma cápsula de dados ou usando um script. 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 Uma 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 estática 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 5. Propriedades básicas do controle de entrada Seleção estática
    As propriedades básicas incluem o nome do nó, o prompt, a entidade NLU associada e uma lista definida de opções.
    Figura 6. Caixa de diálogo Adicionar cartão (opção avançada de cartão de cabeçalho)
    Os campos incluem tipo de cartão, título, descrição, link da imagem e texto alternativo da imagem.
    Figura 7. Aviso da lista de Seleção estática na IU da Web
    Um aviso básico da lista Seleção estática que informa: "OK, qual é a urgência do seu problema?" As respostas incluem 1-Alto, 2-Médio e 3-Baixo.
    Figura 8. Aviso da lista de Seleção estática na IU da Web com mais de 10 itens
    Lista de Seleção estática na IU da Web com o cabeçalho "Aqui estão os itens do café da manhã", seguido por uma lista de mais de 10 itens.
    A lista de seleção exibe 10 itens por página. Quando 10 ou mais resultados são retornados, ocorre o seguinte:
    • A lista inclui um link no final para mostrar mais resultados.
    • Um ícone de pesquisa é exibido no aviso para filtrar os resultados da pesquisa. Selecione o ícone para abrir uma caixa de pesquisa e inserir o filtro.
    Figura 9. Lista de seleção estática da IU da Web com cartão de cabeçalho
    Exemplo de lista de Seleção estática. O título do cabeçalho é "Da loja de balas do seu bairro", seguido por um vídeo incorporado e uma lista de cinco itens.
    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.

    Suporte ao canal

    Tabela 1. Suporte ao canal para o controle de entrada do usuário Seleção estática
    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.

    Quando uma lista de seleção tem três opções ou menos, o Slack exibe a lista como botões.

    Workplace Compatível Não há suporte para cartões de cabeçalho.
    Facebook Messenger Compatível Em uma resposta rápida, o rótulo tem o limite máximo de 20 caracteres. Você pode exibir apenas 13 respostas rápidas por vez. Se houver mais de 13 respostas rápidas, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de respostas para uma página é definido na propriedade do sistema sn_va_fb_messenger.max_quick_replies. Esta propriedade está localizada na tabela Propriedade do sistema [sys_properties].
    SMS Twilio Compatível Não há suporte para cartões de cabeçalho.
    LINE Compatível Em uma resposta rápida, o rótulo tem um limite máximo de 20 caracteres. Você pode exibir apenas 13 respostas rápidas por vez. Se houver mais de 13 respostas rápidas, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de respostas para uma página é definido na propriedade do sistema sn_va_line.max.picker.choices. 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.