Escolha estática do controle de entrada do usuário

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 11 min. de leitura
  • Use o controle de entrada do usuário Escolha estática em um Virtual Agenttópico para listar opções predefinidas disponíveis para o usuário. Você pode selecionar apenas um item de uma lista de seleção.

    Exibição de opções

    A lista de seleção 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 filtrar os resultados da pesquisa. O prompt da lista de seleção contém uma pesquisa Ícone de pesquisa.ícone que os usuários podem selecionar para filtrar os resultados.

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

    Escolha estática de propriedades de controle de entrada do usuário para descoberta de tópico de LLM

    Propriedade Descrição
    Nome

    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 do detalhe

    Descrição das informações necessárias dos usuários. Se houver a desativação da opção Permitir preenchimento automático de slot, você poderá criar uma descrição dinâmica de detalhes selecionando o ícone Selecionador de cápsula de dados ícone Selecionador de cápsula de dados. para definir condições ou selecionar o ícone Abrir editor í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.

    Quando a alternância "Permitir preenchimento automático de slot" está inativa, a descrição detalhada inclui as opções dinâmicas de script e "Selecionador de cápsula de dados". Quando a alternância está ativa, o campo "Descrição detalhada" se torna estático.

    Escolhas
    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
    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.

    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 o 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.

    Ocultar ou ignorar 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.
    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.

    Controle de entrada do usuário de opção estática de exemplo 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

    Todos os campos básicos de entrada do usuário de opção estática estão disponíveis abertamente. Selecione qualquer uma das opções avançadas para ativá-las individualmente.

    Figura 1. Prompt da lista de seleção estática da IU da web
    Uma lista de seleção estática básica que diz: "Você poderia me dizer o quão urgente é o seu problema? Você pode escolher entre Baixo, Médio e Alto."
    Figura 2. Prompt da lista de seleção estática da IU da web com mais de 10 itens
    Lista de seleção estática na IU da web com o cabeçalho "Você poderia selecionar seus itens preferidos de café da manhã na lista a seguir" seguido por uma lista com 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 da lista para mostrar mais resultados.
    • Um ícone de pesquisa é exibido no prompt para filtrar os resultados da pesquisa. Selecione o ícone para abrir uma caixa de pesquisa e inserir o filtro.

    Escolha estática de propriedades de controle de entrada do usuário para descoberta de tópicos de NLU

    Propriedade Descrição
    Nome do nó

    Nome que identifica esse nó 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.

    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, ![texto alternativo](URL da imagem)
    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
    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
    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 opção estática de exemplo 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 3. Propriedades básicas do controle de entrada de escolha estática
    As propriedades básicas incluem o nome do nó, o prompt, a entidade de NLU associada e uma lista definida de opções.
    Figura 4. 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 de imagem e texto alternativo de imagem.
    Figura 5. Prompt da lista de seleção estática da IU da web
    Uma lista de seleção estática básica que diz: "OK, qual é a urgência do seu problema?" A resposta inclui 1-Alta, 2-Média e 3-Baixa.
    Figura 6. Prompt da lista de seleção estática da 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 da lista para mostrar mais resultados.
    • Um ícone de pesquisa é exibido no prompt para filtrar os resultados da pesquisa. Selecione o ícone para abrir uma caixa de pesquisa e inserir o filtro.
    Figura 7. Lista de seleção estática de IU da web com cartão de cabeçalho
    Exemplo de lista de seleção estática. O título do cabeçalho diz "Da sua loja de doces do 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 de canal

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

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

    Workplace Sem suporte Compatível Cartões de cabeçalho não são compatíveis.
    Facebook Messenger Sem suporte Compatível Em uma resposta rápida, o rótulo tem o limite máximo de caracteres 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 em sn_va_fb_messenger.max_quick_repliespropriedade do sistema. Esta propriedade está localizada na tabela Propriedade do sistema [sys_properties].
    SMS Twilio Compatível Compatível Cartões de cabeçalho não são compatíveis.
    LINE Sem suporte 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 em sn_va_line.max.picker.choicespropriedade do sistema. A propriedade está localizada na tabela Propriedade do sistema [sys_properties].
    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 de tela, use a rolagem de toque. Para dispositivos que não são de tela, use a paginação por voz.