--- sourceDocument: Interfaces conversacionais de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais de Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Controle de entrada do usuário de texto # Controle de entrada do usuário de texto {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 min. de leitura O controle de entrada do usuário de texto em um Virtual Agento tópico solicita ao usuário uma cadeia de caracteres de texto. ## Propriedades de controle de entrada do usuário de texto para descoberta de tópico de LLM {#va-text-input__section_xq2_jn5_g1c} {#va-text-input__table_of1_vt5_g1c__entry__2} | Propriedade | Descrição | |-|-| | Nome do nó | 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. | | 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. {#va-text-input__ul_pf1_vt5_g1c}Para obter exemplos do formato de telefone e endereço IP, consulte [Formatos de telefone E.164](https://www.servicenow.com/docs/access?context=r_ConfigureE.164PhoneNumberFields&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US) e [Tipos de campo do endereço IP](https://www.servicenow.com/docs/access?context=r-IPAddressFieldType&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). | | Avançado || | 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. | [ ] {#va-text-input__table_of1_vt5_g1c} ## Controle de entrada do usuário de texto de exemplo para descoberta de tópico de LLM {#va-text-input__section_zq2_jn5_g1c} {#va-text-input__table_ar2_jn5_g1c__entry__2} | Propriedades de entrada | Prompt de entrada | |-|-| | | Figura 1. Prompt de entrada do usuário de texto da IU da web | [Tabela 1. Propriedades de controle de entrada de tópico de LLM] {#va-text-input__table_ar2_jn5_g1c} ## Propriedades de controle de entrada do usuário de texto para NLUdescoberta de tópicos {#va-text-input__section_hr2_jn5_g1c} {#va-text-input__table_ir2_jn5_g1c__entry__2} | Propriedade | Descrição | |-|-| | Nome do nó | 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ó. | | 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. {#va-text-input__d23242e197}Para obter exemplos do formato de telefone e endereço IP, consulte [Formatos de telefone E.164](https://www.servicenow.com/docs/access?context=r_ConfigureE.164PhoneNumberFields&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US) e [Tipos de campo do endereço IP](https://www.servicenow.com/docs/access?context=r-IPAddressFieldType&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). | | 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 | Botão de alternância 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 Tornar esta entrada segura está habilitado\] | 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) {#va-text-input__ul_kr2_jn5_g1c}Para obter mais informações sobre os padrões WS-security, consulte [Propriedades WS-Security](https://www.servicenow.com/docs/access?context=ws-security-properties&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). | | Salt de criptografia \[Visível quando Tornar esta entrada segura está habilitado\] | 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 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. | | Ignorar a 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. | [ ] {#va-text-input__table_ir2_jn5_g1c} ## Controle de entrada do usuário de texto de exemplo para NLUdescoberta de tópicos {#va-text-input__section_lr2_jn5_g1c} {#va-text-input__table_mr2_jn5_g1c__entry__2} | Propriedades de entrada | Prompt de entrada | |-|-| | Figura 2. Propriedades básicas do controle de entrada de texto Figura 3. Tornar esta entrada segura (propriedades avançadas) | Figura 4. Prompt de entrada do usuário de texto da IU da web | | Figura 2. Propriedades básicas do controle de entrada de texto Figura 3. Tornar esta entrada segura (propriedades avançadas) | Figura 5. Prompt de entrada do usuário em um app para celular com o botão de alternância Tornar esta entrada segura habilitado | [ ] {#va-text-input__table_mr2_jn5_g1c} ## Suporte de canal {#va-text-input__section_vr2_jn5_g1c} Nota: Designer do Virtual Agent os controles podem ser exibidos e funcionar de forma diferente em outros canais. {#va-text-input__table_wr2_jn5_g1c__entry__4} | Canal | Suporte a LLM | NLUsuporte 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 | Slack os usuários podem editar o texto inserido anteriormente em uma conversa. No entanto, Virtual Agentprocessa mensagens conforme elas são inseridas pela primeira vez. Se for um Slacko usuário edita a entrada de texto, como um comentário, para atualizar um caso Virtual Agentnão avalia a atualização editada. | | Workplace | Sem suporte | Compatível | Nenhum. | | Facebook Messenger | Sem suporte | Compatível | O limite máximo de caracteres é de 5000 caracteres. | | SMS Twilio | Sem suporte | Compatível | Nenhum. | | LINE | Sem suporte | Compatível | O limite máximo de caracteres é 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, limites de caracteres podem ser aplicados. Para obter mais informações, consulte [Documentação do desenvolvedor do Alexa](https://developer.amazon.com/en-US/docs/alexa/custom-skills/display-interface-reference.html). | [Tabela 2. Suporte de canal para o controle de entrada do usuário de texto] {#va-text-input__table_wr2_jn5_g1c}