Controle de texto de entrada do usuário

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • O controle de texto de entrada do usuário em um tópico Virtual Agent solicita ao usuário uma cadeia de caracteres de texto.

    Propriedades de controle de texto de entrada do usuário para descoberta de tópico de LLM

    Propriedade Descrição
    Nome do nó

    Nome que identifica este nó no fluxo de 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. . Permitir preenchimento automático de slot Se a alternância estiver desativada, você pode criar uma descrição detalhada dinâmica selecionando o ícone Seletor de cápsula de dados Ícone do seletor de cápsula de dados.Para definir condições ou selecione 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.

    Formato de entrada
    O formato de texto validado quando um usuário insere alguns itens de texto. Se o usuário não inserir o texto no formato esperado, uma mensagem de erro indicará que o formato não é válido e pedirá que o usuário reinsira o texto. Escolha o formato do item de texto a ser validado:
    • Texto: qualquer cadeia de caracteres de texto (sem validação).
    • E-mail: formato que consistente em um prefixo de e-mail (nome de usuário), o símbolo @ e o domínio.
    • Endereço IP (IPV4, IPV6): formato de entrega de comunicação de dados para o Protocolo de internet versão 4 ou 6.
    • Número de telefone (E.164): formato de número de telefone padrão reconhecido internacionalmente.
    • URL: formato de endereço da Web.
    • Personalizado: um script que fornece uma regra de validação para um formato de texto personalizado. O script deve incluir mensagens de erro relacionadas que são exibidas quando não é inserido o formato esperado.
    Para obter exemplos do formato de telefone e endereço IP, consulte Formatos de telefone E.164 e Tipos de campo do endereço IP.
    Avançado
    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.
    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. A condição deve ser avaliada como verdadeira. Você pode definir este campo usando o construtor de condição ou um script.

    Exemplo de controle de entrada de texto do usuário para descoberta de tópico LLM

    Tabela 1. Propriedades de controle de entrada de tópico LLM
    Propriedades de entrada Aviso de entrada

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

    Figura 1. Aviso de entrada de texto do usuário na IU da Web
    Cliente web mostrando prompt de entrada. O texto diz: "Você poderia fornecer seu primeiro item do catálogo de serviços?"

    Propriedades de controle de entrada do usuário de texto para NLU descoberta de tópico

    Propriedade Descrição
    Nome do nó

    Nome que identifica este nó no fluxo de 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?

    Formato de entrada
    O formato de texto validado quando um usuário insere alguns itens de texto. Se o usuário não inserir o texto no formato esperado, uma mensagem de erro indicará que o formato não é válido e pedirá que o usuário reinsira o texto. Escolha o formato do item de texto a ser validado:
    • Texto: qualquer cadeia de caracteres de texto (sem validação).
    • E-mail: formato que consistente em um prefixo de e-mail (nome de usuário), o símbolo @ e o domínio.
    • Endereço IP (IPV4, IPV6): formato de entrega de comunicação de dados para o Protocolo de internet versão 4 ou 6.
    • Número de telefone (E.164): formato de número de telefone padrão reconhecido internacionalmente.
    • URL: formato de endereço da Web.
    • Personalizado: um script que fornece uma regra de validação para um formato de texto personalizado. O script deve incluir mensagens de erro relacionadas que são exibidas quando não é inserido o formato esperado.
    Para obter exemplos do formato de telefone e endereço IP, consulte Formatos de telefone E.164 e Tipos de campo do endereço IP.
    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.

    Avançado
    Tornar esta entrada segura
    Habilitar

    Comutador que criptografa o controle de entrada. Quando habilitada, a entrada do usuário é mascarada e aparece como uma série de pontos na janela de bate-papo.

    Função hash

    [Visível quando a opção Tornar esta entrada segura estiver habilitada]

    O algoritmo do resumo do método baseado na especificação WS-Security padrão. Escolha uma das opções a seguir:
    • SHA-256 (minúscula)
    • SHA-1 (minúscula)
    Para obter mais informações sobre os padrões WS-security, consulte Propriedades WS-Security.
    Salt de criptografia

    [Visível quando a opção Tornar esta entrada segura estiver habilitada]

    Dados aleatórios que são usados como entrada adicional em uma função unidirecional que faz hash dos dados.

    Valor padrão
    Predefinir um valor para a entrada do usuário

    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
    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 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. A condição deve ser avaliada como verdadeira. Você pode definir este campo usando o construtor de condição ou um script.

    Ignorar nova solicitação

    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 texto de exemplo para NLU descoberta de tópico

    Propriedades de entrada Aviso de entrada
    Figura 2. Propriedades básicas de controle de entrada de texto
    As propriedades de entrada do usuário de texto incluem o nome do nó, o prompt, o formato de entrada e a entidade NLU opcional.
    Figura 3. Tornar esta entrada segura (Propriedades avançadas)
    Em Tornar esta entrada segura, deslize o botão de alternância para habilitar o recurso. Os campos SALT Função de hash e Criptografia são exibidos.
    Figura 4. Aviso de entrada de texto do usuário na IU da Web
    Prompt de entrada mostrado no cliente web. O texto diz: "Insira uma descrição resumida do que você está procurando".
    Figura 5. Aviso de entrada do usuário em um aplicativo para celular com o comutador de alternância Tornar esta entrada segura habilitado
    A entrada segura do usuário em um aplicativo para celular exibe pontos no lugar da senha.

    Suporte ao canal

    Nota:
    Designer do Virtual Agent os controles podem ser exibidos e funcionar de forma diferente em outros canais.
    Tabela 2. Suporte ao canal para o controle de entrada de texto do usuário
    Canal Suporte a LLM NLU suporte a /keyword Restrições
    IU da Web Sem suporte Compatível Nenhum.
    IU para celular Sem suporte Compatível Nenhum.
    Painel do Now Assist Sem suporte Compatível Nenhum.
    Microsoft Teams Compatível Compatível Nenhum.
    Slack Sem suporte Compatível os usuários Slack podem editar o texto inserido anteriormente em uma conversa. No entanto, Virtual Agent processa as mensagens conforme elas são inseridas. Se for um Slack o usuário edita a entrada de texto, como um comentário, para atualizar um caso Virtual Agent não avalia a atualização editada.
    Workplace Sem suporte Compatível Nenhum.
    Facebook Messenger Sem suporte Compatível O limite máximo é de 5000 caracteres.
    SMS Twilio Sem suporte Compatível Nenhum.
    LINE Sem suporte Compatível O limite máximo é de 5000 caracteres.
    WhatsApp Compatível Compatível Nenhum.
    Apple Messages for Business Sem suporte Compatível Nenhum.
    Alexa (Voz) Sem suporte Compatível Para dispositivos de tela, podem ser aplicados limites de caracteres. Para mais informações, consulte a documentação do desenvolvedor da Alexa.