마지막 대화 종료조건으로 남은 대화 건너뛰기

마지막 업데이트 2026-11-18

9cac2f03 charles-na · 2026-11-18 Feature 11 files +482 −45 PR #1333 · PPI-1454

대화 스텝이 여러 개인 활동에서, AI가 앞선 대화 스텝에서 마지막 대화 스텝의 종료조건을 말하면 대화종료 프리셋 없이도 남은 대화를 건너뛰고 마지막 대화 뒤 자료(없으면 다음 활동)로 이동한다. 대화종료 프리셋은 AI 스텝에서 메시지만 보낸다. 리뷰 시 먼저 볼 지점은 resolveAutoFinishDecision의 새 분기와 createAutoFinishConfigFromStep의 문구 병합 순서다.

무엇이, 왜 바뀌었나

이전에는 마지막 대화 종료조건이 대화종료 프리셋을 눌렀을 때만 활성화돼, 프리셋 없이 AI가 앞 스텝에서 마무리 발화를 해도 다음 대화 스텝으로 한 칸만 이동했다. 이번 변경은 활동 문맥(steps + 현재 stepIndex)을 autoFinish 설정 생성에 넘겨 마지막 대화 문구를 항상 함께 감시한다.

흐름 — AI 발화에서 스텝 이동까지

1

스텝 진입 시 autoFinish 설정 생성 (마지막 대화 문구를 앞에 병합)

lib/activity-utils.ts ← use-ai-session · use-step-transition · use-step-navigation(취소 복원)

2

AI 발화 문구 매칭 → matchedCondition 반환 (1초 디바운스)

hooks/use-session-auto-finish.ts (변경 없음)

3

영상 전환 대상이면 AI 신규 응답 차단 — 대상 스텝을 마지막 대화 다음으로 계산

use-step-navigation.ts · handleAssistantAutoFinishPhraseMatched

4

판정: 예약 없음 + 마지막 대화 문구 → move_to_trailing_step / 다음 활동 강제

lib/step-navigation.ts · resolveAutoFinishDecision

코드로 보는 핵심 지점

1. 판정 분기 — 예약이 없을 때만 마지막 대화 종료조건 적용

apps/web/entities/guest-page-session/lib/step-navigation.ts + if (mode == null && input.matchedCondition != null) { + const activityEnd = resolveActivityEndCondition(currentActivity?.steps, currentStepIndex); + if (activityEnd?.phrases.includes(input.matchedCondition)) { + if (activityEnd.nextStepIndex != null) { + return { kind: "move_to_trailing_step", stepIndex: activityEnd.nextStepIndex }; + } + return { kind: "go_to_next_step", forceNextActivity: true, ... };

문자열 일치(includes)로 판정하므로 config 문구와 판정 문구가 같은 trim 규칙을 써야 한다 — 둘 다 resolveActivityEndCondition을 거쳐 일치한다.

2. 설정 병합 — 마지막 대화 문구가 먼저 매칭

apps/web/lib/activity-utils.ts - if (!step || (...) || !step.autoFinishEnabled) return null; + if (!step.autoFinishEnabled && activityEndPhrases.length === 0) return null; + type: (step.autoFinishEnabled && step.autoFinishType) || "after-pingpong-speech", + phrases: [...activityEndPhrases, ...stepPhrases],

현재 스텝 autoFinish가 꺼져 있어도 마지막 대화 문구가 있으면 켜진다. 종료 방식(type)은 현재 스텝 것을 따른다.

3. 대화종료 프리셋 — 메시지만

apps/web/entities/guest-page-session/lib/step-navigation.ts + if (mode === "next-activity") { + return { kind: "message_only", plan }; + } - textMessage: mode === "checkout" ? (...) : null, + textMessage: hasEmergencyExit ? "{{긴급종료}}" : "대화종료",

비-AI 스텝(영상·이미지·자료)은 이 분기 앞의 apply_immediately에서 처리되므로 여전히 버튼으로 즉시 이동한다.

레이어별 변경 요약

레이어파일핵심 변경
공용 libapps/web/lib/conversation-end.tsresolveActivityEndCondition 추가 — 마지막 prompt/hybrid 스텝의 문구·다음 스텝 인덱스
공용 libapps/web/lib/activity-utils.tscreateAutoFinishConfigFromStep에 activity 문맥 인자, 문구 병합
순수 판정guest-page-session/lib/step-navigation.tsmatchedCondition 판정 분기, message_only 결과
훅guest-page-session/model/use-step-navigation.ts영상 게이트 대상 계산, message_only 처리, 취소 복원 문맥
훅use-step-transition.ts, guest-session/model/use-ai-session.tsconfig 생성에 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 원인분석 — 종료멘트·대화종료 프리셋 경로의 이전 이슈