Create the topic in Virtual Agent Designer using topic blocks that come with the ITSM Virtual Agent Conversations plugin. When the user receives a notification that it's time to upgrade, they will be directed to this topic.

Before you begin

Install the following applications:
  • Glide Virtual Agent plugin (com.glide.cs.chatbot)

    You must have a subscription for Virtual Agent before you can activate the Glide Virtual Agent plugin.

  • Enable Natural Language Understanding (NLU), if not already enabled (recommended).
  • ITSM Virtual Agent Conversations (available in the ServiceNow® Store)

    If this application is already installed, check the ServiceNow Store for an updated version before you begin.

Determine the application scope for your Virtual Agent topic and actionable notification. They don't have to reside in the same application scope, but it can be easier to maintain if they do.

Publish the following ITSM Virtual Agent components. If you're using an application scope other than ITSM Virtual Agent Conversations, you should duplicate and publish these topic blocks in the scope you intend to use. To do this, change your application scope, and then duplicate the topic blocks in Virtual Agent Designer.
  • Create Incident topic block
  • Request Catalog Item topic block
  • AI Search topic block
  • Search Catalog Item topic block

Role required: virtual_agent_admin or admin

About this task

For more information about building topics and the Virtual Agent Designer interface, see the following topics:
Tip: Look through existing conversations to ensure you are not duplicating effort, and familiarize yourself with Virtual Agent and the flow of topics. Additionally, it may be helpful to outline the flow of a conversation before building it in Virtual Agent Designer.

Procedure

  1. Navigate to All > Conversational Interfaces > Virtual Agent > Designer.
  2. On the Topics page, select Create.
    Virtual Agent Designer +Create tile on the landing page.
  3. On the Create a topic form, set up your topic.
    1. Enter a name, such as Asset Refresh.
    2. If NLU is enabled, select an existing model, or create a new one.
    3. Select or create an intent for the NLU model.
      In the Associated Intent field, select an existing intent or create a new one for your topic.

      For descriptions of all field values, see Create a topic form.

    4. Select Create.
    The Flow tab appears with Start and End nodes. For an overview of this screen and its components, see Topic Flow tab.
  4. Create your initial message to greet the user.
    1. From the Components area, drag a Text bot response node onto the canvas.
    2. Select the node to view the properties palette.
    3. Enter a name for the node and the response you want to display to the user.
      Enter a unique node name, such as Initial Message. Include a response, such as "You're eligible to upgrade!"
  5. Ask the user if they want to proceed with the asset refresh.
    1. From the Components area, drag a Static choice input node onto the canvas.
    2. In the properties palette, enter the following information:
      • A unique name, such as Continue or Defer.
      • A text prompt, such as What would you like to do next? Learn more, or continue with the upgrade?
      • In the Choices area, provide a text prompt for each choice and a value for that choice, so you can refer to it later on.

        For example, your choices might be Learn more and Continue with upgrade. The values should make sense as variable names. For example, info and upgrade.

    Static choice properties for "Continue or Defer" node. It includes a user prompt and two choices: Learn more or Continue with upgrade.
  6. Add a Decision utility to handle the user's choice.
    1. From the Components area, drag a Decision utility onto the canvas.
    2. Select the plus icon to add a second branch.
    3. Name each branch to correspond with the decisions (info and upgrade).
      This Decision utility has two branches: info and upgrade. They are based on the choices offered to the user in the previous step.
    4. For each branch, select it and then use the Branch Condition area to indicate which option the branch will follow.
      Use the condition builder to specify the Continue or Defer choice node and the corresponding user choice that this branch will follow, such as "Continue with upgrade."
  7. For the upgrade branch, add a Lookup utility node to confirm that the user still has the asset.
    1. From the Components area, drag a Lookup utility onto the canvas.
      Drag the Lookup utility node onto the upgrade path on the canvas.
    2. In the properties palette, specify the following information:
      • A unique name, such as Asset Lookup.
      • The table name: Asset [alm_asset]
      • In the Condition builder, select Assigned to, and then dot-walk to Input Variables > User. Select and to include State > is > In maintenance.

        The asset state will tie into the notification you send the user for this asset refresh.

        Filter assets in the Assign Condition builder using Assigned to is the current user, and the State is In maintenance.

  8. Ask the user if they still have the asset.
    1. From the Components area, drag a Boolean input node onto the canvas.
      The Boolean node automatically asks if you want to add a Decision utility with two paths. Select Yes. A Decision node appears in the flow with values of true and false. Both are already mapped to the Boolean node.
    2. Add a user prompt.
      Use dot-walking to refer to the asset found by the Asset Lookup node.

      Write a prompt, such as "Do you still have this device?" Then dot-walk to Input Variables > Asset Lookup > Display name.

  9. If the user still has the asset (the Boolean response is true), we want to search for it in the catalog.
    1. From the Components area, drag the Topic Block utility onto the Asset Check true branch on the canvas.
    2. In the properties palette, select Search Catalog Item for the Topic block.
    3. Under Input mapping, use dot-walking to specify the query_term parameter from the Asset Lookup node (Input Variables > Asset Lookup > Display name).
    The catalog search will provide these output variables by default, shown under Output mapping.

    Output mapping variables for Search Catalog Item are the catalog_item_id, item_type, and is_conversational.

  10. Request the upgraded item.
    1. From the Components area, drag the Topic Block utility onto the canvas beneath the Search Catalog Item topic block.
    2. In the properties palette, select Request Catalog Item for the Topic block.
    3. In the Input mapping area, use dot-walking to specify the catalog_item_id that the previous topic block returned.
      For the catalog_item_id field, select the dot-walking icon and choose Input Variables > Catalog_item_id.
    This topic block returns output variables as well. The user will be able to select variables for their new device, as well. You can configure these variables in Service Catalog.
  11. Ask the user to confirm their choice of device.
    1. From the Components area, drag the Card bot response node onto the canvas beneath the Request Catalog Item topic block.
    2. In the properties palette, specify the following information:
      • A unique name, such as Device Request Record.
      • Card type: Record
      • Populate this card by referencing: Table
      • Table name: Requested Item [sc_req_item]
      • In the Condition builder, add Sys ID is Input Variables>Record_id.

        In the Assign Condition builder, select Sys ID, then is. For the third field, dot-walk to Input Variables > Record_id.

      • In the fields area, select the record columns to display in the card to the user.

        For example, specify Number, Short description, and Estimated delivery.

  12. Drag this flow's arrow to the End node to complete this part of the workflow.
    Drag the flow arrow that follows the Device Request Record node to the End node. This signals the end of the topic for this particular flow.
  13. Select Save.

What to do next

Create the Open Incident workflow in the Asset Refresh topic