再利用可能なトピックブロックの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:6分
  • 仮想エージェント 会話でタスクと会話要素の特定のサブフローを実行する、再利用可能なコンポーネントをビルドします。

    始める前に

    ヒント:
    開発者とトピック作成者が、他のアプリケーションスコープで作成されたトピックブロックへのアクセスを必要とする場合があります。アクセス権を付与するには、「トピックブロックとカスタムコントロールのクロススコープアクセス特権の作成」を参照してください。

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

    このタスクについて

    トピックブロックを使用して、特定のレコードの取得などの一般的な手順を実行します。

    手順

    1. 移動先 すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
    2. [トピック] ページで、次のいずれかの操作を行います。
      • トピックブロックを最初から作成するには、[+ 作成] を選択します。
      • ビルド済みのトピックブロックに基づいてトピックブロックを作成するには、そのトピックブロックを開いて、次の操作を行います。
        1. ヘッダーバーで [複製] を選択します。
        2. 新しいブロックの名前を入力し、[保存] を選択します。
    3. シートのフィールドに入力します。
      表 : 1. [トピックブロックのプロパティ] シート
      フィールド 説明
      タイプ

      仮想エージェントデザイナーで作成できるアイテムのリスト。

      [トピックブロック] を選択し、追加のプロパティを定義します。
      注:
      このトピックをトピックブロックとして設定すると、それを通常のトピックに変更することはできません。
      名前 機能上の目的を反映したトピックブロックの一意の名前です。この名前はトピックブロックのリストに表示され、トピック作成者がトピックを作成または更新するときにそこから選択できます。
      説明 トピックブロックの目的の簡単な説明。たとえば「レコードの取得」などです。
      高度なプロパティ (オプション)
      このトピックにアクセスできるユーザー
      チャネル

      トピックまたはトピックブロックが実行されるチャットクライアント。

      これらのチャネルは、仮想エージェントでネイティブにサポートされているデフォルトのチャネルとは異なります。インスタンスには、カスタムチャット統合用に作成された追加のチャネルがある場合があります。チャネルの詳細については、「他のチャネルへの仮想エージェントトピックの展開」を参照してください。

      ライブエージェント
      ライブエージェントのコンテキスト変数 [一般的なチャット設定] で定義されているライブエージェントコンテキスト変数。

      動的コンテキスト (仮想エージェントチャットからの情報) を提供する変数を選択します。この情報は、ボットの会話からライブエージェントに転送されます。

      ライブエージェント変数のデフォルトリストの詳細については、「ライブエージェントチャットのコンテキスト変数」を参照してください。

      エージェントオートパイロットで利用可能 トピックブロックをライブエージェントで利用できるかどうかを決定する切り替えスイッチ。

      有効にすると、エージェントはトピックを検索して呼び出すことができます。詳細については、「対話オートパイロット」を参照してください。

      パレットで利用可能
      有効化 トピックブロックを [フロー] タブのパレットの [ユーティリティ] セクションに独自のアイコンとして表示するかどうかを決定する切り替えスイッチ。これにより、他の作成者がトピックブロックに簡単にアクセスできるようになります。
      追加
      カテゴリ このブロックを含むカテゴリ。トピックブロックのカスタムトピックカテゴリを定義できます。
    4. [作成] を選択します。
      [フロー] タブが開きます。キャンバスには、[開始] ノードと [終了] ノードを持つフローが表示されます。
    5. ブロックへの入力を定義するには、次のようにします。
      1. キャンバスで [開始] ノードを選択します。
      2. [開始セグメントプロパティ] シートで、[+ 追加] を選択します。
      3. シートのフィールドに入力します。
        表 : 2. [入力を追加] ダイアログボックス
        フィールド 説明
        名前 入力値を保存する入力変数の名前。
        タイプ トピックブロックに渡されるデータのタイプ。たとえば、[文字列 (String)][ブーリアン (Boolean)] など。

        フィールドは選択した内容に応じて変わります。詳細については、「仮想エージェント トピックの入力データタイプ」を参照してください。

        必須 必要に応じてパラメーターを設定するオプション。
        ヒント 呼び出しトピックを作成するときに表示されるツールヒント。次の例を参照してください。

        この例の入力変数マッピングのツールヒントに表示されている [テストヒント文字列 (Test Hint String)]

        テーブル ServiceNow入力のクエリに使用されるテーブル。

        このフィールドは、[タイプ (Type)] フィールドから [Reference] または [Array.Reference] が選択されている場合にのみ使用できます。

        最大行数 トピックブロックで定義できる最大行数。

        このフィールドは、[タイプ (Type)] フィールドから [Array] が選択されている場合にのみ使用できます。

        デフォルト値 変数のデフォルト値です。この値は、ブロックをプレビューするときに使用できます。

        重複するデフォルト値は、[Array] データタイプには許可されません。

        たとえば、ビルド済みのコンテキスト検索トピックブロックは、次の入力パラメーターを提供します。

        コンテキスト検索トピックブロックの入力パラメーターには、context、query、portal、および kb_knowledge_base が含まれます。

      4. [保存] を選択します。
      呼び出し元トピックまたはトピックブロックは、入力パラメーターをトピックブロックに渡します。
    6. 仮想エージェントデザイナーのコントロールをキャンバスにドラッグします。
      これらのコントロールには、入力、ボット応答、およびユーティリティが含まれます。これらを組み合わせて使用し、トピックブロックで実行されるロジックを定義します。詳細については、「仮想エージェントデザイナーのコントロール」を参照してください。
    7. トピックブロックから返される出力を定義するには、次のようにします。
      1. キャンバスで [終了] ノードを選択します。
      2. [終了セグメントプロパティ] シートで、[+ 新しく追加] をクリックします。
      3. シートの次のフィールドに入力します。
        • [名前]:トピックブロックから返された値の名前。
        • [値]:呼び出し元トピック内で使用できる変数を含む文字列またはスクリプト。[値] は、定義した入力変数 (入力パラメーターで指定された [デフォルト値] とトピックブロック内のノードからの入力値) のデータピルとして表示されます。
        たとえば、ビルド済みのコンテキスト検索トピックブロックは、次の出力パラメーターを渡します。

        コンテキスト検索トピックブロックの出力パラメーターには、[Results returned と [Results Helpful] が含まれます。

      4. [保存] をクリックします。
      トピックブロックの実行が呼び出し元トピック内で終了すると、呼び出し元トピックに出力変数を渡すことができます。
    8. トピックブロックがどのように実行されるかを確認するには、[テスト] を選択します。
      たとえば、コンテキスト検索トピックブロックから、出力値を含むプレビューのみのメッセージを含む次の結果が返されました。プレビューメッセージによって予想される出力を検証でき、一方でユーザーには表示されません。

      プレビューウィンドウには、チャット会話と、出力変数とその値を表示するプレビュー専用セクションが表示されます。例: "results_helpful":true

    9. トピックの呼び出しでトピックブロックを使用できるようにする準備ができている場合は、次の操作を実行します。
      1. テストに使用したデフォルトのパラメーターを削除します。
      2. [保存] を選択し、[公開] をクリックします。
      トピックブロックのステータスが [アクティブ] に変更され、呼び出し元トピックで使用する準備ができます。

    次のタスク

    呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加