Files
hyungi_document_server/app/services/prompt_versions.py
T
Hyungi Ahn 99672292d3 fix(policy): use container-compatible imports (drop app. prefix)
프로덕션 컨테이너는 /app 을 cwd 로 실행하고 import 는 `from api...`,
`from core...`, `from workers...` 처럼 무접두 스타일을 사용한다.
PR-A 내부 import 가 `from app.policy...`, `from app.ai.envelope` 로
되어 있어서 컨테이너에서 ModuleNotFoundError 발생.

변경:
- app/policy/*.py: `from app.policy.X` → `from policy.X`
- app/services/prompt_versions.py: lazy import 도 `from policy.prompt_render`
- app/ai/envelope.py: 영향 없음 (내부 import 없음)
- tests/policy/*.py: 모두 `from policy.X` / `from ai.envelope` 로 통일
- tests/policy/conftest.py: 로컬 pytest 용 sys.path.insert(app/) 추가
  (MacBook 에서 repo-root 기준 실행 시 app/ 를 package root 로 취급)

CI: pytest tests/policy/ -q → 98 passed (로컬, 동일 결과)
프로덕션: docker exec fastapi python -c "from policy.loader import load_policy" → OK

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 09:42:24 +09:00

63 lines
2.7 KiB
Python

"""프롬프트/모델 버전 상수 — telemetry 기록용 (Phase E.1)
목적: ask_events / analyze_events 에 prompt_version 과 model_name 을 기록해서
튜닝 전/후 비교와 실험 분기를 식별 가능하게 함.
규칙:
- 프롬프트 파일이 의미 있게 바뀌면 해당 상수 문자열을 bump (예: v1-400char → v2-600char)
- 하드코딩 금지. 파이프라인은 여기 상수만 참조.
- 모델명은 런타임 config(settings.ai.primary.model)에서 읽어서 resolve_primary_model() 사용.
E.3 배포 타임라인:
- v1-400char → 현재 (search_synthesis.txt 17행 "400 characters max")
- v2-600char → E.3 배포 시 bump (동일 파일 "600 characters max")
"""
from __future__ import annotations
# ─── ask (/search/ask) 프롬프트 버전 ─────────────────────────
# synthesis_service.py 가 로드하는 app/prompts/search_synthesis.txt 기준
ASK_PROMPT_VERSION: str = "search_synthesis.v2-600char"
# ─── /analyze 프롬프트 버전 ──────────────────────────────────
# documents.py analyze 라우트가 로드하는 app/prompts/document_analyze.txt 기준
ANALYZE_PROMPT_VERSION: str = "document_analyze.v1"
def resolve_primary_model() -> str | None:
"""런타임 config에서 primary 모델명을 resolve.
settings.ai 가 미구성이면 None.
telemetry 기록은 None 허용 (측정 필드는 nullable).
"""
try:
from core.config import settings
if settings.ai and settings.ai.primary:
return settings.ai.primary.model
except Exception:
pass
return None
# ─── Policy-layer prompt version helper (PR-A) ──────────────────────
# domain_policy.yaml + 정책 template 의 결합 해시로 automatic version 산출.
# analyze_events.policy_version 컬럼에 기록되어 drift 추적.
#
# 기존 ASK_PROMPT_VERSION / ANALYZE_PROMPT_VERSION 상수는 그대로 유지 — PR-B 에서
# 정책 렌더된 프롬프트로 전환 시 compute_policy_version() 결과로 대체할지 병기할지 결정.
def compute_policy_version(
task: str, *, policy_path: str | None = None
) -> str:
"""sha256(yaml_bytes + template_bytes)[:12] — deterministic hash.
task: policy template 이름 (예: 'p3a_short_summary'). app/prompts/policy/ 하위.
policy_path: override (테스트용). None 이면 loader 기본값.
import 지연 — app.policy 는 아직 worker 경로에서 쓰지 않는다 (PR-A 런타임 격리).
"""
from policy.prompt_render import policy_version as _pv
return _pv(task, policy_path=policy_path)