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


---

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

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

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

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

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

Além de [controles de condição e cápsulas de dados](https://servicenow-prod.fluidtopics.net/XLB40FlvSx0Tcu9KBduDtA "R Virtual Agento tópico consiste em uma coleção de controles em um fluxo de tópicos. Use esses controles para coletar, processar e apresentar informações para seus 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 de outros controles no mesmo tópico usando o. `Valor `e. `ObteDisplayValue `métodos. O nome da variável é baseado no nome que você atribui ao controle de entrada. Por exemplo, se você atribuir o nome <kbd class="ph userinput">Primeiro prompt </kbd>para um controle de entrada, o nome da variável é `first_prompt `. O nome da variável é minúsculo, com um caractere de sublinhado em vez de um espaço. Para obter mais informações sobre esses métodos, consulte [Virtual Agent scripts](https://servicenow-prod.fluidtopics.net/oZ76O~3MLX~hHCun9yQX7A "Uso ServiceNow Virtual Agentvariáveis e métodos de script para escrever scripts de bate-papo, como scripts de resposta, gatilho e 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

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

Os seguintes controles de entrada do usuário são compatíveis em tópicos de LLM quando você cria um LLM Virtual Agenttópico. As entradas do usuário do LLM incluem o seguinte.

* [Coletor de entrada](https://servicenow-prod.fluidtopics.net/Cx8yDSHTJtBTUtULycbGpg "Use o controle Coletor de entrada para coletar dados para uso por Now AssistEm conversas que usam descoberta de tópicos de modelo de linguagem grande (LLM).")
* [Entrada de texto](https://servicenow-prod.fluidtopics.net/jz2ygZoGrQrKuCkUhBV4QA "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.")
* [Lista de seleção estática](https://servicenow-prod.fluidtopics.net/pvC5Ye2l_InZ5zMr1dAVmw "Use o controle de entrada do usuário Escolha estática em um Virtual Agenttópico para listar opções predefinidas disponíveis para o usuário. Você pode selecionar apenas um item de uma lista de seleção.")
* [Lista de seleção dinâmica](https://servicenow-prod.fluidtopics.net/IVIYw5zupO8uZ4~NGHF1zg "Use o controle de entrada do usuário de Escolha dinâmica em um Virtual Agentpara criar dinamicamente uma lista de opções disponíveis para seus usuários. Crie essas opções consultando uma tabela ou usando um script para criá-las dinamicamente.")
* [Entrada booliana](https://servicenow-prod.fluidtopics.net/JlqgAKvfGGkksjR6SySgKA "Use o controle booliano de entrada do usuário em um Virtual AgentTópico para apresentar um prompt Sim/Não ao usuário.")
* [Entrada de data e hora](https://servicenow-prod.fluidtopics.net/ecJd~0MFD~h97mjK7TvR_A "Use o controle de entrada do usuário de data e hora em um Virtual Agenttópico para permitir que o usuário selecione uma data, hora (horas e minutos) do calendário ou ambos.")
* [Entrada do carrossel](https://servicenow-prod.fluidtopics.net/cc9m0d5KgcWGu~BISvxhsQ "Use o controle de entrada do usuário do Carrossel em um Virtual Agenttópico para apresentar um prompt e uma série horizontal de imagens rotuladas. O usuário pode selecionar um único item no carrossel.")
{#va-user-inputs__ul_r2f_4y3_jcc}  
Nota:  
Evite colocar mais de cinco controles de entrada do usuário em um único tópico de LLM ou mais de cinco em um único coletor de entrada. Controles excessivos de entrada do usuário podem sobrecarregar o LLM e levar a respostas imprecisas ou inesperadas.

## Compreensão da linguagem natural( NLU) propriedades da entidade {#va-user-inputs__id_kxn_knb_vcc}

:   Se NLUestá habilitado, as seguintes propriedades são exibidas na folha de propriedades do Texto , Opção estática , Escolha dinâmica , Booliano , Data e hora e. Carrossel controles de entrada. Para exibir ou habilitar essas propriedades, vá para a seção Opções avançadas.

    * Entidade de NLU : A entidade que corresponde à variável de entrada do controle. Você seleciona a entidade na lista de entidades associadas à intenção do tópico, conforme definido em NLUmodelo que você está usando para o tópico. Quando Virtual Agentreconhece o valor da entidade nos enunciados do usuário e, se o valor atender ao limite de confiança de previsão de entidade, então Virtual Agentextrai o valor. O valor é armazenado na variável de entrada do nó. Esta ação de armazenamento é chamada preenchimento de slot . O preenchimento de slot reconhece quando vários valores para o mesmo NLUa entidade ocorre em uma conversa. Os usuários recebem uma lista para confirmar qual valor de nó selecionar quando vários nós estão vinculados ao mesmo NLUentidade. Esta propriedade está disponível somente para NLUdescoberta de tópicos.  
      Figura 2. NLU propriedade da entidade ![Deslize o botão de alternância Entidade de NLU para selecionar um tópico de NLU quando a descoberta de tópico estiver habilitada.]()
    * Habilite a NLU para alternar tópicos : Habilita NLUprevisão para o nó. Se habilitado, os usuários poderão inserir texto para responder a perguntas, independentemente do tipo de controle de entrada que está sendo usado. Virtual Agentusa 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. Habilitar NLUpara alternar a propriedade de tópicos ![Em Opções avançadas - alternância de tópico, deslize a propriedade Habilitar NLU para alternar tópicos para alternar tópicos.]()
    {#va-user-inputs__ul_h3d_jwn_thb}

Valor padrão
:   Um prompt de entrada pode ter um valor predefinido que você define. 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 pedem que os usuários confirmem sua resposta. Esta propriedade está na seção Opções avançadas.
:
    Figura 5. Propriedades das mensagens de confirmação
* **[Controle de entrada do usuário do coletor de entrada](https://servicenow-prod.fluidtopics.net/Cx8yDSHTJtBTUtULycbGpg)**   
  Use o controle Coletor de entrada para coletar dados para uso por Now AssistEm conversas que usam descoberta de tópicos de modelo de linguagem grande (LLM).
* **[Controle de entrada do usuário de texto](https://servicenow-prod.fluidtopics.net/jz2ygZoGrQrKuCkUhBV4QA)**   
  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.
* **[Escolha estática do controle de entrada do usuário](https://servicenow-prod.fluidtopics.net/pvC5Ye2l_InZ5zMr1dAVmw)**   
  Use o controle de entrada do usuário Escolha estática em um Virtual Agenttópico para listar opções predefinidas disponíveis para o usuário. Você pode selecionar apenas um item de uma lista de seleção.
* **[Escolha agrupada do controle de entrada do usuário](https://servicenow-prod.fluidtopics.net/FzaUqMgaCsxkhxBsTMTDDw)**   
  Use o controle de entrada do usuário de opção agrupada em um Virtual Agenttópico para listar vários grupos de opções em uma mensagem.
* **[Escolha dinâmica de entrada do usuário](https://servicenow-prod.fluidtopics.net/IVIYw5zupO8uZ4~NGHF1zg)**   
  Use o controle de entrada do usuário de Escolha dinâmica em um Virtual Agentpara criar dinamicamente uma lista de opções disponíveis para seus usuários. Crie essas opções consultando uma tabela ou usando um script para criá-las dinamicamente.
* **[Controle de entrada do usuário booliano](https://servicenow-prod.fluidtopics.net/JlqgAKvfGGkksjR6SySgKA)**   
  Use o controle booliano de entrada do usuário em um Virtual AgentTópico para apresentar um prompt Sim/Não ao usuário.
* **[Controle de entrada do usuário de data e hora](https://servicenow-prod.fluidtopics.net/ecJd~0MFD~h97mjK7TvR_A)**   
  Use o controle de entrada do usuário de data e hora em um Virtual Agenttópico para permitir que o usuário selecione uma data, hora (horas e minutos) do calendário ou ambos.
* **[Controle de entrada do usuário do Seletor de arquivos](https://servicenow-prod.fluidtopics.net/QlhMVVRzeUWcPUmXFJIZow)**   
  Use o controle de entrada do usuário do Seletor de arquivos em um Virtual Agenttópico 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 em Virtual Agentcliente.
* **[Controle de entrada do usuário do carrossel](https://servicenow-prod.fluidtopics.net/cc9m0d5KgcWGu~BISvxhsQ)**   
  Use o controle de entrada do usuário do Carrossel em um Virtual Agenttópico para apresentar um prompt e uma série horizontal de imagens rotuladas. O usuário pode selecionar um único item no carrossel.
* **[Texto seguro controle de entrada do usuário](https://servicenow-prod.fluidtopics.net/bZ9eiemN5j6yj1jn3WJb3A)**   
  O controle Texto seguro fornece 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 descoberta de modelo de linguagem grande (LLM).