---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# controles de entrada do usuário Designer do Virtual Agent

# controles de entrada do usuário Designer do Virtual Agent {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Use a coleção de controles de entrega fornecida por Designer do Virtual Agent para solicitar e capturar informações do usuário em uma conversa.

## Propriedades de controle de entrada comuns {#va-user-inputs__section_r33_ygb_xdb}

Além das [cápsulas de dados e controles de condição](https://servicenow-prod.fluidtopics.net/hdI771iTrNpEBwCAW3eRmw "Um tópico Virtual Agent consiste em uma coleção de controles em um fluxo de tópico. Use esses controles para coletar, processar e apresentar informações aos usuários. Os controles também podem ler, criar e atualizar registros em sua instância."), cada controle de entrada tem as seguintes propriedades comuns:  

Variável de entrada para a resposta do usuário
:   Cada controle armazena a resposta do usuário em uma variável de entrada que pode ser acessada por outros controles no mesmo tópico usando os métodos `getValue` e `getDisplayValue`. O nome da variável é baseado no nome que você atribuiu ao controle de entrada. Por exemplo, se você atribuir o nome <kbd class="ph userinput">Primeiro aviso</kbd> a um controle de entrada, o nome da variável será `first_prompt`. O nome da variável está em letra minúscula, com um sublinhado em vez de um espaço. Para mais informações sobre esses métodos, consulte [Scripts Virtual Agent](https://servicenow-prod.fluidtopics.net/_zNKHyhzS4jqqcnQ~mt_rw "Use os métodos e variáveis de script ServiceNow Virtual Agent para escrever scripts de bate-papo, como resposta, gatilho e scripts de fluxo. As variáveis também podem fornecer contexto para seus tópicos e conversas de suporte ao vivo.").
:
    Figura 1. O campo Nome da variável é preenchido automaticamente

propriedades da entidade Compreensão da linguagem natural (NLU)
:   Se NLU estiver habilitado, as propriedades a seguir serão exibidas na folha de propriedades para os controles de entrada Texto, Seleção estática, Seleção dinâmica, Booliano, Data/hora e Carrossel. Para exibir ou habilitar essas propriedades, acesse a seção Opções avançadas.

    * Entidade de NLU: a entidade que corresponde à variável de entrada do controle. Selecione a entidade na lista de entidades associadas à intenção do tópico, como definido no modelo NLU que você está usando para o tópico. Quando Virtual Agent reconhece o valor da entidade nos enunciados do usuário e se o valor atende ao limite de confiança de previsão da entidade, Virtual Agent extrai o valor. O valor é armazenado na variável de entrada do nó. Essa ação de armazenamento é chamada de preenchimento de slot. O preenchimento de slot reconhece quando ocorrem vários valores para a mesma entidade NLU em uma conversa. Os usuários recebem uma solicitação com uma lista para confirmar qual valor de nó selecionar quando vários nós estão vinculados à mesma entidade NLU. Esta propriedade está disponível somente para o NLU tópico discovery.  
      Figura 2. propriedade da entidade NLU ![Deslize a alternância da entidade NLU para selecionar um tópico de NLU quando a descoberta de tópicos estiver habilitada.]()
    * Habilitar NLU para alternar tópicos: habilita a previsão NLU para o nó. Se habilitado, os usuários podem inserir texto para responder a perguntas, independentemente do tipo de controle de entrada sendo usado. Virtual Agent usa este enunciado para corresponder a outra intenção existente, permitindo que o usuário alterne tópicos. Para habilitar esta propriedade em um nó, navegue até Opções avançadasAlternância de tópicos.  
      Figura 3. Habilite NLU para alternar as propriedade de tópicos ![Em Opções avançadas - Alternância de tópicos, deslize a propriedade Habilitar NLU para alternar tópicos para alternar tópicos.]()
    {#va-user-inputs__ul_h3d_jwn_thb}

Valor padrão
:   Um aviso de entrada pode ter um valor predefinido definido por você. Este valor pode ser uma cadeia de caracteres ou um script que retorna uma cadeia de caracteres. Esta propriedade está na seção Opções avançadas.
:
    Figura 4. Propriedade de valor padrão

Mensagens de confirmação
:   Essas mensagens de resposta do bot sinalizam o fim da interação do nó e solicitam que os usuários confirmem a resposta. Esta propriedade está na seção Opções avançadas.
:
    Figura 5. Propriedades de mensagens de confirmação

## Entradas do usuário do modelo de linguagem grande (LLM) {#va-user-inputs__section_bn4_dy3_jcc}

Várias entradas do usuário NLU se tornam habilitadas para LLM quando você cria um tópico LLM Virtual Agent. As entradas do usuário habilitadas para LLM incluem o seguinte.

* [Coletor de entrada](https://servicenow-prod.fluidtopics.net/L2X_Wo2X4nEPgWJeDyMRag "Use o controle do Coletor de entrada para coletar dados para uso por Now Assist em conversas que usam a descoberta de tópico de modelo de linguagem grande (LLM).")
* [Entrada de texto](https://servicenow-prod.fluidtopics.net/SQYWLhsKQa9RGGHsflaMdw "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.")
* [Lista de seleção estática](https://servicenow-prod.fluidtopics.net/r5YW_WkbcTC3SGLAnlk44A "Use o controle de entrada do usuário Seleção estática em um tópico Virtual Agent para listar as opções predefinidas disponíveis para o usuário. Você só pode selecionar um item de uma lista de seleção.")
* [Lista de seleção dinâmica](https://servicenow-prod.fluidtopics.net/30umw08~RdpB4RaGHj4EIQ "Use o controle de entrada do usuário Seleção dinâmica em um tópico Virtual Agent para criar dinamicamente uma lista de seleções disponíveis para os usuários. Consulte uma tabela ou use um script para criar essas seleções dinamicamente.")
* [Entrada booliana](https://servicenow-prod.fluidtopics.net/8cStUGC_hZYzmQHKZ4RvIg "Use o controle de entrada do usuário Booliano em um tópico Virtual Agent para apresentar um aviso de Sim/Não ao usuário.")
* [Entrada de data e hora](https://servicenow-prod.fluidtopics.net/eKzC2erM5pR1j7rL2S25RA "Use o controle de Data e Hora de entrada do usuário em um tópico Virtual Agent para permitir que o usuário selecione uma data do calendário, a hora (horas e minutos) ou ambos.")
* Entrada do carrossel
{#va-user-inputs__ul_r2f_4y3_jcc}  
Nota:  
Evite colocar mais de 5 entradas de usuário em um único tópico LLM ou mais de 5 entradas de usuário em um único Coletor de entrada. O excesso de entradas do usuário pode sobrecarregar o LLM e levar a respostas imprecisas ou inesperadas.
* **[Controle de entradas do usuário do Coletor de entrada](https://servicenow-prod.fluidtopics.net/L2X_Wo2X4nEPgWJeDyMRag)**   
  Use o controle do Coletor de entrada para coletar dados para uso por Now Assist em conversas que usam a descoberta de tópico de modelo de linguagem grande (LLM).
* **[Controle de texto de entrada do usuário](https://servicenow-prod.fluidtopics.net/SQYWLhsKQa9RGGHsflaMdw)**   
  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.
* **[Controle de entrada do usuário Seleção estática](https://servicenow-prod.fluidtopics.net/r5YW_WkbcTC3SGLAnlk44A)**   
  Use o controle de entrada do usuário Seleção estática em um tópico Virtual Agent para listar as opções predefinidas disponíveis para o usuário. Você só pode selecionar um item de uma lista de seleção.
* **[Controle de entrada do usuário Seleção agrupada](https://servicenow-prod.fluidtopics.net/cQF0bc~tqZM2ROGjIfvXJg)**   
  Use o controle de entrada do usuário Seleção agrupada em um tópico Virtual Agent para listar vários grupos de seleção em uma mensagem.
* **[Controle de entrada do usuário Seleção dinâmica](https://servicenow-prod.fluidtopics.net/30umw08~RdpB4RaGHj4EIQ)**   
  Use o controle de entrada do usuário Seleção dinâmica em um tópico Virtual Agent para criar dinamicamente uma lista de seleções disponíveis para os usuários. Consulte uma tabela ou use um script para criar essas seleções dinamicamente.
* **[Controle de entrada do usuário Booliano](https://servicenow-prod.fluidtopics.net/8cStUGC_hZYzmQHKZ4RvIg)**   
  Use o controle de entrada do usuário Booliano em um tópico Virtual Agent para apresentar um aviso de Sim/Não ao usuário.
* **[Controle de Data e Hora de entrada do usuário](https://servicenow-prod.fluidtopics.net/eKzC2erM5pR1j7rL2S25RA)**   
  Use o controle de Data e Hora de entrada do usuário em um tópico Virtual Agent para permitir que o usuário selecione uma data do calendário, a hora (horas e minutos) ou ambos.
* **[Controle de entrada do utilizador do seletor de arquivos](https://servicenow-prod.fluidtopics.net/8teUOiKtIyR5ZGeUfY~vtg)**   
  Use o controle de entrada do utilizador do seletor de arquivos em um tópico Virtual Agent para solicitar que um usuário carregue uma imagem ou qualquer tipo de arquivo. Depois que o usuário carrega um arquivo de imagem, a imagem aparece imediatamente no cliente Virtual Agent.
* **va-carousel-input.html**   
* **[Controle de texto seguro de entrada do usuário](https://servicenow-prod.fluidtopics.net/eCZAudUTpXxNutcsskadzQ)**   
  O controle de texto seguro oferece um meio de criptografar informações confidenciais fornecidas como texto simples ou outros formatos. Use este controle para criptografar informações confidenciais em tópicos que usam a descoberta de grandes modelos de linguagem (LLM).