Adicione entidades NLU sem nó como variáveis de entrada a um tópico

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 4 min. de leitura
  • Você pode adicionar entidades de NLU sem nó como variáveis de entrada a um tópico se a NLU estiver habilitada para Virtual Agent. Essas variáveis podem ser preenchidas com slot a partir das previsões do provedor de serviços de NLU ou fornecidas fora do escopo do tópico.

    Antes de Iniciar

    Função necessária: virtual_agent_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Se um controle personalizado solicitar uma data a um usuário e o usuário mencionar uma data em seu enunciado inicial, você poderá capturar isso sem solicitar ao usuário novamente. Para avisar o usuário quando o slot não estiver preenchido, use os controles de entrada.

    Para obter mais informações sobre NLU entidades, consulte Entidades . Para obter mais informações sobre entidades do sistema, consulte NLU entidades do sistema.

    Procedimento

    1. Navegar até Tudo > Interfaces conversacionais > Virtual Agent > Designer.
    2. Abra um tópico e exiba o. Fluxo .
    3. Na barra lateral, selecione a guia Variáveis e selecione Entrada ícone .
    4. No formulário, preencha os campos.
      Tabela 1. Caixa de diálogo Adicionar variável de entrada
      Campo Descrição
      Tipos de Entrada Tipo de dados da entrada. Os campos na caixa de diálogo mudam de acordo com sua escolha.
      • Cadeia de caracteres : Texto alfanumérico. Mostra o. Formato de entrada campo. Escolha texto sem formatação ou uma regra em conformidade, dependendo do tipo de dados.
      • Verdadeiro/Falso : Valor booliano, sim ou não
      • Data e hora : Data, hora ou ambos. Mostra o. Formato de entrada campo.
      • Opção estática : Escolhas definidas do usuário. Mostra Nome de exibição e. Valor a ser armazenado pares de campos.
      • Escolha dinâmica : Escolha de registros de tabela. Mostra Preencha as opções por , Tabela e. Opções de filtro campos. O valor pode ser condicional ou com script.

      Para obter detalhes, consulte Tipos de dados de entrada em Virtual Agent tópicos.

      Nome Nome da variável da entidade.

      Os nomes de variáveis devem ser exclusivos no escopo de um tópico. O nome aparece como uma variável quando usado na marcação com pontos.

      Entidade de NLU A entidade NLU associada ao nó.

      Isso pode ser um pré-construído Virtual Agent A entidade que você importa para o modelo, uma entidade do sistema (como DURAÇÃO, TEMPO ou DINHEIRO) ou uma entidade personalizada que você criou.

      Propriedades do tipo de dados de cadeia de caracteres
      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 consiste em um prefixo de e-mail (nome de usuário), símbolo de e-mail e 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.
      • Formato de endereço da web
      • Personalizado: Script que fornece uma regra de validação de texto para um formato de texto personalizado e as mensagens de erro relacionadas exibidas quando o formato esperado não é inserido.
      Nota:
      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.
      Propriedades do tipo de dados de data e hora
      Formato de entrada Tipo de controle de Data e Hora a ser exibido. Selecione um dos seguintes formatos:
      • Data: mostra somente o calendário do mês para o usuário selecionar a data.
      • DataHora: mostra um calendário do mês e um seletor de hora.
      • Hora: mostra somente o seletor de hora para o usuário selecionar o horário (horas e minutos).
      Propriedades do tipo de dados de escolha estática
      Escolhas

      [Para tipo de dados de escolha estática]

      Insira duas ou mais opções da seguinte forma:
      • Nome de exibição : Frase curta ou texto que aparece para o usuário para essa opção.
      • Valor a ser armazenado : A cadeia de caracteres que é armazenada na variável quando a opção correspondente é selecionada.
      Propriedades do tipo de dados de escolha dinâmica
      Preencha as opções por Tipo de variável dinâmica a ser usada. Selecione uma das seguintes opções.
      • Registro: retorna registros da tabela selecionada. Os valores para estas opções são objetos GlideRecord.
      • Script: expressão que retorna uma matriz de opções.
      Tabela

      [Somente valores de registro]

      Se você selecionou Registro como método para preencher as opções, selecione a tabela a ser pesquisada.
      Opções de filtro

      [Somente valores de registro]

      Selecione uma das seguintes propriedades:
      • Construtor de condições: cria um filtro usado para selecionar um subconjunto de registros da tabela.
      • Script: define a lista de enumeração para a opções (lista de seleção) a serem exibidas. O par de valor do nome é armazenado como um objeto de cadeia de caracteres.
    5. Selecione Save (Salvar).

      As entidades de NLU aparecem ao lado das variáveis de entrada de tópico na barra lateral Variáveis.

      As entidades NLU aparecem com variáveis de entrada na barra lateral Variáveis. Um ícone de cópia aparece ao lado do ícone de exibição.

      Nota:

      Você pode remover um valor preenchido por slot para solicitar ao usuário novamente (desvincule-o do valor de entrada inicial). Para obter mais informações, leia sobre VaInputs.myvar.unbindEntity(); método em Virtual Agent scripts.