턴 검사기
턴 검사기는 사용자 요청 한 건이 어떤 테넌트와 사용자로 실행됐고, 어떤 프롬프트·모델·도구를 사용했는지 확인하는 진단 화면입니다. 답변 오류, 권한 문제와 예상치 못한 도구 실행을 재현할 때 사용합니다.
개요
각 턴은 Turn ID와 Conversation ID로 구분됩니다. 목록에는 요청 요약, 적용된 Prompt Profile ID와 AI Model Config ID, 토큰 사용량, 도구 호출 수, 성공 여부와 오류 코드가 표시됩니다.
턴 찾기
- 대상 테넌트를 선택합니다.
- 사용자 또는 Conversation ID로 범위를 좁힙니다.
- 발생 시각과 요청 요약으로 문제 턴을 찾습니다.
- 턴을 열어 모델·프롬프트와 도구 호출을 확인합니다.
- 앞뒤 턴을 비교해 대화 문맥이 이어졌는지 확인합니다.
확인 항목
| 항목 | 설명 |
|---|---|
| Tenant ID | 데이터와 구성을 격리하는 회사 식별자입니다. |
| Owner User ID | 턴을 실행한 실제 사용자 식별자입니다. |
| Prompt Profile ID | 해당 턴에 적용된 시스템 프롬프트 구성입니다. |
| AI Model Config ID | 호출한 모델과 게이트웨이 구성입니다. |
| Prompt·Completion Tokens | 입력과 출력에 사용한 토큰 수입니다. |
| Reasoning Tokens | Provider가 제공하는 경우 기록되는 추론 토큰입니다. |
| Tool Call Count | 턴에서 시도한 도구 호출 수입니다. |
| Error Code | 실패 원인을 분류한 코드입니다. |
결과 분석
답변 내용이 예상과 다르면 먼저 Prompt Profile ID와 Model ID가 기대한 구성인지 확인합니다. 데이터가 잘못 섞였다고 의심되면 Tenant ID와 Owner User ID를 우선 확인합니다. 도구 호출이 없으면 모델이 도구를 선택하지 않은 것인지, 정책에서 차단된 것인지 실행 이벤트를 비교해야 합니다.
재현할 때
원본 입력을 그대로 다시 보내기 전에 해당 턴의 모델 버전, 프롬프트와 도구 카탈로그가 변경되지 않았는지 확인합니다. 운영 데이터에 영향을 주는 쓰기 도구가 포함됐다면 동일 요청을 운영 환경에서 재실행하지 말고 읽기 전용 또는 시험 테넌트에서 검증하십시오.
개인정보와 보안
턴에는 사용자가 입력한 업무 내용과 도구 인수가 포함될 수 있습니다. 필요한 범위만 확인하고 외부 이슈나 화면 캡처에 원문을 그대로 첨부하지 마십시오. API 키와 인증 헤더는 턴 진단 정보에 저장하거나 복사하지 않습니다.
문제 해결
- 턴이 보이지 않으면 테넌트, 사용자와 조회 기간을 확인합니다.
- 토큰이 비어 있으면 Provider가 사용량을 반환했는지 확인합니다.
- 도구 수가 있는데 결과가 없으면 정책 결정과 실행 오류를 확인합니다.
- 실패 코드가 없는데 응답이 중단됐으면 연결 종료와 시간 제한 로그를 확인합니다.