Controle de texto de entrada do usuário

  • Versão de lançamento: Xanadu
  • Atualizado 12 de ago. de 2024
  • 8 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ó de controle de texto de entrada do usuário no fluxo do tópico.
    Descrição em detalhes

    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.

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

    As propriedades de entrada do usuário de texto incluem nome do nó, descrição detalhada e formato de entrada. As opções avançadas incluem Aplicar prompt do usuário e Instruções adicionais ao LLM, definidas por entrada de texto, condições ou scripts.

    Figura 1. Aviso de entrada de texto do usuário na IU da Web
    Cliente Web mostrando o prompt 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 de 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 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 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}}?.

    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.

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

    Propriedades de entrada Aviso de entrada
    Figura 2. Propriedades básicas de controle de entrada de texto
    As propriedades de entrada de texto do usuário 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 Função de hash e Sal de criptografia são exibidos.
    Figura 4. Aviso de entrada de texto do usuário na IU da Web
    O 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
    Uma entrada de usuário segura 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 Com suporte 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 (Serviços de 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.