仮想エージェントのカスタムコントロールの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • トピック作成者がトピックまたはトピックブロックで使用できるカスタム入力または応答コントロールをビルドします。仮想エージェントの会話では、入力コントロールがエンドユーザーから情報を収集し、応答コントロールがエンドユーザーに情報を表示します。

    始める前に

    カスタムコントロール定義を作成します

    重要:
    仮想エージェントのカスタムコントロールに安全な (password2) 入力を実装するには、ワークフロースタジオ のスコープ対象のアプリケーションの要件を遵守する必要があります。詳細については、「安全な入力のための ワークフロースタジオ のスコープ対象のアプリケーション要件」を参照してください。
    ヒント:
    開発者とトピック作成者が、他のアプリケーションスコープで作成されたカスタムコントロールへのアクセスを必要とする場合があります。アクセス権を付与するには、「トピックブロックとカスタムコントロールのクロススコープアクセス特権の作成」を参照してください。

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

    手順

    1. 移動先 すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
    2. [トピック] ページで、[+ 作成] をクリックします。
    3. フォームのフィールドに入力します。
      表 : 1. プロパティフォーム
      フィールド 説明
      タイプ

      仮想エージェントデザイナーで作成できるオブジェクトのリスト。

      カスタムコントロールのタイプを選択します。
      • カスタム入力コントロール
      • カスタム応答コントロール
      名前 目的を反映したカスタムコントロールの一意の名前です。
      説明 コントロールの目的と機能についての簡単な説明です。
      高度なプロパティ (オプション)
      入力の安全性を確保

      [カスタム入力コントロールのみ]

      有効化 カスタム入力コントロールがパスワードなどの安全な入力を渡すことができるようにする切り替えスイッチ。
      パレットで利用可能
      有効化 カスタムコントロールを [フロー] タブのパレットの [ユーティリティ] セクションに独自のアイコンとして表示するかどうかを決定する切り替えスイッチ。これにより、他の作成者がコントロールに簡単にアクセスできるようになります。
      追加
      カテゴリ カテゴリのリスト。カテゴリにより、関連するトピック、トピックブロック、またはカスタムコントロールを識別してグループ化します。該当する場合は、コントロールのカテゴリを選択します。
    4. [作成] をクリックします。
      [フロー] タブが開き、カスタムコントロールノードを含む初期フローが表示されます。
    5. [開始] ノードをクリックし、コントロールへの入力パラメーターを定義します。
      トピック作成者は、呼び出し元トピックからこれらの入力パラメーターと値を提供します。
      1. [+ 追加] をクリックします。
      2. フォームのフィールドに入力します。
        表 : 2. [入力を追加] ダイアログボックス
        フィールド 説明
        名前 入力値を保存する入力変数の名前。
        タイプ トピックブロックに渡されるデータのタイプ。たとえば、[文字列 (String)][ブーリアン (Boolean)] など。

        フィールドは選択した内容に応じて変わります。詳細については、「仮想エージェント トピックの入力データタイプ」を参照してください。

        必須 必要に応じてパラメーターを設定するオプション。
        ヒント 呼び出しトピックを作成するときに表示されるツールヒント。次の例を参照してください。

        この例の入力変数マッピングのツールヒントに表示されている [テストヒント文字列 (Test Hint String)]

        テーブル ServiceNow入力のクエリに使用されるテーブル。

        このフィールドは、[タイプ (Type)] フィールドから [Reference] または [Array.Reference] が選択されている場合にのみ使用できます。

        最大行数 トピックブロックで定義できる最大行数。

        このフィールドは、[タイプ (Type)] フィールドから [Array] が選択されている場合にのみ使用できます。

        デフォルト値 変数のデフォルト値です。この値は、ブロックをプレビューするときに使用できます。

        重複するデフォルト値は、[Array] データタイプには許可されません。

      3. [保存] をクリックします。
      4. 追加のパラメーターについて、これらの手順を繰り返します。
    6. [終了] ノードをクリックし、カスタムコントロールから返される出力パラメーターと値を定義します。
      トピック作成者は、呼び出し元トピックで出力値を使用できます。
      1. [+ 新しく追加] をクリックします。
      2. パラメーターの名前と値を入力します。
      3. 追加のパラメーターについて、これらの手順を繰り返します。
      4. [保存] をクリックします。
    7. カスタムコントロールノードをクリックし、次のようにプロパティシートに入力します。
    8. コントロールを作成するには、[保存] をクリックしてから [公開] をクリックします。

    タスクの結果

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

    次のタスク

    仮想エージェントトピックまたはトピックブロックへのカスタムコントロールの追加