Controle de texto de entrada do usuário

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 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 LLM

    Propriedade Descrição
    Nome do nó Nome que identifica este nó de controle de texto de entrada do usuário 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.
    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 texto de entrada do usuário para descoberta de tópico LLM

    Tabela 1. Propriedades do controle de entrada do tópico LLM
    Propriedades de entrada Aviso de entrada
    Figura 1. Propriedades básicas de controle de entrada de texto
    As propriedades de texto de entrada do usuário incluem o nome do nó e a descrição detalhada.
    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 de entrada de texto do usuário na IU da Web
    Cliente web mostrando aviso de entrada. O texto diz: "Você poderia fornecer seu primeiro item do Catálogo de serviços?"

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

    Propriedade Descrição
    Nome do nó Nome que identifica este nó de controle de texto de entrada do usuário 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?

    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 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.
    Avançado
    Tornar esta entrada segura
    Habilitar Comutador de alternância que criptografa a entrada do usuário do bot de texto. 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}}?.
    Alternância de tópicos
    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 texto de entrada do usuário para descoberta de tópico de NLU

    Propriedades de entrada Aviso de entrada
    Figura 4. Propriedades básicas de controle de entrada de texto
    As propriedades de texto de entrada do usuário incluem o nome do nó, o prompt, o formato de entrada e a entidade NLU opcional.
    Figura 5. 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 Função de hash e Sal de criptografia são exibidos.
    Figura 6. Aviso de entrada de texto do usuário na IU da Web
    O prompt de entrada é mostrado no cliente web. O texto é: "Insira uma descrição resumida do que você está procurando".
    Figura 7. Aviso de entrada do usuário em um aplicativo para celular com o comutador de alternância Tornar esta entrada segura habilitado
    Uma 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 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 Com suporte 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 um usuário do Slack editar uma entrada de texto, como um comentário para atualizar um caso, Virtual Agent não avaliará a atualização editada.
    Workplace Com suporte Nenhum
    Facebook Messenger Com suporte O limite máximo é de 5000 caracteres.
    SMS Twilio Com suporte Nenhum
    LINE Com suporte O limite máximo é de 5000 caracteres.
    WhatsApp Com suporte Nenhum
    Apple Messages for Business Com suporte Nenhum
    Alexa (Voz) Com suporte Para dispositivos de tela, podem ser aplicados limites de caracteres. Para mais informações, consulte a documentação do desenvolvedor da Alexa.