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

仮想エージェントトピックは、トピックフロー内のコントロールのコレクションで構成されます。これらのコントロールを使用して、ユーザーに情報を収集、処理、提供します。コントロールは、インスタンス上のレコードを読み取り、作成し、更新することもできます。
コントロールの各セットは、会話フロー内の特定の機能を実行します。  
{#virtual-agent-controls__table_ubt_ywt_d2b__entry__2}

| カテゴリ | 説明 |
|-|-|
| 開始セグメント | トピックフローに自動的に表示され、会話に追加することも会話から削除することもできません。このコントロールは、会話の開始時に表示される挨拶の応答で構成できます。 |
| 終了セグメント | トピックフローに自動的に表示され、会話に追加することも会話から削除することもできません。このコントロールは、会話が終了する前の最終確認メッセージで構成できます。トピックのすべての分岐が最終的にこのコントロールに接続されるようにします。 |
| [ユーザー入力](https://servicenow-prod.fluidtopics.net/JIOzvnuMtkVwYtyoJhwixg "仮想エージェントデザイナーに用意されている一連の入力コントロール使用して、会話中のユーザーからの情報を求めてキャプチャします。") | 会話中のユーザーからの情報のプロンプトとキャプチャを行います。 |
| [ボット応答](https://servicenow-prod.fluidtopics.net/B2XaAhFEvzOVESmPm8RX~Q "仮想エージェントデザイナーには、ボット応答を会話に表示するためのさまざまなコントロールが用意されています。ボット応答は、サードパーティープラットフォームで行われるため、各出力の形式は異なる場合があります。") | 会話でボット応答を表示します。 |
| [ユーティリティ](https://servicenow-prod.fluidtopics.net/rvFq~S9DCQiKRn3QUnxWrg "仮想エージェントデザイナー のユーティリティを使用して、トピック内のインタラクションを制御できます。これらのユーティリティは、トピックの中でトピックブロック (再利用可能なコンポーネント) を追加したり、スクリプトを実行したり、異なる会話パス (分岐) を追加したりするなど、さまざまなアクションを実行します。ユーティリティは会話フローのノードとして表されますが、ユーザーには何も表示されません。") | トピックの中でスクリプトを実行したり、異なる会話パス (分岐) を追加したりするなど、トピック内でアクションおよびロジックを処理します。自動化された ワークフロースタジオ ワークフローを呼び出すこともできます。 |
[表 : 1. コントロールタイプ]

{#virtual-agent-controls__table_ubt_ywt_d2b}  
プロンプト、メッセージ、デフォルト値、または確認メッセージを持つコントロールについては、次の入力値のどれでも入力できます。

* テキスト文字列
* データピル
* データピルが埋め込まれた文字列
* 文字列を返すスクリプト
{#virtual-agent-controls__ul_qf1_1gy_c3b}

## データピル {#virtual-agent-controls__section_i2c_mgz_1gb}

データピルを使用すると、スクリプトを使用せずに動的な情報をコントロールにすばやく簡単に追加できます。データピルアイコン ![]() を選択して、データピルピッカーインターフェイスを開きます。このインターフェイスでは、ユーザー入力コントロールによって設定されたスクリプト変数および入力変数からデータを選択できます。

データピルを使用すると、変数内のデータにすばやく簡単にアクセスできます。対照的に、スクリプティングでは、翻訳の処理など、より複雑なオプションが提供されます。次の例では、データピルとスクリプトの両方として処理して、顧客の名前を含むテキストボット応答を使用する方法を示します。  
{#virtual-agent-controls__table_qkt_kv5_bgb__entry__2}

| 手法 | 結果 |
|-|-|
| データピル |   |
| データピル |   |
| スクリプト |   |
| スクリプト | ![動的なスクリプト化応答メッセージを表示するテキストコントロール]() |
[表 : 2. データピルとスクリプト化された応答]

{#virtual-agent-controls__table_qkt_kv5_bgb}

最初の例では、データピルセレクターを使用して、顧客の名前を含む入力変数である \[名前を取得 (Get Name)\] を選択します。2 番目の例では、スクリプトを使用して同じことを行います。スクリプトの例でも `gs.getMessage` を使用して、メッセージの翻訳を処理しています。

## このノードを非表示またはスキップする (条件プロパティ) {#virtual-agent-controls__section_lmr_5wt_d2b}

ほとんどすべてのコントロールに条件プロパティがあります。例外は、意思決定ユーティリティ、開始ノード、および終了ノードです。  
ユーザー入力コントロールでは、条件プロパティによって、コントロールが会話で使用されるかスキップされるかが決まります。常にコントロールを使用するには、条件フィールドを空のままにします。コントロールが使用される条件を決定するには、次のいずれかを実行します。

* 条件ビルダーインターフェイスを使用して条件を作成します。これにより、データピルを追加し、このインターフェイスを使用して作成された条件を指定できます。
* true または false の値を返す条件プロパティのスクリプトを提供します。戻り値が false の場合、コントロールは使用されず、会話はトピックのその分岐に沿って次のコントロールに続きます。
{#virtual-agent-controls__ul_szm_tdp_rsb}

条件を使用して、コンテキスト、データ、スクリプト化されたロジックに基づいて会話をより動的なものにします。  
{#virtual-agent-controls__table_xgn_qy5_bgb__entry__2}

| スクリプト化された条件 | 条件ビルダーの条件 |
|-|-|
| ノードを条件付きで表示するためのサンプルスクリプト： (function execute() { var gr = new GlideRecord('incident'); return gr.canCreate(); })() |   |
[ ]

{#virtual-agent-controls__table_xgn_qy5_bgb}

この例では、条件スクリプトは、現行のユーザーがインシデントレコードを作成できる場合は true を返します。この状態では、ユーザーが権限を持っていない場合に、ユーティリティ制御によってインシデントが作成されなくなります。