アクションのレビューとデバッグ
アクションに組み込んだ会話のテスト方法について学び、ユーザーがアシスタントとどのような会話を体験できるかを確認しましょう。 問題が発生した場合は、ユーザーエクスペリエンスのデバッグ方法を学びましょう。
「プレビュー」を使用してアクションをテスト
いつでもアクションをテストして、その結果として得られるインタラクションが意図したとおりに機能するかどうかを確認できます。 アクション・ページの 「プレビュー」 には、顧客が Web チャットを使用してこのアクションと対話したときに表示される内容が表示されます。
アクションをテストする前に、必ず新しい変更を保存し、システムがトレーニングを終了するまで待機してください。 システムがまだトレーニング中の場合は、そのことを示すメッセージが表示されます。
-
「プレビュー」をクリックします。 「顧客に挨拶する (Greet customer)」アクションが開始されます。
-
チャット・ウィンドウで、テキストを入力して Enter キーを押します。
-
応答を調べます。アシスタントが入力を正しく解釈して意図どおりのアクションを開始したかどうか、およびアシスタントが適切なステップを実行したかどうかを確認します。
「プレビュー」ペインでは、入力で認識されたアクションの名前を指定します。
「プレビュー」 アシスタントが語句を理解しない場合は、組み込みアクション
No matchesが表示されます。 -
引き続きアシスタントと会話して、会話の流れを確認します。
-
チャット・ペインから過去のテスト発話を削除して最初からやり直すには、**「リセット」**アイコンをクリックします。 テストの発話と応答が削除されるだけでなく、このアクションにより、前の対話の結果として設定されたすべての変数の値もクリアされます。
プレビューパネルから送信したクエリは、 /message APIコールを生成しますが、ログには記録されず、料金も発生しません。
「プレビュー」を使用して、ダイアログをアクティブにした状態でアクションをテストする
アクション・エディターでダイアログがアクティブになっている場合、プレビュー・パネルにエラー・メッセージが表示されます。
「ユーザーに通知しない」 をクリックして、ダイアログをオフにしてからオンにするまで、通知を非表示にします。
テスト前に変更を保存
プレビューは、アシスタントが最後に保存された時点からの更新内容を表示します。
変更は以下の操作時に保存されます。
- 保存アイコンを選択する
- 新規ステップをクリックします
- プレビューを開く
- プレビューをリセットする
変更の保存について詳しくは、 アクションの保存 を参照してください。
保存せずに何度も編集を行うと、プレビューウィンドウに、変更をテストする前に保存する必要がある旨のメッセージが表示されます。
「プレビュー」でデバッグ・モードを使用
「プレビュー」 メニューには 「デバッグ・モード」 があり、これをオンにすると、アシスタントが特定の入力に応答する理由や応答しない理由に関連する情報を確認できます。
デバッグ・モードでは、 toggle-tip アイコン (
) を使用して、プライベート変数を含む会話を識別できます。
プライベート変数保護を無効にするには、アクション・ステップ内の 「エディター」 タブで 「顧客応答設定」 に移動します。
デバッグモードには、お客様のアクションを分析する4つのツールがあります
アクションの開始と終了 (Start and end of an action)
アシスタントは、顧客がアクション内で適合する入力を行うと会話内のスポットをマークします。 また、アシスタントは、アクションがいつ完了したのかと、アックションがどのように完了したのかをマークします。
完了オプションには終了が含まれます。
- 終了ステップあり
- 終了ステップなし
- ヒューマン・エージェント・エスカレーションあり
- 知識ベースに対する検索あり
アクション信頼度スコア (Action confidence score)
入力したすべての入力で新規トピックを開始して、 「信頼度スコア」 アイコンを表示できます。 信頼スコアのアイコンにカーソルを合わせると、異なる信頼スコアのアクションの一覧が表示されます。
信頼スコアは、あなたが入力した文章またはフレーズが、特定のアクションに組み込まれた手順で解決できるというアシスタントの確信度を表します。
緑のトップ・スコアは、信頼度が最も高いアクションと、アシスタントが使用したアクションを表します。
残りの2つは、信頼スコアが高かったために考慮されたアクションですが、信頼スコアが低かったため使用されませんでした。
20%以上の信頼度を獲得するアクションがない場合、組み込みアクション No matches が表示されます。
ステップ・ロケーター (Step locator)
会話テストの最中にエラーが見つかることもあり、どのステップやアクションが関係しているのかを突き止める必要があるかもしれません。 各アシスタント応答の横にあるロケーター・アイコンを使用すると、その関連ステップをエディターで見つけることができます。
そのアイコンをクリックすると、対応するステップがバックグラウンドでエディターに表示されます。
つなげる (Follow along)
プレビューで表示されているものとアクションで作成したものを関連付けるために、 それに従ってください。 アシスタントと対話すると、バックグラウンドで各ステップが自動的にデバッグ・モードで開きます。 これは、対応するステップに対してエディターが既に開いているため、表示されたらエラーを直ちに修正できることを意味します。
プレビューでの変数値
「プレビュー」 で、変数値を検証することによって会話をテストできます。 「変数値」 をクリックすると、各変数に格納されている値が表示されます。 「変数値」パネルには、アクション変数とセッション変数の2つのタブがあります。
長い変数値の可視性を向上させるために、 「展開」 アイコンを使用してデバッグ・モード・パネルの幅を拡張することができます。
変数について詳しくは、会話中の情報の管理を参照してください。
プライベート変数は、会話内でマスクされたテキストとして表示されます。 会話の横に表示されるトグル・ヒント・アイコン () を使用して、プライベート変数を含む会話を識別できます。
プレビューでのアクション変数
「アクション変数」 セクションで、会話の横に表示されるトグル・ヒント・アイコン () を使用してプライベート変数を識別します。
プライベート変数の保護を無効にするには、 「アクション」 > 「変数」 > 「自分で作成」 > 「アクション変数」 に移動します。 「アクション変数」 で、 「この変数に保管されているデータを保護する」 チェック・ボックスをクリアします。
プレビューでのセッション変数
ダイアログを使用している場合は、アクションとダイアログの両方のセッション変数が 「セッション変数」 タブに表示されます。
「セッション変数」 セクションで、会話の横に表示されるトグル・ヒント・アイコン () を使用してプライベート変数を識別できます。
プライベート変数の保護を無効にするには、 「アクション」 > 「変数」 > 「作成者」 > 「セッション変数」 に移動します。 「セッション変数」 で、 「この変数に保管されているデータを保護」 チェック・ボックスをクリアします。
変数値の編集
デバッグ・モードでは、編集する値をクリックすることで、変数値を編集できます。 長い変数値の可視性を向上させるために、 「サイズ変更」 タブ (<) を使用して、デバッグ・モード・パネルの幅をサイズ変更することができます。 アクション変数の大きな値を編集するには、変数値の横にある 「展開」 ボタンをクリックして 「エディター」 ウィンドウを開きます。 「エディター」 ウィンドウには、変数名とそれに関連付けられている値が表示されます。 「エディター」 ウィンドウを使用して、変数値を編集できます。
アクションプレビューでのインスペクタの使用
アクションでカスタム拡張機能を使用している場合、プレビューのインスペクタを使用してデバッグできます。 詳細については、カスタム拡張機能のデバッグ を参照してください。
会話型検索やスキルベースのアクションを使用している場合は、プレビューでインスペクタを使用してデバッグできます。 詳細は 会話型検索のデバッグ を参照。
