\(Legacy\) Create a topic form

reference australia Updated Sep 10, 2026 6 min read vad-topic-creation-form-nlu.md
Raw file servicenow.com

The Create a topic form is used to set the properties for a new conversational topic for Virtual Agent.

The Create a topic form layout is similar to the Edit topic properties form layout found in the Topic Properties tab. When you finish creating a topic using this form, the model type and topic types are locked in the Properties tab.

[Omitted image "vad-create-topic-form-nlu.png"] Alt text:

Field

Description

Application scope

Select the application scope where the topic becomes available.Note: The application scope cannot be changed once the topic is created.

Model Type

Select NLU/Keywords for either keyword or NLU discovery.

Note: This field is visible only if you installed Now Assist in Virtual Agent.

Type

List of assets that you can create. Select Topic.

Internal name

Internal name for topics, small talk topics, and setup topics that reflects its business purpose. Internal name displays on the Virtual Agent Designer Topics page and must be unique across the platform.

Display name

Topic name that displays to users when they interact with Virtual Agent. Display name must be unique for either NLU/Keywords or LLM model type.

Topic description

Brief explanation of the topic purpose and functionality.If you use single quotes (‘ ’) in your description, do the following to avoid problems with your conversation:

  1. Navigate to All, then enter sys_properties.list in the filter.
  2. Search for and select glide.ui.escape_all_script, then set its value to True.

NLU Model

Natural Language Understanding model to be mapped to the topic. The model contains the user utterances that are associated with the trained intents and entities. This combination enables your bot to understand what a user says. Do one of the following:

  • Choose an existing model.

  • Select Create Model to create a new model group.

    1. In the Model Name field, enter a name for the new model group.
    2. In the Intent name field, accept the default value or enter a name for the new intent. Note: New models are created in Draft state.

Tip: To see how and where the NLU model is used, navigate to NLU Workbench > Models, and sort the Created for column.

Associated Intent

The intent, when recognized by Virtual Agent, that launches this topic. If you specified or created a model, the intent is required. Do one of the following:

  • Choose an existing intent.
  • Select Create intent to create a new intent.

In the Intent Name field, accept the default value or enter a name for the new intent.

Note: This option is not available for read-only models.

Enable DialogActs

Toggle switch (active by default in new topics) to enable Virtual Agent to detect when you modify utterances or applies updates in an NLU model, and dynamically reacts to unexpected utterances and modifications. Toggle to the off position to prevent users from using the keyboard instead of the options available in the topic. For more information, see (Legacy) Dialog Acts for Virtual Agent.Note: This toggle is decoupled from the topic switching option found in all User Inputs aside from Grouped Choice and File Picker. It's available for all topic types aside from a Topic Block. This feature is currently available only for English.

Confirm modified values with users

Toggle switch to enable Virtual Agent to send a confirmation message to the user when the Virtual Agent detects a value change. This value is Active by default.Note: This toggle appears when Enable DialogActs is activated.

Advanced properties (optional)

Who can access this topic

System Roles

Roles that a user must have to view and run the topic. If a topic is public (available to users, including guest users, who aren't authenticated in the ServiceNow platform), select only the Public role.

Channels

Chat clients in which the topic or topic block will run.

These channels are different from the default channels that are natively supported by Virtual Agent. Your instance may have additional channels for custom chat integrations created for it. For more information about channels, see Deploying Virtual Agent topics in other channels.

Context

Expression logic to specify a condition for presenting this topic to users. The condition must evaluate to true. You can set this field using either the condition builder or a script.

  • Condition: Use the condition builder to add or edit conditions.
  • Script: Use the script editor to create or edit a script that contains a condition statement.

Live agent

Live agent context variables

Live agent context variables that are defined in the General Chat Settings.Select the variables that provide dynamic context, which means information from the Virtual Agent chat. This information is transferred from the bot conversation to the live agent.

For information about the default list of live agent variables, see Live agent chat context variables.

Available for Agent Autopilot

Toggle switch that determines whether the topic is available to a live agent.When enabled, an agent can search for and invoke the topic. For details, see Conversation Autopilot.

Additional

Resume flow after topic switching

Toggle switch that lets the user return to the original conversation after changing topics during a conversation.

Not applicable to Small Talk topics.

Categories

Label used to identify and group-related topics, topic blocks, or custom controls.

Keywords

List of key phrases or terms that users enter to initiate the conversation with the Virtual Agent. Press Enter after each phrase. Keywords are also used for languages that are currently not available in NLU.

**Parent Topic:**[\(Legacy\) Virtual Agent Designer interface reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/vad-reference-nlu.md)
Search documentation
Search document titles and file paths on the australia branch