Promote or demote LLM topics in Virtual Agent Designer

  • Release version: Xanadu
  • Updated November 12, 2024
  • 1 minute to read
  • Promote topics in Virtual Agent Designer, after associating them with a large language model (LLM) assistant, to have them suggested to the user by the LLM assistant.

    Before you begin

    Associate an LLM topic, conversational subflow, or conversational action with an LLM assistant. For more information, see Create a Virtual Agent topic, Managing conversational subflows in Virtual Agent Designer, and Managing conversational actions in Virtual Agent Designer.

    Role required: virtual_agent_admin or admin

    About this task

    After you associate a conversational subflow, conversational action, or topic with an LLM assistant, you can promote the topic so that the LLM assistant suggests it to the users. Promoted assets can also be demoted to remove them from the list of suggested assets.

    System topics, setup topics, topic blocks, custom controls, and small talk topics cannot be promoted.

    Note:
    You can also promote NLU/keyword topics by creating topic recommendations in Conversational Interfaces settings. For more information, see Using Virtual Agent Topic Recommendations.
    Figure 1. Promotion and demotion controls for LLM topics

    You can check the asset's Promoted status under the Show actions for this row icon KB link. The Promoted status shows a check mark when the topic is promoted.

    For more information, see Create a Virtual Agent topic and LLM assistants.

    Procedure

    1. Navigate to All > Virtual Agent > Designer.
    2. From the Select assistant drop-down menu, select the LLM assistant that will promote the topic.
      The list of topics reduces to LLM topics that are associated with the LLM assistant.
    3. Find the asset that you want to promote or demote.
    4. Select the more actions for this row icon KB link, and then select Promote to toggle the asset's Promoted status.
      If the asset is already promoted, the asset has a check mark next to the Promoted status. Demoting the asset removes the check mark.

    Result

    Figure 2. Promoted topics displayed in Virtual Agent chat
    Virtual Agent chat window showing a list of promoted topics.
    The topic is added to the list of topics promoted by the LLM Assistant, while a demoted topic is removed from the list.

    A toast message also appears for 4 seconds, confirming the topic has been promoted or demoted. You can close the message by selecting the Close icon Close icon..

    What to do next

    Reorder promoted LLM topics in Virtual Agent