jsn / ServiceNow, simplified.
AustraliaREFERENCE GUIDE

Create a Virtual Agent Bot Interconnect shell topic to call Microsoft Power Virtual Agents topics

On this page

Create a Virtual Agent Bot Interconnect shell topic to call Microsoft Power Virtual Agents topics

To access topics in the Power Virtual Agents secondary bot, you must create at least one Virtual Agent Bot Interconnect topic.

Before you begin

Create one or more topics in Microsoft Power Virtual Agents.

Add the Direct Line secret key to your Virtual Agent Bot Interconnect instance.

Role required: virtual_agent_admin or admin

About this task

There are two ways to integrate Microsoft Power Virtual Agents topics with Bot Interconnect:

  • Create one Virtual Agent Bot Interconnect topic per Power Virtual Agents topic.

    For NLU/Keyword topics, each Virtual Agent topic is named the same a single Power Virtual Agents topic. For example, you have two Power Virtual Agents topics, order a drink and book a ticket. Create two Virtual Agent topics with the same names.

    For LLM topics, each Bot Interconnect topic has the same name and description as the corresponding Power Virtual Agents topic.

  • For NLU/Keyword topics, pap multiple Power Virtual Agents topics to a single Virtual Agent Bot Interconnect topic.

    Create one Virtual Agent topic for your Power Virtual Agents topics and name it accordingly. For example, PVA ordering issues. The Power Virtual Agents topics map to the topic as keywords or utterances, depending on topic discovery. For example, if you have two Power Virtual Agents topics, order a drink and book a ticket, add both phrases to the topic as keywords or as utterances to the topic's corresponding intent.

Procedure

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

  2. Select the Asset library tab.

  3. Set the topic discovery toggle switch to LLM or NLU/Keyword, depending on which type you want to create.

  4. Create a topic for your Power Virtual Agents topics.

    In case of NLU topics, include the Power Virtual Agents topic names as either keywords or utterances in the corresponding ServiceNow Virtual Agent intent. In case of LLM topics, the topic name and description of the Bot Interconnect topic should match the topic name and description of the Power Virtual Agents topic.

  5. On the Flow tab, drag a Topic Block utility node onto the canvas.

  6. Select the node, and then fill in the form as follows:

<table id=“table_oq1_5px_ksb”><thead><tr><th>

Property

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Topic Block

</td><td>

Select Bot Interconnect topic block for NLU topics and Bot Interconnect - LLM topic block for LLM topics.

</td></tr><tr><td>

Action Name

</td><td>

Enter: sn_va_bot_ic.direct_line_bot_interconnect_integration_handler

</td></tr><tr><td>

Action Type

</td><td>

Enter subflow.

</td></tr><tr><td>

Additional Params (String)

</td><td>

Follow these steps:1. Select the script icon [Omitted image “icon-script.png”] Alt text: Script icon.. 2. In the Additional Params (String) window, add this code:

```

(function execute() { return JSON.stringify({‘quick’: false}); })() “‘

  1. Select Save.

</td></tr></tbody> </table>7. Select Save.

  1. Select Publish.

What to do next

Test your configuration. You can execute the topics that are available in the secondary bot from channels where Bot Interconnect is deployed.

Note: Conversations always remain open in Power Virtual Agents.

Parent Topic:Using Microsoft Power Virtual Agents as a secondary bot with Virtual Agent Bot Interconnect

Previous topic:Add the Direct Line secret key to your Virtual Agent Bot Interconnect instance

Next topic:Using ServiceNow Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect

Keep exploring.

Find another answer, or bring this documentation into your own tools.