Microsoft Power Virtual Agents のトピックを呼び出す 仮想エージェント ボットインターコネクトシェルトピックを作成する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：3分

    • Power Virtual Agents のセカンダリボットのトピックにアクセスするには、少なくとも 1 つの 仮想エージェント ボットインターコネクト トピックを作成する必要があります。

    始める前に

    Microsoft Power Virtual Agents で 1 つ以上のトピックを作成します。

    仮想エージェント ボットインターコネクト インスタンスに Direct Line 秘密鍵を追加する。

    必要なロール：virtual_agent_admin または admin

    このタスクについて

    Microsoft Power Virtual Agents のトピックを ボットインターコネクト と統合する方法は 2 つあります。
    • Power Virtual Agents のトピックごとに 1 つの 仮想エージェント ボットインターコネクト トピックを作成する。

      この NLU トピックのケースでは、仮想エージェントのトピックそれぞれが 1 つの Power Virtual Agents のトピックと同じ名前です。たとえば、「ドリンクを注文する」と「チケットを予約する」という 2 つの Power Virtual Agents のトピックがある場合は、「ドリンクを注文する」と「チケットを予約する」という 2 つの 仮想エージェント トピックを作成することになります。

      この LLM トピックのケースでは、ボットインターコネクト のトピックそれぞれが、対応する Power Virtual Agents のトピックと同じ名前と説明を持っています。

    • Power Virtual Agents の複数のトピックを単一の 仮想エージェント ボットインターコネクト トピックにマッピングします。このシナリオは、NLU トピックにのみ適用されます。

      Power Virtual Agents のトピック用に 1 つの 仮想エージェント トピックを作成し、それに応じて名前を付けます。「PVA の注文の問題」などです。このシナリオでは、トピックディスカバリーの方法に応じて、Power Virtual Agents のトピックがキーワードまたは発言としてトピックにマッピングされます。そのため、「注文する」と 「チケットを予約する」という 2 つの Power Virtual Agents のトピックがある場合は、両方のフレーズをキーワードとしてトピックに追加するか、トピックの対応するインテントに発言として追加します。

    手順

    1. 移動先 すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
    2. Power Virtual Agents のトピック用にトピックを作成します。
      NLU トピックの場合、対応するServiceNow 仮想エージェントインテントに、キーワードまたは発言として Power Virtual Agents のトピックの名前を含めます。LLM トピックの場合、ボットインターコネクト トピックのトピック名と説明は、Power Virtual Agents トピックのトピック名と説明と一致する必要があります。
    3. [フロー] タブで、トピックブロックユーティリティノードをキャンバスにドラッグします。
    4. ノードを選択して、次のようにフォームに入力します。
      表 : 1. [トピックブロックのプロパティ] フォーム
      プロパティ 説明
      トピックブロック NLU トピックの場合は [ボットインターコネクト] トピックブロックを選択し、LLM トピックの場合は [Bot Interconnect - LLM] トピックブロックを選択します。
      アクション名 次のように入力します：sn_va_bot_ic.direct_line_bot_interconnect_integration_handler
      アクションタイプ subflow と入力します。
      追加のパラメーター (文字列) 次の手順を実行します。
      1. [スクリプト] アイコン [スクリプト] アイコンを選択します。
      2. [追加のパラメーター (文字列)] ウィンドウで、次のコードを追加します。
        (function execute() {
    return JSON.stringify({'quick': false});
})()
      3. [Save (保存)] を選択します。
    5. [Save (保存)] を選択します。
    6. [Publish (公開)] を選択します。

    次のタスク

    構成をテストします。ボットインターコネクト が展開されているチャネルから、セカンダリボットで利用可能なトピックを実行できます。

    注:
    Power Virtual Agents では会話は常に開いたままになります。