スクリプトの設定

スクリプト統合を使用すると、ストーリー、ルール、フォールバックのボット応答で使用するカスタムボットアクションを作成できます。カスタムアクションを作成するには、JavaScriptでコードを記述する必要があります。ボットビルダースクリプトはサーバー上で動作するため、スクリプトを構築する際には考慮すべき制限がいくつかあります。

スクリプト統合の作成

スクリプト統合には、1つ以上のカスタムボットアクションが保持されます。各ボットアクションには独自のスクリプトがあります。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. スクリプトタブをクリックし、 新しい統合をクリックします。
  5. タイトルをクリックして、統合の名前を変更します。
  6. 必要に応じて、この統合で使用するスクリプト変数を作成します。
  7. 統合に1つ以上のカスタムボットアクションを追加します。ここでスクリプトを作成します。必要に応じてスクリプト変数を参照できます。
  8. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

カスタムボットアクションの作成

ストーリー、ルール、フォールバックのボット応答にカスタムボットアクションを追加できます。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. スクリプトタブで、操作するスクリプト統合をクリックします。
  5. アクションで、新しいアクションをクリックします。
  6. アクションの名前を入力し、Enterキーを押します。
  7. 新しいアクションをクリックして、そのプロパティを展開します。
  8. カスタムJavaScriptコード(
      )を記述するには、エディターを開くをクリックします。
    1. エディターで、デフォルトのHelloWorldコードを置き換えますが、すべての新しいコードはメイン関数内に保持します。必要に応じてメイン内の他の関数を構造化します。メインの外側のコードは実行されません。
    2. 必要に応じて、コードにスクリプト変数を含めます。まだ作成していない場合は、変数を作成します。
    3. スクリプトの出力結果を表示するには、エディターの上部にあるツールバーの
    4. スクリプト実行の三角形をクリック右向きの三角形の矢印。します。結果はエディターの右側のコンソールペインに表示されます。
  9. エディターの左上隅にある開いた山括弧山括弧(<)。をクリックすると、アクションと変数のリストがあるスクリプト統合ページに戻ります。
  10. 操作しているアクションをクリックします。
  11. 編集可能な変数ドロップダウンで、コード内で参照したスクリプト変数を選択します。
  12. ストーリー閉じた インテントとコンテキストに基づいた対話の処理のためにボットをトレーニングするために使用されますルール閉じた コンテキストによって変化しないメッセージに対するボットの応答を定義するために使用されます。、またはフォールバック閉じた これらのサイトは、CXoneの開発とサポートのためのものであり、その運営を目的とするものではありません。これらをブロックすると、プラットフォーム内のヘルプやダウンロードリンクへのアクセスが妨げられる可能性があります。でテストする準備ができたら、アクションを有効にします。
  13. ストーリー、ルール、またはフォールバックにアクションを追加します。
  14. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

スクリプト変数の作成

作成した変数は、作成したスクリプト統合でのみ使用できます。同じボット内であっても、他のスクリプト統合では使用できません。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. スクリプトタブで、操作するスクリプト統合をクリックします。
  5. [変数]の下で、新しいアクションをクリックします。
  6. 名前を入力してEnterを押します。
  7. リスト内の変数をクリックして、そのプロパティを展開します。
  8. ボットアクションで編集できる単一値の変数を作成するには:
    1. テキストまたは数値をクリックします。
    2. この変数のデフォルト値を入力します。変数にデフォルト値を設定しない場合は、このフィールドを空のままにします。ボットアクションで使用されるときに変数値を更新できます。
    3. 数値変数の場合のみ、最小値最大値を入力して、変数が保持できる値の上限と下限を指定します。
  9. 読み取り専用の単一値変数を作成するには:
    1. シークレットをクリックします。
    2. を入力します。ボットビルダーは入力した値の最初の5文字以外をすべてマスクします。コンソールで変数の内容を表示すると、値を完全に見ることができます。
  10. この変数の可能な値のリストを作成するには:
    1. 選択をクリックします。
    2. 可能な変数をカンマ(,)で区切って入力します。たとえば、赤、青、緑などです。
    3. デフォルト値をクリックし、デフォルトにする値を選択します。
    4. デフォルト値を削除するには、フィールド上にカーソルを置いてXをクリックします。
  11. カスタムボットアクションスクリプトで変数を使用します。
  12. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

変数を編集可能にする

ボット応答でそのアクションを使用するときにその変数の値を指定または選択できるようにするには、カスタムボットアクションで変数を編集可能にすることができます。スクリプト統合の複数のアクションで変数を使用する場合は、各アクションで変数を編集可能にする必要があります。さらに、変数をスクリプト内で編集可能にするには、その変数をスクリプト内で参照する必要があります。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. スクリプトタブで、操作するスクリプト統合をクリックします。
  5. [アクション]の下で、スクリプト統合ページのアクションをクリックして、そのプロパティを展開します。
  6. 編集可能な変数ドロップダウンで1つ以上の変数を選択します。シークレット変数はこのリストには表示されません。編集可能にすることはできません。変更は自動的に保存されます。
  7. ストーリー、ルール、またはフォールバックで選択したカスタムアクションを使用する場合の変数の値を指定します。
  8. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

ボットアクションの有効化

ボットアクションをボット応答で使用する準備ができたら、それを有効にする必要があります。有効になっていないアクションは、ストーリー、ルール、またはフォールバックで作業しているときにボットアクションリストに表示されません。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. スクリプトタブで、操作するスクリプト統合をクリックします。
  5. [アクション]の下で、スクリプト統合ページのアクションをクリックして、そのプロパティを展開します。
  6. アクションを有効にするには、無効 トグルスイッチのアイコン。をクリックします。もう一度クリックすると、アクションが無効になり、ボットアクションリストから削除されます。