Creating a Virtual Agent topic

task brazil Updated Sep 10, 2026 5 min read create-virtual-agent-topic.md
Raw file servicenow.com

Use the Assistant Designer Asset library to create and modify Virtual Agent topics (conversations). Build your topic to meet a specific objective or goal, such as fulfilling a user's request or helping a user complete a task.

Before you begin

[Omitted video] Description: Assistant Designer LLM topic authoring video

Do the following:

Role required: virtual_agent_admin or admin

About this task

The topic is in the Inactive state until you publish it. Publishing a topic changes the topic state to Active and automatically deploys the topic to your Virtual Agent clients.

Procedure

  1. Navigate to All > Conversational Interfaces > Assistant Designer.

  2. Select the Asset library tab.

  3. Set the topic discovery toggle switch to LLM.

  4. Select Create asset.

    [Omitted image "vad-home-2.png"] Alt text: Asset library page.

  5. From the Create asset window, select Topic.

    Important: Selecting any of the other topics in the window will open the create flow in the respective application.

    [Omitted image "create-asset-2.png"] Alt text: List of assets, select topic to create a topic.

  6. On the form, fill in the fields.

    For a description of the field values, see Create a topic form.

  7. After filling the topic creation form, select Create.

  8. On the Flow tab, build the conversation flow.

Flow steps

Description

Add controls

To create the topic flow:

  1. Select the controls for user inputs, bot responses, or utilities from the palette and drop them onto the canvas.

When you add a control to the canvas, it becomes a node in the conversation flow.

  1. For each node, complete the corresponding property sheet. In the topic header bar, select Save. The topic header bar displays a Saving in progress... message. The toast message Successfully saved your topic appears in the lower-right corner afterward for 4 seconds, and can be closed by selecting the X in the message.

For details about each control and the corresponding properties that you define, see User inputs, Bot responses, and Utilities.

As you add controls, watch for a yellow warning badge or a red error badge in the corner of the control. The number on the badge indicates the number of issues in that control, such as missing mandatory information in the property sheet. (Highlighting a badge or the "Incomplete" banner at the top of the property sheet details the items in need of correction.)

Move a node

Select the node, drag it to the new location in the flow, and Select Save.

Delete a node

Select the X in the upper right corner of the node. In the topic header bar, select Save. The topic header bar displays a Saving in progress... message. The toast message Successfully saved your topic appears in the lower-right corner afterward for 4 seconds, and can be closed by selecting the X in the message.

Note: You can't delete a node that has a script variable used by subsequent JavaScript expressions in the flow. Also, you can delete a decision node only when it has a single branch.

9. Select **Test** in the header bar to test your topic in a chat window.
You can review test results in the adjoining tabs. For detailed information, see [Testing LLM topics](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/test-llm-topics.md).

If the ServiceNow Otto panel, Microsoft Teams application, or Slack application is configured for your environment, preview options for those channels are displayed in the Test button list. Select **Preview in Otto panel** or **Preview in Microsoft Teams** in the list to test your topic in those environments. For more information, see [Integrating Virtual Agent with messaging apps](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/va-integration-messaging-apps.md).
  1. When you're finished with the topic, select Save in the topic header bar.

    The topic is in the Inactive state until you publish it.

    The topic header bar displays a Saving in progress... message. The toast message Successfully saved your topic appears in the lower-right corner afterward for four seconds, and can be closed by selecting the X in the message.

What to do next

Publish the topic to deploy the topic to your Virtual Agent clients. The topic state changes to Active.

If you created a topic that might be frequently used in certain contexts (environments), consider promoting the topic as part of the default or custom chat experience.

Parent Topic:Build conversations in the Asset library in Assistant Designer

Keywords CreateVirtual AgenttopictopicdesignerconversationsLLMLarge language model
Search documentation
Search document titles and file paths on the brazil branch