Amazon Q in Connect セルフサービスの問題のトラブルシューティング

CloudWatch ログ記録: Amazon Q in Connect をモニタリングする の手順に従って、Amazon Q in Connect インスタンスの CloudWatch ログ記録を有効にします。

セルフサービスでのやり取りは、次の形式でイベントタイプ TRANSCRIPT_SELF_SERVICE_MESSAGE のログエントリを生成します。

{
    "assistant_id": "{UUID}",
    "event_timestamp": 1751414298692,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "session_id": "{UUID}",
    "utterance": "[CUSTOMER]...",
    "prompt": "{prompt used}",
    "prompt_type": "SELF_SERVICE_PRE_PROCESS|SELF_SERVICE_ANSWER_GENERATION",
    "completion": "{Response from model}",
    "model_id": "{model id e.g.: us.amazon.nova-pro-v1:0}",
    "session_message_id": "{UUID}",
    "parsed_response": "{model response}"
}

Amazon Lex ログ記録: 「Amazon Lex V2 のエラーログを使用したエラーのログ記録」の手順に従って Amazon Lex ログ記録を有効にします。

Amazon Connect ログ記録: Amazon Connect フローに ログ記録動作の設定 フローブロックを追加して Amazon Connect ログ記録を有効にします。

症状: Amazon Connect ログに 顧客の入力を取得する ブロックの「内部サーバーエラー」が表示されます

原因: セルフサービスボットが 10 秒の制限内に結果を提供中にタイムアウトしました。タイムアウトエラーは Amazon Q in Connect ログに表示されません。

解決策: 複雑な推論を削除してプロンプトを簡素化し、処理時間を短縮します。

Amazon Q in Connect フローブロックがない: Amazon Connect フローに Amazon Q in Connect ブロックを追加していることを確認します。一般的な監視にこのブロックがないため、次のエラーが発生します。

com.amazonaws.services.lexruntimev2.model.ValidationException: Amazon Lex needs active session for Amazon Q in Connect. 
                            Please provide valid session attribute x-amz-lex:q-in-connect:session-arn

一般的な Amazon Lex エラー: Amazon Lex ログにエラーがないか確認し、それに応じて対処します。