Chat·Community AI 지원 안정성과 관리자 응답 정책 개선

[dhslove]

개요

Synology Chat 한글 누적 문맥 장애, Community 오타·실행 안내 품질 문제, 관리자 직접 답변에 AI가 다시 반응하는 문제와 해결 대화의 Knowledge Base 변환 누락을 함께 수정합니다.

원인

• Chat 누적 문맥은 글자 수만 제한해 한글 UTF-8 Byte 상한을 넘을 수 있었음
• Community 답변은 명백한 오타를 차단 질문으로 처리하고 실행 서버·권한·서비스·로그 경로를 빠뜨릴 수 있었음
• Poller는 질문자와 Assistant가 아닌 모든 사람을 STAFF로 분류하면서도 responseRequested=true로 전달했음
• 따라서 관리자가 직접 지원 답변을 남겨도 AI가 불필요하게 다시 답변할 수 있었음
• 해결된 긴 대화의 KB 종합 질문은 16,000자까지 허용하지만 공식 자료 검색은 UTF-8 4,000바이트로 제한됨
• 제한된 검색 질문을 만들어 놓고 원본 종합 질문을 공식 검색에 전달해 ProviderContractError와 반복 재시도가 발생했음
• Gateway가 더 뒤의 Post까지 처리해도 Poller는 이전 Pending Post ID와 정확히 같지 않으면 완료로 인정하지 않았음
• Pending Post 때문에 Snapshot이 없는 동안 해결 답변이 선택되면 해결 상태 변경도 이벤트로 생성되지 않았음

변경 내용

• Chat 문맥과 Source 검색어 확장을 UTF-8 Byte 기준으로 제한
• Community 문맥 기반 오타 완화와 실행 가능한 CLI·로그 안내 검사
• AI Gateway 버전 0.16.10
• 질문자 Post만 기본 AI 응답 대상으로 유지
• 관리자·지원 담당자와 일반 참여자 Post는 문맥에 저장하고 자동 답변 억제
• @TechFlow-Assistant 또는 줄 시작 /ai 명시 호출만 비질문자의 AI 응답 허용
• 인용문·코드 블록 안의 호출 문자열 무시
• 해결 관리자·최종 KB selector·지원 담당자 ID를 신뢰된 지원 ID 집합으로 통합
• 응답 판정 사유를 Activepieces Flow와 Community Case 감사 이벤트에 전달
• 관리자 답변 이후 질문자 후속 질문에서 관리자 안내를 대화 문맥으로 재사용
• 긴 KB 대화의 공식 검색에는 UTF-8 4,000바이트 제한 검색 질문 사용
• Provider 계약 오류를 PROVIDER_CONTRACT_REJECTED로 기록해 일반 500으로 숨기지 않음
• 현재 Best Answer와 다른 오래된 Pending Resolution 자동 제거
• 같은 Discussion의 이후 Post까지 처리했으면 이전 Pending Post 완료로 인정
• Poller 실행 중 발견한 해결 토론은 Snapshot이 없어도 해결 이벤트 생성
• 최초 Bootstrap의 과거 토론 일괄 처리 방지 유지

검증

• WSL ext4 전체 AI Gateway 시험 348건 PASS
• Community Poller 집중 시험 38건 PASS
• Activepieces Flow·보호 서비스 계약 시험 13건 PASS
• Ruff 변경 파일 검사 통과
• OpenAPI 39개 Operation 재생성
• git diff --check 통과

운영 범위

• Gateway와 Community Poller만 0.16.10 이미지로 제한 교체
• Community 질문 Flow의 저장소 계약 갱신과 기존 Flow 하위 호환 유지
• DB Schema 변경 없음
• Source Reconciler와 GitHub→Chat Event Gateway는 변경하지 않음
• 관리자 일반 답변, 명시 호출, 질문자 후속 질문 순서로 실제 Community E2E 검증

운영 결과

• Gateway issue112-0.16.8-3047786, Poller issue113-0.16.8-8330d8c Healthy·Restart 0
• Gateway Provider OpenAI, Database·Vector Ready
• Discussion #178 관리자 Post #437: STAFF_RECORDED, AI 응답 없음
• 관리자 명시 호출 Post #438: EXPLICIT_AI_REQUEST, Assistant Post #439 게시
• E2E 중 발견한 이전 Post 반복 재시도를 Issue #113으로 보완
• Poller pendingPosts=0, failed=0, 기존 Post #434 Seen 처리
• Source Reconciler, GitHub→Chat Event Gateway, Activepieces App·Worker 불변
• 공개 Community·Chat HTTPS HTTP 200
• 백업 /home/ablecloud/techflow-ai-gateway-backups/issue112-staff-silence-20260902T090656Z
• 검증 보고서 docs/reports/issue-112-community-staff-ai-policy-validation.md
• Discussion #177의 KB 변환 경계 오류를 Issue #114로 추적하고 Gateway·Poller만 issue114-0.16.9-02061eb로 교체
• Discussion #177 KB Post #445를 같은 Post에서 보완해 공개·승인하고 최종 해결 답변으로 선택
• KB 원본 Post #441, KB 버전 2, Poller pendingPosts=0, pendingResolutions=0
• Issue 긴 Community 대화의 Knowledge Base 변환 경계 오류 수정 #114 배포 백업 /home/ablecloud/techflow-ai-gateway-backups/issue114-kb-boundary-20260904T011509Z
• Issue 긴 Community 대화의 Knowledge Base 변환 경계 오류 수정 #114 검증 보고서 docs/reports/issue-114-kb-long-conversation-recovery.md
• Discussion #181의 Post 진행 확인과 Snapshot 없는 해결 동기화 결함을 Issue #115로 추적
• Gateway·Poller를 issue115-0.16.10-bd44f72로 제한 교체하고 두 서비스 Healthy·Restart 0 확인
• Discussion #181 KB Post #465를 같은 Post에서 보완하고 최종 해결 답변으로 선택
• KB 원본 Post #456, KB 버전 2, 전체 pendingPosts=0, pendingResolutions=0
• Issue 후속 Post 진행 뒤 Community 해결 상태가 누락되는 문제 수정 #115 배포 백업 /home/ablecloud/techflow-ai-gateway-backups/issue115-resolution-progress-20260910T014611Z
• Issue 후속 Post 진행 뒤 Community 해결 상태가 누락되는 문제 수정 #115 검증 보고서 docs/reports/issue-115-community-resolution-progress-recovery.md

Closes #109
Closes #111
Closes #112
Closes #113
Closes #114
Closes #115