---
title: "이슈"
description: "분류하고 우선순위를 정할 수 있는 패턴별 반복 통화 문제와 AI 지원을 통한 해결 방법입니다."
---

**이슈** 페이지(`/dashboard/issues`, 품질 및 테스트 아래)에서는 통화 전반에서 감지된 문제를 수집하고 반복 발생을 **패턴**으로 그룹화합니다. 따라서 "에이전트가 잘못된 영업시간을 안내함"이 50번 발생해도 별도의 보고서 50개가 아니라 추세선이 포함된 하나의 행으로 표시됩니다.

## 이슈의 발생 원인

- **시스템** — ThunderPhone의 통화 분석이 통화 중 문제가 발생한 것을 감지하면 자동으로 생성됩니다.
- **사용자** — 사용자가 생성합니다. 통화 세부 정보 페이지에서 보고하거나 [이슈 보고 API](/api-reference/issue-reports)를 통해 등록할 수 있습니다.

각 이슈에는 **심각도**가 있습니다. 심각, 경고 또는 정보입니다.

## 분류

각 패턴 행에는 심각도, 발생 **추세** 스파크라인, 영향을 받은 **통화** 수, **상태**, 마지막으로 감지된 시점이 표시됩니다. 상태는 다음과 같습니다.

| 상태 | 의미 |
| --- | --- |
| **열림** | 확인이 필요합니다. 기본 보기에는 이 상태만 표시됩니다. |
| **해제됨** | 확인되었지만 조치하지 않습니다. |
| **해결됨** | 수정되었습니다. 새 발생 건이 있으면 패턴이 다시 상단으로 이동합니다. |

상태 컨트롤에서 인라인으로 패턴 상태를 변경하거나, 여러 행("일치하는 항목 모두" 포함)을 선택하여 일괄 업데이트할 수 있습니다.

필터 칩은 열을 반영합니다. **상태**(기본값: 열림), **심각도**, **소스**, 자유 텍스트 **검색**(제목, 추적 또는 통화 ID), **날짜** 범위 및 **필터 재설정**을 사용할 수 있습니다.

## 패턴 자세히 살펴보기

행을 클릭하여 세부 정보 패널을 엽니다. 패턴 설명, 발생 이력, 영향을 받은 통화가 표시되며, 각 항목은 통화 이력의 전체 트랜스크립트로 연결되어 문맥에서 실패 내용을 확인할 수 있습니다.

### AI로 수정

AI로 수정하려면 영향을 받은 통화 중 하나 이상에 녹음된 오디오가 필요합니다. 녹음이 비활성화된 동안 이루어진 통화는 재생할 수 없습니다. 조사는 저장된 턴을 재생하며, 실제 통화를 연결하거나 과금되는 시뮬레이션 통화를 생성하지 않습니다.

세부 정보 패널에서 **AI로 수정**을 선택하면 문제가 여전히 재현되는지 확인한 다음, 영향을 받은 턴과 정상 비교 통화를 대상으로 집중적인 프롬프트 변경을 테스트합니다. 결과에는 변경 전후 재생률, 감지된 부작용, 이슈가 **수정됨** 또는 **개선됨** 상태인지가 표시됩니다. 적용하기 전에 가장 적합한 변경 제안을 검토합니다. 언제든 페이지를 떠날 수 있으며, **수정 재개**를 선택하면 저장된 조사로 돌아갑니다.

자동으로 적용되는 변경은 없습니다.

- **수정 적용**은 에이전트의 초안에 프롬프트 변경을 준비합니다.
- **적용 및 배포**는 변경을 준비하고 즉시 배포합니다.

두 작업 모두 관련 없는 초안 편집을 유지합니다. 배포하기 전까지는 현재 배포된 프롬프트가 계속 활성 상태로 유지됩니다.

오디오를 재구성할 수 없으면 조사는 **재생 불가**로 종료됩니다. 이슈가 더 이상 나타나지 않으면 **재현 불가**로 종료됩니다. 확인 전에 재생 예산이 소진되면 에이전트를 변경하지 않고 중지됩니다.

ThunderPhone은 테스트한 프롬프트 섹션에 대해 변경되지 않은 일치 항목을 정확히 하나만 계속 찾을 수 있을 때만 변경을 적용합니다. 관련 없는 초안 편집은 유지됩니다. 해당 섹션이 변경되었거나 둘 이상의 위치와 일치하면 적용 시 충돌이 보고됩니다. 적용하기 전에 현재 프롬프트를 대상으로 조사를 다시 실행합니다. 전체 상태 및 재생 객체는 [조사 API 참조](/api-reference/investigations)를 확인하세요.

### ThunderPhone에 보고

조사에서 안전한 프롬프트 수정 방법을 찾지 못하면 **ThunderPhone에 보고**를 선택합니다. ThunderPhone은 일부 미해결 조사를 자동으로 라우팅하기도 합니다. 조직 전체 웹훅을 사용하는 경우 `issue.escalated` 이벤트를 통해 이슈 패턴이 보고되었는지와 보고가 자동으로 이루어졌는지 확인할 수 있습니다. [이슈 웹훅 구성](/ko/webhooks/events).

## 다음 단계

<CardGroup cols={2}>
  <Card title="알림" icon="bell" href="/ko/guides/alerts">
    이슈가 누적되기 전에 품질 지표가 저하될 때 알림을 받으세요.
  </Card>
  <Card title="시뮬레이션" icon="flask" href="/ko/guides/test-agents">
    수정된 이슈를 회귀 테스트 시나리오로 전환하세요.
  </Card>
</CardGroup>