---
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) 所要時間：4分

トピック作成者がトピックまたはトピックブロックで使用できるカスタム入力または応答コントロールを構築します。仮想エージェント会話では、入力コントロールがエンドユーザーから情報を収集し、応答コントロールがエンドユーザーに情報を表示します。

## 始める前に

[カスタムコントロール定義を作成します](https://servicenow-prod.fluidtopics.net/2~oVA~5SCEKZ_xrarHh7JQ "カスタムコンポーネントにマップするカスタム入力または応答コントロール定義を定義します。")。  
重要:  
仮想エージェントカスタムコントロールに安全な (password2) 入力を実装するには、ワークフロースタジオ のスコープ対象のアプリケーション要件に従う必要があります。詳細については、「[ワークフロースタジオ 安全な入力のためのスコープ対象のアプリケーション要件](https://servicenow-prod.fluidtopics.net/N1dYVjFDe1~zCNO6aRdYww "仮想エージェントトピックに安全な (password2) 入力を実装するには、次のスコープ対象のアプリケーション要件に従ってください。")」を参照してください。  
ヒント:  
開発者とトピック作成者は、他のアプリケーションスコープで作成されたカスタムコントロールにアクセスする必要がある場合があります。アクセス権を付与するには、「 [トピックブロックとカスタムコントロールのクロススコープアクセス権限の構成](https://servicenow-prod.fluidtopics.net/WUFMrpZJk3SLaR6lVhcaQA "トピック作成者と開発者が、他のスコープ対象のアプリケーションから仮想エージェントトピックブロックとカスタムコントロールにアクセスできるようにします。")」を参照してください。

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

## 手順

1. 移動先 すべて対話型インターフェース仮想エージェントデザイナー.
2. ホームページで、\[ 作成\] を選択します。
3. フォームで、フィールドに入力します。  
   {#create-custom-control__table_dzy_15h_cmb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | タイプ | 仮想エージェントデザイナー で作成できる資産のリスト。 カスタムコントロールのタイプを選択します。 * カスタム入力コントロール * カスタム応答コントロール {#create-custom-control__ul_yly_pfg_dmb} |
   | 名前 | 目的を反映したカスタムコントロールの一意の名前。 |
   | 説明 | コントロールの目的と機能の簡単な説明。 |
   | 詳細プロパティ (オプション) ||
   | 入力の安全性を確保 \[カスタム入力コントロールのみ\] ||
   | 有効化 | カスタム入力コントロールがパスワードなどの安全な入力を渡すことができるようにする切り替えスイッチ。 |
   | パレットで利用可能 ||
   | 有効化 | カスタムコントロールを \[ フロー \] タブのパレットの \[ユーティリティ\] セクションに独自のアイコンとして表示するかどうかを決定する切り替えスイッチ。これにより、他の作成者がコントロールに簡単にアクセスできるようになります。 |
   | 追加 ||
   | カテゴリ | カテゴリのリスト。カテゴリは、関連するトピック、トピックブロック、またはカスタムコントロールを識別してグループ化します。該当する場合は、コントロールのカテゴリを選択します。 |
   [表 : 1. プロパティフォーム]

   {#create-custom-control__table_dzy_15h_cmb}
4. \[Create (作成)\] を選択します。  
   \[ フロー\] タブが開き、カスタムコントロールノードを含む初期フローが表示されます。
5. 開始ノードを選択し、コントロールへの入力パラメーターを定義します。  
   トピック作成者は、呼び出し元トピックからこれらの入力パラメーターと値を提供します。
   1. \[+ 追加\] を選択します。
   2. フォームで、フィールドに入力します。  
      {#create-custom-control__id_n4c_4sz_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-custom-control__id_n4c_4sz_gpb}
   3. \[Save (保存)\] を選択します。
   4. 追加のパラメーターについて、これらの手順を繰り返します。
   {#create-custom-control__substeps_j5d_fbw_3mb}
6. 終了 ノードを選択し 、カスタムコントロールから返される出力パラメーターと値を定義します。  
   トピック作成者は、呼び出し元トピックで出力値を使用できます。
   1. \[ + 新規追加\] を選択します。
   2. パラメーターの名前と値を入力します。
   3. 追加のパラメーターについて、これらの手順を繰り返します。
   4. \[Save (保存)\] を選択します。
   {#create-custom-control__substeps_v3h_mmc_bpb}
7. カスタムコントロールノードを選択し、次のようにプロパティシートに入力します。
   * カスタム入力コントロールの場合は、 [\[カスタム入力プロパティ\] シート](6qhRjXfJ3_UMQwYwngn2gQ "このシートを使用して、 仮想エージェント でカスタム入力コントロールを定義します。")を入力します。
   * 安全なカスタム入力コントロールの場合は、 [\[安全なカスタム入力プロパティ\] シート](RUXAQ2espGFX8vvQUgNONA "このシートを使用して、 仮想エージェント のカスタム入力コントロールでパスワードなどの安全な入力を指定します。")を入力します。
   * カスタム応答コントロールの場合は、 [\[カスタム出力プロパティ\] シート](PStsvqK~kM4bt0f7jttalQ "このシートを使用して、 仮想エージェント でカスタム応答コントロールを定義します。")を入力します。
8. コントロールを作成するには、\[ 保存\] を選択し、\[ 公開\] を選択します。
{#create-custom-control__steps_egn_xm2_dmb}

## タスクの結果

\[プロパティ\] ページの パレットで \[利用可能 \] を選択した場合、カスタムコントロールアイコンは、パレットの \[ユーティリティ\] セクションに独自のアイコンとして表示されます。コントロールは \[トピック\] ページに一覧表示され、\[タイプ\] メニューを使用してカスタムコントロールのみを表示できます。

## 次のタスク

[仮想エージェントトピックまたはトピックブロックへのカスタムコントロールの追加](https://servicenow-prod.fluidtopics.net/mKH~1_LP5P~oLd_FGoMUPA "仮想エージェントトピックまたはトピックブロックにカスタムコントロールを追加します。会話中に、ユーザーから入力を収集したり、出力をユーザーに表示したりできます。")。