---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアの対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

# 再利用可能なトピックブロックの作成 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

仮想エージェント会話でタスクと会話要素の特定のサブフローを実行する再利用可能なコンポーネントを構築します。

## 始める前に

ヒント:  
開発者とトピック作成者が、他のアプリケーションスコープで作成されたトピックブロックにアクセスする必要がある場合があります。アクセス権を付与するには、「 [トピックブロックとカスタムコントロールのクロススコープアクセス権限の構成](https://servicenow-prod.fluidtopics.net/WUFMrpZJk3SLaR6lVhcaQA "トピック作成者と開発者が、他のスコープ対象のアプリケーションから仮想エージェントトピックブロックとカスタムコントロールにアクセスできるようにします。")」を参照してください。

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

## このタスクについて

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

## 手順

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

   | フィールド | 説明 |
   |-|-|
   | タイプ | 仮想エージェントデザイナー で作成できるアイテムのリスト。 トピック ブロック を選択し、追加のプロパティを定義します。 注: このトピックをトピックブロックとして設定すると、通常のトピックに変更することはできません。 |
   | 名前 | 機能上の目的を反映したトピックブロックの一意の名前。この名前は、トピック作成者がトピックを作成または更新するときに選択できるトピックブロックのリストに表示されます。 |
   | 説明 | トピックブロックの目的の簡単な説明。たとえば、レコードを取得する場合などです。 |
   | 詳細プロパティ (オプション) ||
   | このトピックにアクセスできるユーザー ||
   | チャネル | トピックまたはトピックブロックが実行されるチャットクライアント。 これらのチャネルは、 仮想エージェント でネイティブにサポートされているデフォルトのチャネルとは異なります。インスタンスには、 [カスタムチャット統合](https://servicenow-prod.fluidtopics.net/ZUOs8X4_9sWtzN8kZoTMkQ "会話型カスタムチャット統合フレームワークは、ServiceNow 仮想エージェントを任意の対話型インターフェースに表示するためのスクリプト可能な API と構成で構成される強力なフレームワークです。") 用に追加のチャネルが作成されている場合があります。チャネルの詳細については、「 [他のチャネルへの仮想エージェントトピックの展開](https://servicenow-prod.fluidtopics.net/jOi4JW8YXbysNDcrCucAaQ "トピックまたはトピックブロックを作成するときに、トピックまたはトピックブロックを実行するチャットチャネルを指定できます。会話の設計時に、 仮想エージェントデザイナー には、これらのチャネルに合わせて会話を調整するのに役立つビルトインガードレールが用意されています。")」を参照してください。 |
   | ライブエージェント ||
   | ライブエージェントコンテキスト変数 | [一般的なチャット設定](https://servicenow-prod.fluidtopics.net/sILnFnUDDDMwTDiAjg7Vrg "チャット前のサーベイ応答などのチャット関連情報を保存するために、チャットコンテキスト変数 (ライブエージェント チャット変数とも呼ばれる) を指定します。これらの変数には、トピックのインテントを決定したり、チャットをライブエージェントにルーティングする方法を制御したりするために使用できるコンテキスト情報が含まれています。変数を定義して、 仮想エージェント トピックスクリプトで渡されたコンテキスト情報をキャプチャし、ライブエージェントと共有することもできます。")で定義されているライブエージェントコンテキスト変数。 動的コンテキスト ( 仮想エージェント チャットからの情報) を提供する変数を選択します。この情報は、ボットの会話からライブエージェントに転送されます。 ライブエージェント変数のデフォルトリストの詳細については、「 [ライブエージェントチャットコンテキスト変数](https://servicenow-prod.fluidtopics.net/lmmx2lHf8kFh_xN2UxrfJA "チャットコンテキスト変数を使用して、トピックから特定の情報を渡してライブエージェントと共有したり、ボット会話をライブエージェントにルーティングする方法を制御したりします。 仮想エージェント にはいくつかのデフォルト変数が含まれており、新しい変数を定義できます。")」を参照してください。 |
   | エージェントオートパイロットで利用可能 | トピックブロックをライブエージェントが利用できるかどうかを決定する切り替えスイッチ。 有効にすると、エージェントはトピックを検索して呼び出すことができます。詳細については、「 [対話オートパイロット](https://servicenow-prod.fluidtopics.net/3AOXwog7wrz6teoXBunLKQ#ci-conversation-autopilot "エージェントは、対話オートパイロットを使用して、エージェントチャット会話中に仮想エージェントトピックを表示できます。要求者が 仮想エージェント トピックを操作している間、エージェントはマルチタスクを行ったり、他のアイテムを処理したりできます。対話オートパイロットは HR サービスデリバリ (HRSD) (HRSD) では利用できません。")」を参照してください。 |
   | パレットで利用可能 ||
   | 有効化 | トピックブロックを \[ フロー \] タブのパレットの \[ユーティリティ\] セクションに独自のアイコンとして表示するかどうかを決定する切り替えスイッチ。これにより、他の作成者がトピックブロックに簡単にアクセスできるようになります。 |
   | 追加 ||
   | カテゴリ | このブロックを含むカテゴリ。トピックブロックの [カスタムトピックカテゴリ](https://servicenow-prod.fluidtopics.net/ZXk0fEs6T8liJp7HC2i~Cw "トピックなどの関連する 仮想エージェント 資産を整理およびグループ化するためのカスタムカテゴリを作成または変更します。エンドユーザーに表示されるトピックピッカーメニューにカテゴリラベルを表示することもできます。") を定義できます。 |
   [表 : 1. \[トピックブロックのプロパティ\] シート]

   {#create-topic-blocks__table_jlp_q1z_njb}
4. \[Create (作成)\] を選択します。  
   \[ フロー\] タブが開きます。キャンバスには、 開始 ノードと 終了 ノードを持つフローが表示されます。
5. ブロックへの入力を定義するには、次の手順を実行します。
   1. キャンバスで \[ 開始\] ノードを選択します。
   2. \[開始セグメントのプロパティ\] シートで、\[+ 追加\] を選択します
   3. シートのフィールドに入力します。  
      {#create-topic-blocks__id_w2q_ksz_gpb__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | 入力値を保存する入力変数の名前。 |
      | タイプ | トピックブロックに渡されるデータのタイプ。たとえば、\[文字列 (String)\]、\[ブーリアン (Boolean)\] など。 フィールドは選択した内容に応じて変わります。詳細については、「[仮想エージェントトピックの入力データタイプ](https://servicenow-prod.fluidtopics.net/wXn2eTBFio9S6RIfPkJHSg "一般的に使用される Glide 仮想エージェント (com.glide.cs.chatbot) データタイプの入力は、スクリプトを記述せずに アシスタントデザイナー で定義できます。カスタムコントロールまたはトピックブロックの開始ノードで入力データタイプを定義します。")」を参照してください。 |
      | 必須 | 必要に応じてパラメーターを設定するオプション。 |
      | ヒント | 呼び出しトピックを作成するときに表示されるツールヒント。次の例を参照してください。 |
      | テーブル | ServiceNow入力のクエリに使用されるテーブル。 このフィールドは、\[タイプ (Type)\] フィールドから \[Reference\] または \[Array.Reference\] が選択されている場合にのみ使用できます。 |
      | 最大行数 | トピックブロックで定義できる最大行数。 このフィールドは、\[タイプ (Type)\] フィールドから \[Array\] が選択されている場合にのみ使用できます。 |
      | デフォルト値 | 変数のデフォルト値です。この値は、ブロックをプレビューするときに使用できます。 重複するデフォルト値は、\[Array\] データタイプには許可されません。 |
      [表 : 2. \[入力を追加\] ダイアログボックス]

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

   4. \[Save (保存)\] を選択します。

   {#create-topic-blocks__substeps_hqh_hnz_njb}  
   呼び出し元トピックまたはトピックブロックは、入力パラメーターをトピックブロックに渡します。
6. 仮想エージェントデザイナーコントロールをキャンバスにドラッグします。  
   これらのコントロールには、入力、ボット応答、およびユーティリティが含まれます。これらを組み合わせて使用し、トピックブロックで実行されるロジックを定義します。詳細については、「[アシスタントデザイナー コントロール](https://servicenow-prod.fluidtopics.net/Y~a43PkZHMvjyNYrXT1JIg "仮想エージェントトピックは、トピックフロー内のコントロールのコレクションで構成されます。これらのコントロールを使用して、情報を収集、処理、およびユーザーに提示します。コントロールは、インスタンス上のレコードの読み取り、作成、更新もできます。")」を参照してください。
7. トピックブロックから返される出力を定義するには、次の手順を実行します。
   1. キャンバスで 終了 ノードを選択します。
   2. \[終了セグメントのプロパティ\] シートで、\[ + 新規追加\] を選択します。
   3. シートで、次のフィールドに入力します。  
      * 名前:トピックブロックから返された値の名前。
      * 値:呼び出し元トピック内で使用できる変数を含む文字列またはスクリプト。値は、定義した入力変数 (入力パラメーターで指定されたデフォルト値とトピックブロック内のノードからの入力値) のデータピルとして表示されます。
      {#create-topic-blocks__ul_af4_kzm_1kb}  
      たとえば、ビルド済みのコンテキスト検索トピックブロックは、次の出力パラメーターを渡します。

   4. \[Save (保存)\] を選択します。

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

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

   トピックブロックのステータスが \[アクティブ\] に変わり、呼び出し元トピックで使用する準備ができます。

## 次のタスク

[呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加](https://servicenow-prod.fluidtopics.net/ckeViHyRyK0yUwZG_GcVdA "再利用可能なトピックブロックを呼び出し元 (親) トピックまたはトピックブロックに追加して、呼び出し元トピックで特定の機能またはタスクを実行します。トピックブロックで使用される入力パラメーターを指定し、呼び出し元トピックで使用される出力パラメーターを指定します。")。