アクションのレビューとデバッグ
アクションに組み込んだ会話をテストし、ユーザーが AIアシスタントを通じてどのような体験をするかを確認する方法をご紹介します。 問題があれば、ユーザー・エクスペリエンスをデバッグする方法を学ぶ。
「プレビュー」を使用してアクションをテスト
いつでもアクションをテストして、結果のインタラクションが意図したとおりに動作するかどうかを確認することができます。 アクションページのプレビューは、顧客がウェブチャットを使用してこのアクションと対話するときに表示されるものを表示します。
アクションをテストする前に、必ず新しい変更を保存し、システムがトレーニングを終了するまで待ちます。 システムがまだトレーニング中の場合は、そのことを示すメッセージが表示されます。
「プレビュー」をクリックします。 「顧客に挨拶する (Greet customer)」アクションが開始されます。
チャット・ウィンドウで、テキストを入力して Enter キーを押します。
AIアシスタントが入力を正しく解釈し、意図したアクションを開始し、適切な手順を実行したかどうかを確認してください。
「プレビュー」ペインでは、入力で認識されたアクションの名前を指定します。
アシスタントがフレーズを理解できない場合、組み込みのアクション「No action matches」が表示されます。
AIアシスタントと会話を続けて、会話の流れを確認してみてください。
チャット・ペインから過去のテスト発話を削除して最初からやり直すには、「リセット」アイコンをクリックします。 テストの発話と応答が削除されるだけでなく、このアクションにより、前の対話の結果として設定されたすべての変数の値もクリアされます。
プレビュー・ペインから送信したクエリは「/messageAPIコールを生成しますが、ログには記録されず、料金も発生しません。
テスト前に変更を保存
プレビューには、 AIアシスタントが最後に保存された時点からの更新内容が表示されます。
変更は以下の操作時に保存されます。
保存アイコンを選択する
新しいステップをクリックする
プレビューを開く
プレビューをリセットする
変更の保存について詳しくは、アクションの保存をご覧ください。
保存せずに何度か編集を行うと、プレビューペインに変更をテストする前に保存する必要があるというメッセージが表示されます。
「プレビュー」でデバッグ・モードを使用
「プレビュー 」メニューには「 デバッグモード 」があり、これを有効にすると、 AIアシスタントが特定の入力に対して応答する理由や応答しない理由に関する情報を確認できます。
デバッグモードでは、 トグルヒントアイコン（
）を使用して、プライベート変数を含む会話を特定できます。
プライベート変数の保護を無効にするには、アクションステップ内のEditorタブでCustomer response settingsに進みます。
デバッグモードには、あなたの行動を分析するための4つのツールがある：
アクションの開始と終了 (Start and end of an action)
AIアシスタントは、顧客が入力した内容がアクションの条件に合致した時点で、会話内の該当箇所にマークを付けます。 この AIアシスタントは、アクションが完了したタイミングや、その完了状況も記録します。
完了オプションには終了が含まれます。
終了ステップあり
終了ステップなし
ヒューマン・エージェント・エスカレーションあり
知識ベースに対する検索あり
アクション信頼度スコア (Action confidence score)
すべての入力は、信頼スコアのアイコンを表示するために新しいトピックを開始することができます。 信頼度スコアのアイコンにカーソルを合わせると、信頼度スコアの異なるアクションのリストが表示されます。
信頼度スコアは、入力された文やフレーズが、特定のアクションに組み込まれた手順によって解決できると AIアシスタントが判断した度合いを表しています。
緑色の最高スコアは、信頼度が最も高く、 AIアシスタントが採用したアクションを表しています。
残りの2つは、信頼スコアが高かったために検討されたが、信頼スコアが低かったために採用されなかった行動である。
信頼度20%以上のアクションがない場合、ビルトインアクション'No action matchesが表示されます。
ステップ・ロケーター (Step locator)
時には、テストの会話の途中でエラーを発見し、どのステップとアクションが関係しているかを見つける必要があるかもしれない。 各AIアシスタントの応答の横にある位置情報アイコンをクリックすると、エディタ内で関連する手順を確認できます。
そのアイコンをクリックすると、対応するステップがバックグラウンドでエディターに表示されます。
つなげる (Follow along)
あなたがプレビューで見ているものと、あなたがアクションで構築したものを結びつけてください。 AIアシスタントとやり取りをしていると、バックグラウンドで各ステップのデバッグモードが自動的に開きます。 これは、対応するステップに対してエディターが既に開いているため、表示されたらエラーを直ちに修正できることを意味します。
プレビューの変数値
プレビューでは、変数の値を確認することで会話をテストすることができます。 変数値をクリックすると、各変数に格納されている値が表示されます。 変数値ペインには、アクション変数用とセッション変数用の2つのタブがあります。
長い変数値を見やすくするために、拡張アイコンを使ってデバッグ・モード・パネルの幅を広げることができます。
変数について詳しくは、会話中の情報の管理を参照してください。
プライベート変数は会話の中でマスクされたテキストとして表示される。 プライベート変数を含む会話は、その会話の横に表示されるトグルチップアイコン（）で識別できます。
プレビュー内のアクション変数
「 アクション変数 」セクションで、会話の横に表示されるトグルチップアイコン（）が付いたプライベート変数を探します。
プライベート変数の保護を無効にするには、Actions>Variables>Created by you>Action variablesに進みます。 アクション変数で、この変数に保存されているデータを保護するチェックボックスをオフにする。
プレビューでのセッション変数
「 セッション変数 」セクションでは、会話の横に表示されるトグルチップアイコン（）をクリックすることで、プライベート変数を特定できます。
プライベート変数の保護を無効にするには、[アクション] > [変数] > [自分で作成] > [セッション変数]に進みます。 セッション変数]で、[この変数に保存されているデータを保護する]チェックボックスをオフにします。
変数値の編集
デバッグモードでは、編集したい値をクリックすることで、変数の値を編集することができる。 長い変数値を見やすくするために、リサイズタブ(<)を使ってデバッグモードパネルの幅を変更することができます。アクション変数の大きな値を編集するには、変数値の横にあるExpandボタンをクリックしてEditorウィンドウを開きます。 エディター・ウィンドウには、変数名とそれに関連する値が表示されます。 エディター・ウィンドウを使って変数値を編集することができます。
アクションプレビューでのインスペクタの使用
アクションでカスタム拡張機能を使用している場合、プレビューのインスペクタを使用してデバッグできます。 詳細については、カスタム拡張機能のデバッグを参照してください。
会話型検索やスキルベースのアクションを使用している場合、プレビューのインスペクタを使用してデバッグすることができます。 詳細は会話型検索のデバッグを参照。
