Publish a Virtual Agent topic

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:6分
  • Deploy an inactive topic or an updated topic to save it and make it available to users on Virtual Agent clients.

    始める前に

    注:
    An updated Assistant Designer Asset library user interface is available when you install Now Assist in Virtual Agent and turn on the Now Assist Topics skill. This content assumes that you have activated this skill and can see the list view. If this skill is not activated, you see the legacy UI and topics page. For more information, see Virtual Agent Designer legacy topics page.

    If you're using Natural Language Understanding (NLU) topic discovery, you can publish the model at the same time as the topic if the model meets publication criteria. Make sure that your model has passed through all phases of development and is ready to publish. If you haven’t refined, tested, and optimized your model, you may not be able to publish it in Virtual Agent Designer. For more information, see Model management.

    Role required: virtual_agent_admin or admin

    このタスクについて

    You can also publish topic blocks and custom controls to make them available for use in calling topics.

    手順

    1. Navigate to All > Conversational Interfaces > Virtual Agent > Designer.
      ヒント:
      If you need to work with NLU/keyword topics, select NLU/keyword from the discovery type toggle switch.
    2. In the Asset library, select the topic, topic block, or custom control to publish or republish.
    3. In the topic header bar, select Publish.

      Selecting Publish when there are issues present opens a Validation Issues tab next to the property sheet, which counts up and details all issues needing correction. These details include a hyperlink for each incomplete item. If the issue is in a node, selecting the hyperlink opens the property sheet for that node. As each issue is resolved, the list on the shelf updates to show the remaining errors. Once there are no issues to resolve, the publishing dialog box opens.

      Virtual Agent Designer canvas sidebar showing Validation Issues tab containing error message and hyperlink to node containing error.

      If you're using NLU topic discovery, the Choose what to publish dialog box appears. Select the available items to publish with the topic, such as the NLU model and language mappings, and then select Publish.

      注:
      If the Publish option is unavailable, the model may need some work. For example, the model may not have enough intents or may need more utterances for some intents. Fix these issues before proceeding. Also, if a model language is unavailable, the language-specific model has never been published. Publish it from the NLU Workbench. For more information, see Model management.

      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.

      For topics, the topic state is Active and the Published state changes to Published just now.

    4. Verify that your topics work as expected by opening them in a test conversation window in one of the following ways.
      オプション説明
      Topic properties tab
      • For NLU/keyword topics, select Test.
      • For LLM topics, select Test or open the drop-down menu and select Preview in Now Assist panel.
      LLM home page Under the Select assistant drop-down menu, choose the assistant associated with your topic, then select Test assistant.
      NLU/keyword home page Select Test active topics.
      注:
      For more information about testing Now Assist LLM topics, see Testing LLM topics. For NLU/keyword topics, enter keywords or NLU utterances that correspond to the topic intent. For the pre-built Virtual Agent topics, the bot returns a list of topics that match the entered keyword or utterance. See Testing NLU/Keyword topics for more information.

    タスクの結果

    The topic blocks and custom controls are published and are available for use in calling topics.

    注:
    Active topics, including setup topics and small talk topics, can also be available for use after the topics are published. For more information, see Control topic discovery and visibility.