---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

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

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

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

## 始める前に

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

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

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

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

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

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

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

   4. \[保存\] をクリックします。

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

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

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

## 次のタスク

[呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加](https://servicenow-prod.fluidtopics.net/z~izsY18VraNu69n3aySuA "呼び出し元トピックで特定の機能またはタスクを実行するために、再利用可能なトピックブロックをその呼び出し元 (親) トピックまたはトピックブロックに追加します。トピックブロックで使用される入力パラメーターを指定し、呼び出し元トピックで使用される出力パラメーターを指定します。")に展開したカスタムモバイルアプリケーションを使用して管理しました。