---
title: "問題"
description: "繰り返し発生する通話の問題をパターン別に整理し、トリアージとAIによる修正を支援します。"
---

**問題**ページ（品質とテスト内の`/dashboard/issues`）では、通話全体で検出された問題を収集し、繰り返し発生する事象を**パターン**としてグループ化します。これにより、「エージェントが誤った営業時間を案内した」という問題が50件発生した場合も、50件の個別レポートではなく、トレンドライン付きの1行として表示されます。

## 問題の発生元

- **システム** — ThunderPhoneの通話分析が、通話中に問題を検出すると自動的に起票します。
- **ユーザー** — 通話の詳細ページから報告するか、[問題レポートAPI](/api-reference/issue-reports)を通じて起票します。

各問題には、**重大度**（重大、警告、情報）が設定されます。

## トリアージ

各パターン行には、重大度、発生**トレンド**のスパークライン、影響を受けた**通話数**、**ステータス**、最後に検出された日時が表示されます。ステータスは次のとおりです。

| ステータス | 意味 |
| --- | --- |
| **未対応** | 対応が必要です。デフォルトのビューにはこのステータスのみ表示されます。 |
| **却下** | 確認済みであり、対応は行いません。 |
| **解決済み** | 修正済みです。新たに発生すると、パターンが一覧の上部に戻ります。 |

ステータスコントロールからパターンのステータスをインラインで変更できます。また、複数の行（「すべての一致行」を含む）を選択して一括更新することもできます。

フィルタチップは列に対応しています。**ステータス**（デフォルトは未対応）、**重大度**、**発生元**、自由入力の**検索**（タイトル、トレース、または通話ID）、**日付**範囲、および**フィルタをリセット**です。

## パターンを詳しく確認する

行をクリックすると詳細パネルが開きます。パターンの説明、発生履歴、影響を受けた通話が表示されます。各通話は通話履歴内の完全な文字起こしにリンクしているため、問題を文脈の中で確認できます。

### AIで修正

AIで修正するには、影響を受けた通話のうち少なくとも1件の録音音声が必要です。録音が無効な状態で行われた通話は再生できません。調査では保存されたターンを再生します。ライブ通話を発信したり、課金対象のシミュレーション通話を作成したりすることはありません。

詳細パネルから**AIで修正**を選択すると、問題が引き続き再現するかを確認し、影響を受けたターンと問題のない比較通話に対して、対象を絞ったプロンプト変更をテストします。結果には、変更前後のリプレイでの発生率、検出された副作用、問題が**修正済み**か**改善済み**かが表示されます。適用前に、最も効果的だった修正差分を確認します。いつでもページを離れることができます。**修正を再開**を選択すると、保存された調査に戻れます。

変更が自動的に適用されることはありません。

- **修正を適用**では、エージェントの下書きにプロンプト変更を追加します。
- **適用してデプロイ**では、変更を下書きに追加し、直ちにデプロイします。

どちらの操作でも、関連しない下書き編集は保持されます。デプロイするまで、現在デプロイされているプロンプトが引き続き有効です。

音声を再構築できない場合、調査は**再生不可**として終了します。問題が表示されなくなった場合は、**再現不可**として終了します。また、確認前にリプレイ予算が終了した場合も、エージェントを変更せずに停止します。

ThunderPhoneは、テストされたプロンプトセクションに対して変更されていない一致箇所を1つだけ特定できる場合にのみ、変更を適用します。関連しない下書き編集は保持されます。そのセクションが変更されているか、複数の箇所に一致する場合、適用時に競合が報告されます。適用する前に、現在のプロンプトに対して調査を再実行してください。完全なステータスとリプレイオブジェクトについては、[調査APIリファレンス](/api-reference/investigations)を参照してください。

### ThunderPhoneに報告

調査で安全に適用できるプロンプト修正が見つからない場合は、**ThunderPhoneに報告**を選択します。ThunderPhoneは、一部の未解決の調査を自動的にルーティングすることもあります。組織全体のWebhookを使用している場合、`issue.escalated`イベントにより、問題パターンが報告されたことと、その報告が自動かどうかを確認できます。[問題Webhookを設定する](/ja/webhooks/events)。

## 次のステップ

<CardGroup cols={2}>
  <Card title="アラート" icon="bell" href="/ja/guides/alerts">
    問題が蓄積する前に、品質指標の低下に関する通知を受け取ります。
  </Card>
  <Card title="シミュレーション" icon="flask" href="/ja/guides/test-agents">
    修正済みの問題を回帰テストシナリオに変換します。
  </Card>
</CardGroup>
