문서 안내 오류 수정과 처리 결과 확인 분기

직원 수정 질문에 수정 문서를 연결하고, 화면만 보고 처리 결과를 추정하는 질문으로 분류되면 실제 내역을 먼저 확인하도록 안내합니다.

관리자·직원 앱·인사 시트의 AI 사용법 안내는 질문에 맞는 기능을 선택한 뒤, 조직·기능·시트 권한을 확인하고 허용된 문서 조각을 벡터 검색하여 답변을 생성합니다. 기능 정의는 안내할 업무를 문서 위치와 필요한 권한에 연결한 설정입니다. 색인 대상 15개 문서와 서버에 연결한 10개 기능의 범위는 현재 구조와 유지보수에 정리했습니다.

기존에는 직원 수정이 9개 기능에 없었고, 문서에 직원 등록 시 비밀번호 문자가 자동 발송된다는 잘못된 설명이 있었습니다. 또한 일반 사용법과 이미 시도한 요청의 실제 처리 결과를 구별하는 서버 분기가 없었습니다. 최종 변경은 문서 원문·기능 연결·상태 분기를 수정하며 기존 색인과 벡터 검색 코드는 유지합니다.

변경 전

변경 후

직원 수정은 관리자 가이드 s4-2와 직원 수정 권한에 연결합니다. 기존 등록은 s4-1을 사용합니다. 같은 절에 붙어 있는 비밀번호 SMS 발송·결재선 설정 등 별도 권한의 절차는 발췌 범위에서 제외하고, 등록 안내에는 실제 필요한 팀 수정 권한을 함께 확인합니다. 모델이 수정 기능을 올바르게 선택했을 때 해당 문서로 연결되는 것을 검증하며, 모든 수정 질문의 분류 성공을 보장하지 않습니다.

직원 등록 후 SMS는 별도 발송 동작이라는 점을 원고에 반영합니다. 시트 직원 추가 조건·행 정보 단축키·결재 확인창 설명도 실제 코드에 맞춥니다. 생성 가이드와 서버 문서 스냅샷을 함께 동기화합니다. 잘못된 원문을 유지한 채 답변 프롬프트만 강화하면 같은 오류를 답변 근거로 계속 공급하므로 원문을 직접 수정합니다.

일반 사용법과 최종 제출 전 확인창은 기존 답변 생성으로 처리합니다. 이미 최종 요청을 시도했거나 시도 여부가 불명확한 상황에서 결과를 추정하는 질문은, 실제 결과를 조회하지 않았다는 사실과 확인 전 재실행하지 말라는 고정 안내를 반환합니다. 권한·검색 검증 실패는 기존 실패 안내를 우선하고, 기능을 선택하지 못한 상태 질문에는 문서 링크 없이 고정 안내만 제공합니다. 실제 데이터 조회·변경 요청은 기존 업무 대화 경로를 사용합니다. 상태 확인 안내는 진단에 state_check_required로 구분하며 정답률에 합산하지 않습니다.

답변 생성 프롬프트는 기준 브랜치의 내용을 유지합니다. 분류에는 일반 사용법·제출 전·처리 결과 추정을 구별하는 필드와 기준만 추가합니다. 채택하지 않은 퓨샷·프레임워크·재시도 프롬프트 후보, 371개 수동 업무 목록, 전수 평가 실행기, 대규모 평가 결과와 저장 답변 재생 테스트는 최종 PR에서 제외합니다. 상시 의미 검토 호출도 추가하지 않습니다. 제거 직전 자료는 원래 커밋 c38fb4bd2와 별도 로컬 보관본에 남겨 두었습니다.

검증 범위

다음 검사는 외부 모델·검색 응답을 대체하여 문서 연결·상태 분기·권한·출처·형식 처리의 동작을 확인합니다. 자연어 분류와 생성 답변의 전체 정확도 향상을 입증하는 검사는 아닙니다. 분류 버전은 chat-intent-v11-state-check, 답변 경로 버전은 docs-guide-v21-state-check입니다.

pnpm --filter @hereby/api test src/services/ai/guidance src/services/ai/guide src/services/ai/agent.auto-guidance.test.ts src/services/ai/providers/anthropic.test.ts
pnpm check:docs-guides
pnpm check:ai-guidance
pnpm lint:check
pnpm build

정리 과정에서는 Claude·Voyage API와 실제 벡터 검색을 호출하지 않습니다. 실제 인덱스 동기화, 배포, 운영 활성화와 사용자 화면 확인은 별도 검증 대상입니다.