スクリプトアクションの設定

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

Glossary

コンセプト	定義	例	ボットがすること
発話	コンタクトがインタラクションの中で話す任意のこと。メッセージと呼ばれるときもあります。	「パスワードを紛失しました。」「私の残高は？」「あなたはボットですか？」	ボットは自然言語理解(NLU)を使用して、各コンタクトの発話を分析し、その意味、つまりインテントを決定します。
インテント	コンタクトが伝えたいこと、または達成したいこと。コンタクトが送信するすべてのメッセージにはインテントがあります。	「パスワードを紛失しました」は「パスワードの再設定」というインテントがあります。「こんにちは」は「挨拶」のインテントがあります。	ボットはNLU このプロセスは自然言語処理(NLP)を拡張し、理解した内容に基づいて判断またはアクションを実行します。を使用してコンタクトのメッセージを分析し、インテントを判断します。それが分かれば、自らのメッセージで応答することができます。各インテントにボットに使用させるレスポンスを設定します。
エンティティ	コンタクトのメッセージ中の定義済み情報。	個人または製品名、電話番号、アカウント番号、場所など。	このボットはNLUを使って、コンタクトのメッセージに含まれるエンティティを特定します。エンティティは、ボットがコンタクトのメッセージの意味を理解するのに役立ちます。
スロット	コンタクトのメッセージから抽出され、ボットレスポンスで使用するために保存されたエンティティ。変数に似たもの。	コンタクト名のスロットを作成すると、ボットは対話中の応答でその名前を使用できるようになり、より個人的な名前になります。	これをするように設定すると、ボットはコンタクトメッセージからエンティティを抽出してスロットに保存します。ボットにこの情報を会話の後半で使わせることができます。
ルール	コンテキストによって意味が変化しないメッセージに対するボットのレスポンスを定義します。	会話の構成要素：挨拶、さようなら、ありがとう、移行、単純なはい/いいえの質問と謝辞。あなたの住所は何ですか？会話の構成要素—挨拶、さようなら、ありがとう、移行。単純なはい/いいえの質問。と謝辞。 CXone Bot Builderはグリーティング、ハンドオーバーライブエージェントへの転送を必要とするコンタクトからのメッセージ要求など、これらのいくつかのデフォルトのインテントとルールが付属しています。よくある質問侮辱と古典的なボットの課題	ルールは、ボットがインテントにどのように応答するかを設定する2つの方法のうちの1つです。ルールはある種のインテントには有効ですが、すべてのインテントに有効なわけではありません。
ストーリー	メッセージのインテントと会話のコンテキストに基づいてインタラクションを処理するようにボットをトレーニングします。	パスワードを忘れた場合のやり取りで、ボットは「どうすればよいですか？」と応答する場合があります。対話が新しいアカウントの作成に関するものである場合、どちらの場合もコンタクトが同じ意図で同じ単語を使用している場合でも、応答はまったく異なります–より多くの情報を取得します。	ストーリーは、ボットがインテントにどのように応答するかを設定できる2つの方法のうちの2つ目です。ストーリーは、会話のコンテキストを利用して適切に応答する方法をボットに指示します。
ボットアクション	インタラクションの処理中にボットが言う、または行うこと。	パスワード忘れに関するインタラクションでは、ボットは、WebサイトのパスワードリセットFAQへのリンクを送信することによって応答します。コンタクトが「理解できない」などと不満を表明した場合！機能していません！」ボットは、「すみません。人間のエージェントに転送しましょうか？」と応答します。コンタクトがはいと答えると、ボットは転送を開始します。	アクションとは、各インテントにボットがどのように応答するかを定義する際のオプションです。各レスポンスを柔軟に設定することで、コンタクトのニーズに合ったアウトカムを達成することができます。

スクリプト統合の作成

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

CXoneで、アプリセレクターをクリックし、選択します：Bot Builder。
作業したいボットをクリックします。
左側のアイコンメニューで連携をクリックします。
スクリプトタブをクリックし、新しい統合をクリックします。
タイトルをクリックして、統合の名前を変更します。
必要に応じて、この統合で使用するスクリプト変数を作成します。
統合に1つ以上のアクションを追加します。ここでスクリプトを作成します。この統合で作成するスクリプトアクションはどれも、統合のスクリプト変数を参照できます。
変更が完了したら、トレーニングとステージをクリックしてボットモデルトレーニングされ、ステージングされたボットのバージョンを更新してこの変更をテストします。

スクリプトアクションを作成します

ストーリー意図と文脈に基づくインタラクション処理のためにボットをトレーニングする目的で使用されます、ルール文脈に応じて変化しないメッセージに対するボットの応答を定義するために使用されます。、フォールバックリッチメディアをサポートしていない宛先に送信される代替プレーンテキスト。のボットレスポンスにスクリプトアクションを追加できます。

CXoneで、アプリセレクターをクリックし、選択します：Bot Builder。
作業したいボットをクリックします。
左側のアイコンメニューで連携をクリックします。
スクリプトのタブで、スクリプトの統合をクリックします。
アクションで、新しいアクションをクリックします。
アクションの名前を入力し、Enterキーを押します。
新しいアクションをクリックして、そのプロパティを展開します。
カスタムJavaScriptコード(
1. エディターで、デフォルトのHelloWorldコードを置き換えますが、すべての新しいコードはメイン関数内に保持します。必要に応じてメイン内の他の関数を構造化します。メインの外側のコードは実行されません。
2. 必要に応じて、コードにスクリプト変数を含めます。まだ作成していない場合は、変数を作成します。
3. スクリプト実行の三角形をクリックします。結果はエディターの右側のコンソールペインに表示されます。
エディターの左上隅にある開いた山括弧をクリックすると、アクションと変数のリストがあるスクリプト統合ページに戻ります。
操作しているアクションをクリックします。
編集可能な変数ドロップダウンで、コード内で参照したスクリプト変数を選択します。
テストの準備ができたら、アクションを有効にします。
テストのためストーリー、ルール、またはフォールバックにアクションを追加します。
変更が完了したら、トレーニングとステージをクリックしてボットモデルトレーニングされ、ステージングされたボットのバージョンを更新してこの変更をテストします。
必要なテストを実施します。たとえば、お客様のボットとチャットすることができます。必要であれば、スクリプトのアングルを調整し、トレーニングとステージングを行い、再度テストを行います。

スクリプト変数の作成

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

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

変数を編集可能にする

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

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

スクリプトアクションの有効化

スクリプトアクションをボットレスポンスで使用する準備ができたら、それを有効にする必要があります。有効になっていないアクションは、ダイアログ CXone Bot Builderにおけるボットのストーリーとルール。で作業しているときにスクリプトアクションリストに表示されません。

CXoneで、アプリセレクターをクリックし、選択します：Bot Builder。
作業したいボットをクリックします。
左側のアイコンメニューで連携をクリックします。
スクリプトのタブで、スクリプトの統合をクリックします。
[アクション]の下で、スクリプト統合ページのアクションをクリックして、そのプロパティを展開します。
アクションを有効にするには、無効をクリックします。もう一度クリックするとアクションが無効になり、ボットアクションメニューのスクリプトタブから削除されます。