마지막 업데이트 2026-11-18
대화 스텝이 여러 개인 활동에서, AI가 앞선 대화 스텝에서 마지막 대화 스텝의 종료조건을 말하면 대화종료 프리셋 없이도 남은 대화를 건너뛰고 마지막 대화 뒤 자료(없으면 다음 활동)로 이동한다. 대화종료 프리셋은 AI 스텝에서 메시지만 보낸다. 리뷰 시 먼저 볼 지점은 resolveAutoFinishDecision의 새 분기와 createAutoFinishConfigFromStep의 문구 병합 순서다.
이전에는 마지막 대화 종료조건이 대화종료 프리셋을 눌렀을 때만 활성화돼, 프리셋 없이 AI가 앞 스텝에서 마무리 발화를 해도 다음 대화 스텝으로 한 칸만 이동했다. 이번 변경은 활동 문맥(steps + 현재 stepIndex)을 autoFinish 설정 생성에 넘겨 마지막 대화 문구를 항상 함께 감시한다.
대화1 → 대화2 → 영상1 → 영상2에서 대화1 중 충족 → 영상1 → 영상2 → 다음 활동forceNextActivity로 기존 활동 이동 설정(jumpConfig)을 그대로 거친다sourceStepIndex <= currentStepIndex면 null)arm_ai_step은 checkout 전용이 됐다스텝 진입 시 autoFinish 설정 생성 (마지막 대화 문구를 앞에 병합)
lib/activity-utils.ts ← use-ai-session · use-step-transition · use-step-navigation(취소 복원)
AI 발화 문구 매칭 → matchedCondition 반환 (1초 디바운스)
hooks/use-session-auto-finish.ts (변경 없음)
영상 전환 대상이면 AI 신규 응답 차단 — 대상 스텝을 마지막 대화 다음으로 계산
use-step-navigation.ts · handleAssistantAutoFinishPhraseMatched
판정: 예약 없음 + 마지막 대화 문구 → move_to_trailing_step / 다음 활동 강제
lib/step-navigation.ts · resolveAutoFinishDecision
문자열 일치(includes)로 판정하므로 config 문구와 판정 문구가 같은 trim 규칙을 써야 한다 — 둘 다 resolveActivityEndCondition을 거쳐 일치한다.
현재 스텝 autoFinish가 꺼져 있어도 마지막 대화 문구가 있으면 켜진다. 종료 방식(type)은 현재 스텝 것을 따른다.
비-AI 스텝(영상·이미지·자료)은 이 분기 앞의 apply_immediately에서 처리되므로 여전히 버튼으로 즉시 이동한다.
| 레이어 | 파일 | 핵심 변경 |
|---|---|---|
| 공용 lib | apps/web/lib/conversation-end.ts | resolveActivityEndCondition 추가 — 마지막 prompt/hybrid 스텝의 문구·다음 스텝 인덱스 |
| 공용 lib | apps/web/lib/activity-utils.ts | createAutoFinishConfigFromStep에 activity 문맥 인자, 문구 병합 |
| 순수 판정 | guest-page-session/lib/step-navigation.ts | matchedCondition 판정 분기, message_only 결과 |
| 훅 | guest-page-session/model/use-step-navigation.ts | 영상 게이트 대상 계산, message_only 처리, 취소 복원 문맥 |
| 훅 | use-step-transition.ts, guest-session/model/use-ai-session.ts | config 생성에 activity 문맥 전달 (use-ai-session의 인라인 생성 코드 통합) |
| 테스트 | conversation-end.test.ts, activity-utils.auto-finish.test.ts, step-navigation 테스트 2개, package.json | 신규 11건 + 판정·훅 9건, test:guest-page-session에 편입 |
영상·이미지·자료 스텝에서 대화종료 프리셋은 여전히 즉시 이동한다. "버튼만으로 이동하지 않는다"를 글자 그대로 적용하면 이 스텝에서 버튼이 무동작이 된다.
마지막 대화 스텝의 종료조건이 꺼져 있거나 문구가 없으면 프리셋으로 이동하지 않는다. 이전에는 프리셋이 종료 문구(없으면 기본 "대화 종료")를 강제로 걸어 이동했다. 운영 활동 설정에 해당 케이스가 있는지 데이터 확인 필요.
마지막 대화 문구로 이동할 때도 현재 스텝의 종료 방식을 따른다 — 현재 스텝이 after-child-speech면 아동 발화 또는 5초 대기 후 이동.
대화 사이 자료도 건너뛴다: 대화1 → 영상A → 대화2 → 영상B에서 대화1 중 충족 시 영상A를 건너뛰고 영상B로 이동.
중복 수신은 기존 1초 디바운스와 스텝 이동 시 config 재생성으로 한 번만 이동한다. 시간종료 경로·문구는 동일. 단위 테스트 통과, 실기기·실수업 미검증.
관련 문서: Activity 시스템 · step · jumpConfig · autoFinish 코드레벨 동작흐름 — autoFinish 설정과 활동 이동의 기존 구조
관련 문서: 종료멘트 자동전환 실패 및 진행자 대화종료 drop 원인분석 — 종료멘트·대화종료 프리셋 경로의 이전 이슈