アクションのレビューとデバッグ

アクションに組み込んだ会話をテストして、アシスタントでユーザーに表示される内容を体験する方法について説明します。問題がある場合は、ユーザー・エクスペリエンスをデバッグする方法を学習します。

「プレビュー」を使用してアクションをテスト

いつでもアクションをテストして、結果の対話が意図したとおりに機能するかどうかを確認できます。アクション・ページの 「プレビュー」 には、顧客が Web チャットを使用してこのアクションと対話したときに表示される内容が表示されます。

アクションをテストする前に、必ず新しい変更を保存し、システムがトレーニングを終了するまで待機してください。システムがまだトレーニング中の場合は、そのことを示すメッセージが表示されます。

「プレビュー」をクリックします。「顧客に挨拶する (Greet customer)」アクションが開始されます。
チャット・ウィンドウで、テキストを入力して Enter キーを押します。
応答を調べます。アシスタントが入力を正しく解釈して意図どおりのアクションを開始したかどうか、およびアシスタントが適切なステップを実行したかどうかを確認します。

「プレビュー」ペインでは、入力で認識されたアクションの名前を指定します。

「プレビュー」

アシスタントが語句を理解しない場合は、組み込みアクション No action matches が表示されます。
引き続きアシスタントと会話して、会話の流れを確認します。
チャット・ペインから過去のテスト発話を削除して最初からやり直すには、**「リセット」**アイコンをクリックします。テストの発話と応答が削除されるだけでなく、このアクションにより、前の対話の結果として設定されたすべての変数の値もクリアされます。

「プレビュー」ペインで送信した照会は、 /message API 呼び出しを生成しますが、ログに記録されず、課金も発生しません。

「プレビュー」を使用して、ダイアログをアクティブにした状態でアクションをテストする

アクション・エディターでダイアログがアクティブになっている場合、プレビュー・パネルにエラー・メッセージが表示されます。ダイアログのアクション・プレビュー・ページの画像

「ユーザーに通知しない」 をクリックして、ダイアログをオフにしてからオンにするまで、通知を非表示にします。

テスト前に変更を保存

「プレビュー」 は、アシスタントが最後に保存されたときからの更新を表します。

変更は以下の操作時に保存されます。

保存アイコンを選択する
新規ステップをクリックします
プレビューを開く
プレビューをリセットする

変更の保存について詳しくは、アクションの保存を参照してください。

保存せずに複数の編集を行った場合、プレビュー・ペインには、変更をテストする前に保存する必要があるというメッセージが表示されます。

「プレビュー」でデバッグ・モードを使用

プレビューにはデバッグ・モードがあり、これをオンにすると、アシスタントが特定の入力に応答する理由や応答しない理由を理解するのに役立つ情報を確認できます。

デバッグ・モードには、アクションを分析するためのツールが 4 つあります。

アクションの開始と終了 (Start and end of an action)
信頼度スコア
ステップ・ロケーター (Step locator)
つなげる (Follow along)

アクションの開始と終了 (Start and end of an action)

アシスタントは、顧客がアクション内で適合する入力を行うと会話内のスポットをマークします。また、アシスタントは、アクションがいつ完了したのかと、アックションがどのように完了したのかをマークします。

完了オプションには終了が含まれます。

終了ステップあり
終了ステップなし
ヒューマン・エージェント・エスカレーションあり
知識ベースに対する検索あり

アクション信頼度スコア (Action confidence score)

新規トピックを開始できる入力ごとに、信頼度スコア・アイコンが表示されます。このアイコンの上にカーソルを移動すると、さまざまな信頼度スコアを持つアクションのリストが表示されます。

これらのスコアは、入力した文または句が特定のアクションに組み込まれたステップによって解決できるというアシスタントの確信度を表します。

緑のトップ・スコアは、信頼度が最も高いアクションと、アシスタントが使用したアクションを表します。

残りの 2 つは、信頼度スコアのために考慮されたが、信頼度スコアが低いために使用されなかったアクションです。

20% の信頼性を超えるアクション・スコアがない場合は、組み込みアクション No action matches が表示されます。

ステップ・ロケーター (Step locator)

場合によっては、テスト会話の途中でエラーが検出され、どのステップとアクションが関係しているかを検出する必要があります。各アシスタント応答の横にあるロケーター・アイコンを使用すると、その関連ステップをエディターで見つけることができます。

そのアイコンをクリックすると、対応するステップがバックグラウンドでエディターに表示されます。

つなげる (Follow along)

フォロー は、プレビューで表示されている内容と、アクションで作成した内容を結び付けます。アシスタントと対話すると、バックグラウンドで各ステップが自動的にデバッグ・モードで開きます。これは、対応するステップに対してエディターが既に開いているため、表示されたらエラーを直ちに修正できることを意味します。

プレビューでの変数値

「プレビュー」 で、変数値を検証することによって会話をテストできます。 「変数値」 をクリックすると、各変数に格納されている値が表示されます。 「変数値」 ペインには 2 つのタブがあります。1 つはアクション変数用で、もう 1 つはセッション変数用です。

長い変数値の可視性を向上させるために、 「展開」 アイコンを使用してデバッグ・モード・パネルの幅を拡張することができます。

変数について詳しくは、会話中の情報の管理を参照してください。

変数値の編集

デバッグ・モードでは、編集する値をクリックすることで、変数値を編集できます。長い変数値の可視性を向上させるために、 「サイズ変更」 タブ (<) を使用して、デバッグ・モード・パネルの幅をサイズ変更することができます。アクション変数の大きな値を編集するには、変数値の横にある 「展開」 ボタンをクリックして 「エディター」 ウィンドウを開きます。 「エディター」 ウィンドウには、変数名とそれに関連付けられている値が表示されます。 「エディター」 ウィンドウを使用して、変数値を編集できます。

プレビューの拡張インスペクター

アクションでカスタム拡張を使用している場合は、プレビューの 「拡張インスペクター」 を使用してデバッグできます。詳しくは、カスタム拡張のデバッグを参照してください。