Migrate NLU topics to LLM topics
Migrate one or more of your existing Natural Language Understanding (NLU) or keyword topics into new large language model (LLM) topics while maintaining your original NLU/keyword topics. After migration is complete, choose whether to publish your new LLM topics.
Before you begin
Role required: virtual_agent_admin or sn_vad_genai.topic_migration_admin
Procedure
-
Select Migrate Topics to LLM.
The Topic Migration workflow page opens in a new browser tab.
-
Review and determine which NLU and keyword topics you want to migrate into LLM topics on the Select topics page.
Tip:Select the link in the Name column to review the topic in the Virtual Agent Designer canvas in a new browser tab. Migrate fewer than 50 topics at one time to allow yourself enough time to review the topics.
-
Review the affected topic blocks, and then select Next on the Review topic blocks page.
Only topic blocks and topic blocks associated with the selected topics are displayed in this list. Topic blocks used in dynamic topic blocks must be manually selected for migration. You can select the link in the Topic Block column to view the topic block in the Virtual Agent Designer canvas in a new browser tab.
Note:If no topic blocks were selected or associated with the selected topics, select Next to continue. -
Choose which settings to apply to all topics migrating to LLM, and then select Next on the Settings page.
Table 1. Settings field description Field Description Select assistant(s) for migrated topics Migrated LLM topics are associated with these assistants. Choose how migrated topics are named Newly migrated topics include the value entered in the Add to internal topic name field as either a prefix or suffix (default). This option only affects the migrated topics' Internal name value and not the topics' Display name value. The original NLU topic name is used as the Display name to customers interacting with LLM topics in Virtual Agent. Keep current topic descriptions? Current topic descriptions are used as the LLM topic descriptions rather than using generative AI to create topic descriptions for migrated LLM topics. This field is turned off by default. If this field is turned on, and there was no topic description in the original NLU topic, a topic description must be manually added to the new LLM topic before publication. -
Review the topics for migration on the Migrate topics page, and then select Next to begin migration.
Note:Leave the browser window open until the migration process is complete.
Figure 1. Example of an in-progress topic migration Figure 2. Example of a completed topic migration The migration complete progression bar appears and displays a dynamic percentage of completeness. During migration, the Migration status column updates dynamically with the values changing from Not started to either Failed or Complete. After migration is complete, you can choose to select Review migration log or Next. Selecting Review migration log downloads a .CSV file of the Topic Migration Execution Items [topic_migration_execution_item.list] table data. For more information on this table data, see NLU to LLM migration log. Selecting Next directs you to the Publish (optional) page. - Optional:
Select each LLM Topic check box that you want to publish, and then select Publish topics.
You receive a Selected topics were successfully published output message. The topics that you migrated, but didn't select to publish, continue to appear on this page until you navigate away from the topic migration workflow.
What to do next
After you navigate away from the topic migration workflow, the topics that you migrated, but didn’t publish, can be managed and published from the Virtual Agent Designer canvas. If you choose to migrate other topics in the future, the topic migration workflow restarts from the beginning.