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

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

    始める前に

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

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

    このタスクについて

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

    手順

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        コンテキスト検索トピックブロックの出力パラメーターには、[返された結果] と [役に立つ結果] が含まれます。

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

      プレビューウィンドウには、チャット会話と、出力変数とその値を表示するプレビューのみのセクションが表示されます。たとえば、「results_helpful」:true です。

    9. トピックブロックを呼び出し元トピックで使用できるようにする準備ができたら、次の手順を実行します。
      1. テストに使用したデフォルトのパラメーターを削除します。
      2. [ 保存] を選択し、[ 公開] を選択します。
      トピックブロックのステータスが [アクティブ] に変わり、呼び出し元トピックで使用する準備ができます。

    次のタスク

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