---
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分

アクションユーティリティを使用して、ServiceNow ワークフロースタジオ ワークフローを仮想エージェントトピックに統合します。アクションユーティリティノードは、仮想エージェント会話で使用される必要なワークフロースタジオワークフローをトリガーします。

## 始める前に

仮想エージェントトピックがまだない場合は作成します。詳細については、「[仮想エージェント トピックを作成する](https://servicenow-prod.fluidtopics.net/qIn05cDI~GW9_jHT8ftPKQ "仮想エージェントデザイナーを使用して仮想エージェントトピック (会話) を作成したり変更したりします。ユーザーの要求を満たしたり、ユーザーがタスクを完了するのをサポートするなどの、特定の目的や目標を達成するためにトピックをビルドします。")」を参照してください。  
次の機能をよく理解してください。

* ワークフロースタジオ のコンセプトとタスク。詳細については、「 [ワークフロースタジオ](https://www.servicenow.com/docs/access?context=workflow-studio&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US)」を参照してください。
* ルックアップユーティリティ、スクリプトアクションユーティリティなどの仮想エージェントデザイナーユーティリティ。

  これらのユーティリティを使用して、仮想エージェントの会話内のアクションを制御します。これらのユーティリティの詳細については、「[仮想エージェントデザイナーのユーティリティ](https://servicenow-prod.fluidtopics.net/rvFq~S9DCQiKRn3QUnxWrg "仮想エージェントデザイナー のユーティリティを使用して、トピック内のインタラクションを制御できます。これらのユーティリティは、トピックの中でトピックブロック (再利用可能なコンポーネント) を追加したり、スクリプトを実行したり、異なる会話パス (分岐) を追加したりするなど、さまざまなアクションを実行します。ユーティリティは会話フローのノードとして表されますが、ユーザーには何も表示されません。")」を参照してください。
* 仮想エージェントコントロール。次のいずれかを入力するように求められる場合があります。
  * テキスト文字列
  * データピル
  * データピルが埋め込まれた文字列
  * 文字列を返すスクリプト

  {#setup-flow-designer-va-properties__ul_z3h_tfh_14b}

  詳細については、「[仮想エージェントデザイナーのコントロール](https://servicenow-prod.fluidtopics.net/7n87ycZjp9CKZcjlCeGDew "仮想エージェントトピックは、トピックフロー内のコントロールのコレクションで構成されます。これらのコントロールを使用して、ユーザーに情報を収集、処理、提供します。コントロールは、インスタンス上のレコードを読み取り、作成し、更新することもできます。")」を参照してください。
{#setup-flow-designer-va-properties__ul_x5b_p13_knb}  
注:  
仮想エージェント でNow Assistをオンにして設定している場合は、仮想エージェントデザイナー ホームページから会話アクションとサブフローを操作できます。会話アクションとサブフローの詳細については、「 [Conversational actions](https://www.servicenow.com/docs/access?context=conversational-actions&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US) と [Conversational subflows](https://www.servicenow.com/docs/access?context=conversational-subflows&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US)」を参照してください。会話型ではないアクションやサブフローは、仮想エージェントデザイナーを介して ワークフロースタジオ から仮想エージェントトピックに引き続き統合できます。次のコンテンツは、 ワークフロースタジオ で会話型にできないアクションまたはサブフローにのみ関連します。

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

## 手順

1. 移動先 すべて対話型インターフェース仮想エージェントデザイナーをクリックし、ホームページので、使用するトピックを選択します。
2. パレットの \[ユーティリティ\] セクションから、\[アクションユーティリティ\] アイコン ![]() をキャンバス上の会話フローの適切な場所にドラッグします。  
   これで、アクションユーティリティが会話フローのノードになり、\[アクションユーティリティのプロパティ\] パネルが表示されます。
3. プロパティシートのフィールドに入力します。  
   {#setup-flow-designer-va-properties__action-utility-properties-sheet-table__entry__2}

   | 財産 | 説明 |
   |-|-|
   | ノード名 | このアクションノードの名前。 |
   | ワークフロースタジオ資産を呼び出す | 次の ワークフロースタジオ コンポーネントのいずれかを選択します。 * アクション：再利用可能な操作。 * サブフロー：一連の再利用可能なアクション、データ入力、およびデータ出力からなる自動化されたプロセスです。 {#setup-flow-designer-va-properties__ul_rqg_2pc_nqb} |
   | スポーク | 特定のアプリケーションまたはレコードタイプ専用の ワークフロースタジオ コンテンツが含まれるスコープ対象のアプリケーションの名前。 デフォルトのスポークのリストについては、「[スポーク](https://www.servicenow.com/docs/access?context=spokes&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US)」を参照してください。 |
   | アクション/サブフロー | インスタンス内で実行される ワークフロースタジオ のアクションまたはサブフローです。入力マッピングと出力マッピングのエリアは、選択内容に応じて変わります。 アクションの詳細については、選択内容の下にあるリンクを選択して ワークフロースタジオで表示してください。 |
   | 応答を待ちますか？ (Wait for response?) | 仮想エージェントが指定されたアクションからの応答を待ってから続行するかどうかを決定する切り替えスイッチ。 |
   | 入力マッピング | 選択したアクションへの入力として使用する変数を指定します。このエリアの内容は、選択したアクションに応じて変わります。オプションには、文字列入力、参照レコード、スクリプトなどが含まれます。 パスワードが必要なオプションの場合は、\[パスワード入力を含める\] 切り替えスイッチを有効にして、ユーザーにパスワードの入力を求めます。安全な入力では、password2 データタイプを使用する必要があります。入力は安全にマスクされ、他のユーザーが表示することはできません。 注: 仮想エージェントデザイナー の Array.Reference 入力データタイプは、ワークフロースタジオ の List.\[Table\] 入力データタイプに対応します。詳細については、「[アクションの入力データタイプと出力データタイプ](https://www.servicenow.com/docs/access?context=action-inputs-outputs&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US)」を参照してください。 |
   | 出力マッピング | 選択したアクションによって出力される変数を指定します。このエリアの内容は、選択したアクションに応じて変わります。 |
   | 詳細 (オプション) ||
   | 権限 ||
   | 実行方法 | アクションに使用する権限。次のオプションのいずれかを選択します。 * セッションを開始するユーザー：選択すると、現在のユーザーと同じ権限を使用して、アクションが実行されます。 * システムユーザー：選択すると、システム権限を使用してアクションが実行されます。その権限の一部は、現在のユーザーが使用できない場合があります。 {#setup-flow-designer-va-properties__ul_yrr_hrc_nqb} |
   | このノードを非表示 ||
   | 次の場合、このノードを条件付きで表示します： | 会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。 |
   [表 : 1. \[アクションユーティリティのプロパティ\] シート]

   {#setup-flow-designer-va-properties__action-utility-properties-sheet-table}
4. \[保存\] をクリックします。
{#setup-flow-designer-va-properties__steps_xzv_r23_knb}