아키텍처 해설 — 데이터부터 봇 권한까지
데이터 흐름·증빙 매칭·3층 시스템 구조·봇 설계(권한=근거의 함수)를 도식으로 해설합니다.개요·기술스택과LLM 운영·실험은 별도 탭에서.
데이터 흐름 — 변경 전 → 후
RAG가 답을 어떻게 끌어오는가. 예시 질문: “연말정산 AI는 어떻게 만들었어?”
이미지 증빙 흐름 — 변경 전 → 후
답변을 뒷받침하는 시각 자료를 어떻게 고르는가. 예시: “노란우산 대시보드 작업?”
시스템 아키텍처
프론트·백엔드 모두 블루-그린: 빌드 후 idle 포트에 후보를 띄워 헬스 통과 시에만 스위치 프록시 업스트림을 원자적으로 전환(verify-before-switch). 실패 시 전환 안 함 → 현 인스턴스가 계속 서빙(다운타임 0). 기존 연결은 옛 인스턴스로 graceful drain.
핵심 차별점: 검색 코퍼스를 사람이 큐레이션한 KB로 두고, 빈도가 아니라 큐레이션이 중요도·라우팅을 구동 — RAG의 빈도 편향(popularity bias)을 정면 교정.
봇 설계 — 권한은 근거(grounding)의 함수
오케스트레이션 점수를 떨어뜨린 환각의 정체: “봇 ≠ LLM”의 혼동. ‘봇’은 역할 그릇일 뿐, 안에 든 게 코드면 행동 가능·블라인드 LLM이면 자문 전용이다. 못 보는 블라인드 LLM에게 코드수정·시스템 판단을 위임한 것이 없는 파일경로 환각의 근원이었다.
결정론 봇 (코드)
할 일 · 측정 · flag · 빌드/헬스/롤백 · 배포 · dedup · 휴리스틱 채점
권한 · 행동·게이트 권한 OK — 검증가능한 ground truth에만 작동
metrics · perf_bot · deploy · auto_apply 가드 · qa 휴리스틱
블라인드 LLM (도구 없음)
할 일 · 해석 · 재서술 · 우선순위 · 가설·질문 초안
권한 · 자문·초안까지만 — 행동/코드 권한 금지, 하류 검증 필수
reviewer · rag · 관장(advise) · persona · ui_reviewer · auto_apply 패치생성
에이전트 Claude (도구+코드접근)
할 일 · 근거 있는 코드수정 · 진짜 상태판단 · grounded 분해
권한 · grounded 작업 위임 가능 — 비싸므로 선별 호출
headless_decompose(Claude) · 세션 Claude