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

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

## 始める前に

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

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

## タスクの結果

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

## 次のタスク

[仮想エージェントトピックまたはトピックブロックへのカスタムコントロールの追加](https://servicenow-prod.fluidtopics.net/EfFaI1fs4zvk~JqlHaO3hg "仮想エージェントトピックまたはトピックブロックにカスタムコントロールを追加します。会話中に、ユーザーから入力を収集したり、出力をユーザーに表示したりできます。")に展開したカスタムモバイルアプリケーションを使用して管理しました。