- Merge internal-eval into development.sh (single Celery/infra); internal-eval.sh wraps with LIFE_ECHO_WITH_INTERNAL_EVAL; EVAL_ATTACH_ONLY for attaching 8001 when :8000 is already up; document in api/docs/internal-eval.md. - Evaluation: transcript_for_judge, judge error surfacing, rubric/schema tweaks, execution_service and router updates; tests for judge and composite eval. - Memory: ingest nested transaction for embedding/enrichment rollback safety. - Conversation WS: logger.exception for pipeline errors (avoid loguru KeyError). - app-eval-web: Playground saved replays, dialogue turns helper, hash user_id for Memoir; Memoir chapter baseline↔DB row compare with title heuristics; Stories page (#memoir-stories); Markdown + copy buttons; toolbar/panel UI; react-markdown; development proxy and fixture updates.
460 lines
16 KiB
Python
460 lines
16 KiB
Python
"""执行单次评测 run 与整实验(供 Celery / 内联调试)。"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from datetime import datetime, timezone
|
||
from typing import Any
|
||
|
||
from sqlalchemy.ext.asyncio import AsyncSession
|
||
|
||
from app.core.config import settings
|
||
from app.core.db import AsyncSessionLocal
|
||
from app.core.dependencies import get_eval_judge_langchain_llm, get_llm_provider
|
||
from app.core.logging import get_logger
|
||
from app.features.evaluation import repo as eval_repo
|
||
from app.features.evaluation.candidate_runner import (
|
||
EvalCandidateRunner,
|
||
simple_memoir_from_transcript,
|
||
)
|
||
from app.features.evaluation.gate_report_service import gate_result_to_details
|
||
from app.features.evaluation.gating_service import compute_gate
|
||
from app.features.evaluation.judge_service import EvalJudgeService
|
||
from app.features.evaluation.models import EvalCase, EvalRun, EvalVersion
|
||
from app.features.evaluation.transcript_for_judge import (
|
||
assistant_text_for_eval_display,
|
||
format_eval_turn_block,
|
||
)
|
||
|
||
logger = get_logger(__name__)
|
||
|
||
_MAX_JUDGE_MARKDOWN_CHARS = 20_000
|
||
_MAX_EVAL_CHAPTERS = 30
|
||
_MAX_EVAL_STORIES = 40
|
||
_MAX_EVIDENCE_CONVERSATIONS = 8
|
||
_MAX_EVIDENCE_TRANSCRIPT_CHARS = 16_000
|
||
|
||
|
||
def _clip_md_for_judge(text: str, max_chars: int = _MAX_JUDGE_MARKDOWN_CHARS) -> str:
|
||
s = (text or "").strip()
|
||
if len(s) <= max_chars:
|
||
return s
|
||
return f"{s[:max_chars]}\n\n…(已截断供评审)"
|
||
|
||
|
||
def _composite(
|
||
conv: float | None, mem: float | None, weights: dict[str, Any] | None
|
||
) -> float | None:
|
||
"""合成总分;缺失的一侧不计为 0,避免把评审失败误标为极差。
|
||
|
||
仅一侧有分:返回该侧原始分(不乘权重),表示当前 run 仅完成了部分评审维度。
|
||
"""
|
||
w = weights or {}
|
||
wc = float(w.get("conversation", 0.5))
|
||
wm = float(w.get("memoir", 0.5))
|
||
has_c = conv is not None
|
||
has_m = mem is not None
|
||
if not has_c and not has_m:
|
||
return None
|
||
if has_c and has_m:
|
||
return float(wc) * float(conv) + float(wm) * float(mem)
|
||
if has_c:
|
||
return float(conv)
|
||
return float(mem)
|
||
|
||
|
||
def _utterances_for_case(case: EvalCase) -> list[str]:
|
||
raw = case.user_utterances or []
|
||
return [str(u).strip() for u in raw if str(u).strip()]
|
||
|
||
|
||
def _trim_evidence_text(text: str, max_chars: int = _MAX_EVIDENCE_TRANSCRIPT_CHARS) -> str:
|
||
s = (text or "").strip()
|
||
if len(s) <= max_chars:
|
||
return s
|
||
return f"{s[:max_chars]}\n\n…(访谈证据已截断)"
|
||
|
||
|
||
def _dialogue_transcript_from_pairs(pairs: list[tuple[str, str]]) -> str:
|
||
parts: list[str] = []
|
||
for role, content in pairs:
|
||
body = (content or "").strip()
|
||
if not body:
|
||
continue
|
||
label = "用户" if role == "human" else "AI"
|
||
out = assistant_text_for_eval_display(body) if role != "human" else body
|
||
parts.append(f"{label}: {out}")
|
||
return "\n\n".join(parts)
|
||
|
||
|
||
async def _conversation_transcript_for_eval(
|
||
db: AsyncSession, conversation_id: str
|
||
) -> str:
|
||
from app.features.conversation import repo as conversation_repo
|
||
|
||
rows = await conversation_repo.get_conversation_messages(conversation_id, db)
|
||
return _dialogue_transcript_from_pairs(
|
||
[(str(row.role or "").lower(), str(row.content or "")) for row in rows]
|
||
)
|
||
|
||
|
||
async def _user_transcript_evidence(db: AsyncSession, user_id: str) -> str:
|
||
from app.features.conversation import repo as conversation_repo
|
||
|
||
conversations = await conversation_repo.get_user_conversations(user_id, db)
|
||
if not conversations:
|
||
return ""
|
||
parts: list[str] = []
|
||
for conv in reversed(conversations[:_MAX_EVIDENCE_CONVERSATIONS]):
|
||
transcript = await _conversation_transcript_for_eval(db, str(conv.id))
|
||
if transcript:
|
||
parts.append(f"## 会话 {str(conv.id)}\n{transcript}")
|
||
return _trim_evidence_text("\n\n".join(parts))
|
||
|
||
|
||
async def execute_eval_run(
|
||
db: AsyncSession,
|
||
*,
|
||
run: EvalRun,
|
||
case: EvalCase,
|
||
version: EvalVersion,
|
||
) -> None:
|
||
if not settings.eval_execution_enabled:
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="failed",
|
||
error_message="EVAL_EXECUTION_ENABLED=false",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
return
|
||
|
||
utterances = _utterances_for_case(case)
|
||
if not utterances:
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="failed",
|
||
error_message="empty user_utterances",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
return
|
||
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="running",
|
||
started_at=datetime.now(timezone.utc),
|
||
error_message=None,
|
||
)
|
||
await db.commit()
|
||
|
||
provider_llm = getattr(get_llm_provider(), "langchain_llm", None)
|
||
if provider_llm is None:
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="failed",
|
||
error_message="生产 LLM 未配置",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
return
|
||
|
||
judge_llm = get_eval_judge_langchain_llm()
|
||
judge = EvalJudgeService(judge_llm)
|
||
runner = EvalCandidateRunner(provider_llm)
|
||
cfg = version.config_json if isinstance(version.config_json, dict) else None
|
||
|
||
try:
|
||
replies, latencies = await runner.replay_utterances(
|
||
utterances,
|
||
version_config=cfg,
|
||
temperature=settings.eval_candidate_temperature,
|
||
)
|
||
except Exception as e:
|
||
logger.exception("eval replay failed: {}", e)
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="failed",
|
||
error_message=str(e)[:2000],
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
return
|
||
|
||
transcript_parts: list[str] = []
|
||
for i, u in enumerate(utterances):
|
||
if i >= len(replies):
|
||
break
|
||
transcript_parts.append(
|
||
format_eval_turn_block(i, u, assistant_text_for_eval_display(replies[i]))
|
||
)
|
||
prior_blocks: list[str] = []
|
||
for idx, u in enumerate(utterances):
|
||
if idx >= len(replies):
|
||
break
|
||
reply = assistant_text_for_eval_display(replies[idx])
|
||
lat = latencies[idx] if idx < len(latencies) else None
|
||
prior = "\n\n".join(prior_blocks)
|
||
if len(prior) > 8000:
|
||
prior = prior[-8000:]
|
||
tj = await judge.judge_turn(
|
||
prior_transcript=prior,
|
||
user_utterance=u,
|
||
assistant_reply=reply,
|
||
turn_index_0=idx,
|
||
)
|
||
scores = tj.model_dump() if tj else None
|
||
rationale = tj.rationale if tj else None
|
||
await eval_repo.add_turn(
|
||
db,
|
||
run_id=str(run.id),
|
||
turn_index=idx,
|
||
user_utterance=u,
|
||
assistant_reply=replies[idx],
|
||
duration_ms=lat,
|
||
judge_scores_json=scores,
|
||
judge_rationale=rationale,
|
||
)
|
||
await db.commit()
|
||
prior_blocks.append(format_eval_turn_block(idx, u, reply))
|
||
|
||
full_transcript = "\n\n".join(transcript_parts)
|
||
conv_out = await judge.judge_conversation(full_transcript=full_transcript)
|
||
conv_total = conv_out.total_score if conv_out else None
|
||
|
||
memoir_md = simple_memoir_from_transcript(utterances, replies)
|
||
source_transcript = _trim_evidence_text(full_transcript)
|
||
reference_memoir = (case.reference_memoir_markdown or "").strip()
|
||
mem_out = await judge.judge_memoir(
|
||
memoir_markdown=memoir_md,
|
||
source_transcript=source_transcript,
|
||
reference_memoir_markdown=reference_memoir,
|
||
evidence_notes="严格按文档核对真实性、覆盖率、可追溯性;以原始访谈为主,参考基线仅作辅助。",
|
||
)
|
||
|
||
chapter_entries: list[dict[str, Any]] = []
|
||
story_entries: list[dict[str, Any]] = []
|
||
uid = (case.source_user_id or "").strip()
|
||
source_conversation_id = (case.source_conversation_id or "").strip()
|
||
evidence_transcript = source_transcript
|
||
if source_conversation_id:
|
||
try:
|
||
conversation_evidence = await _conversation_transcript_for_eval(
|
||
db, source_conversation_id
|
||
)
|
||
if conversation_evidence:
|
||
evidence_transcript = _trim_evidence_text(conversation_evidence)
|
||
except Exception as e:
|
||
logger.warning("eval source conversation evidence skipped: {}", e)
|
||
elif uid:
|
||
try:
|
||
user_evidence = await _user_transcript_evidence(db, uid)
|
||
if user_evidence:
|
||
evidence_transcript = user_evidence
|
||
except Exception as e:
|
||
logger.warning("eval user transcript evidence skipped: {}", e)
|
||
if uid:
|
||
from app.features.memoir.repo import get_chapters_for_memoir_list
|
||
from app.features.story.repo import get_stories_for_user
|
||
|
||
try:
|
||
chapters = await get_chapters_for_memoir_list(
|
||
uid, db, active_only=True, is_new_only=None
|
||
)
|
||
for ch in chapters[:_MAX_EVAL_CHAPTERS]:
|
||
body = (ch.canonical_markdown or "").strip()
|
||
if not body:
|
||
continue
|
||
md = f"# 章节:{ch.title}\n\n{_clip_md_for_judge(body)}"
|
||
cj = await judge.judge_memoir(
|
||
memoir_markdown=md,
|
||
source_transcript=evidence_transcript,
|
||
reference_memoir_markdown=reference_memoir,
|
||
evidence_notes=(
|
||
"这是用户现有章节的严格评审;真实性、覆盖率、可追溯性必须对照原始访谈证据。"
|
||
" 评审范围:单章节节选;跨全书连贯性仅在与证据一致时评估,否则保守打分并在 insufficient_evidence 说明。"
|
||
),
|
||
)
|
||
chapter_entries.append(
|
||
{
|
||
"id": ch.id,
|
||
"title": ch.title,
|
||
"order_index": ch.order_index,
|
||
"judge": cj.model_dump() if cj else None,
|
||
}
|
||
)
|
||
except Exception as e:
|
||
logger.warning("eval chapter judges skipped: {}", e)
|
||
|
||
try:
|
||
stories = await get_stories_for_user(db, uid, status="active")
|
||
for st in stories[:_MAX_EVAL_STORIES]:
|
||
body = (st.canonical_markdown or "").strip()
|
||
if not body:
|
||
continue
|
||
md = f"# 故事:{st.title}\n\n{_clip_md_for_judge(body)}"
|
||
sj = await judge.judge_memoir(
|
||
memoir_markdown=md,
|
||
source_transcript=evidence_transcript,
|
||
reference_memoir_markdown=reference_memoir,
|
||
evidence_notes=(
|
||
"这是用户现有故事的严格评审;真实性、覆盖率、可追溯性必须对照原始访谈证据。"
|
||
" 评审范围:单故事节选;跨篇章关联若证据不足须保守并在 insufficient_evidence 说明。"
|
||
),
|
||
)
|
||
story_entries.append(
|
||
{
|
||
"id": st.id,
|
||
"title": st.title,
|
||
"stage": st.stage,
|
||
"judge": sj.model_dump() if sj else None,
|
||
}
|
||
)
|
||
except Exception as e:
|
||
logger.warning("eval story judges skipped: {}", e)
|
||
|
||
synth_scores: list[float] = []
|
||
if mem_out is not None:
|
||
synth_scores.append(float(mem_out.total_score))
|
||
|
||
library_scores: list[float] = []
|
||
for row in chapter_entries:
|
||
j = row.get("judge")
|
||
if isinstance(j, dict) and j.get("total_score") is not None:
|
||
library_scores.append(float(j["total_score"]))
|
||
for row in story_entries:
|
||
j = row.get("judge")
|
||
if isinstance(j, dict) and j.get("total_score") is not None:
|
||
library_scores.append(float(j["total_score"]))
|
||
|
||
def _mean(xs: list[float]) -> float:
|
||
return sum(xs) / len(xs) if xs else 0.0
|
||
|
||
if synth_scores and library_scores:
|
||
mem_total = 0.5 * _mean(synth_scores) + 0.5 * _mean(library_scores)
|
||
elif synth_scores:
|
||
mem_total = _mean(synth_scores)
|
||
elif library_scores:
|
||
mem_total = _mean(library_scores)
|
||
else:
|
||
mem_total = None
|
||
|
||
exp = await eval_repo.get_experiment(db, str(run.experiment_id))
|
||
weights = (
|
||
exp.composite_weights_json
|
||
if exp and isinstance(exp.composite_weights_json, dict)
|
||
else None
|
||
)
|
||
comp = _composite(conv_total, mem_total, weights)
|
||
|
||
bundle: dict[str, Any] = {
|
||
"conversation_judge": conv_out.model_dump() if conv_out else None,
|
||
"memoir_judge": mem_out.model_dump() if mem_out else None,
|
||
"chapters": chapter_entries,
|
||
"stories": story_entries,
|
||
"judge_meta": {
|
||
"conversation_judge_ok": conv_out is not None,
|
||
"memoir_synthetic_ok": mem_out is not None,
|
||
"memoir_synth_scores_n": len(synth_scores),
|
||
"memoir_library_scores_n": len(library_scores),
|
||
"memoir_aggregate_rule": (
|
||
"synth_plus_library_weighted_mean"
|
||
if synth_scores and library_scores
|
||
else ("synthetic_only" if synth_scores else "library_only")
|
||
),
|
||
},
|
||
}
|
||
await eval_repo.update_run(
|
||
db,
|
||
run,
|
||
status="completed",
|
||
memoir_markdown=memoir_md,
|
||
conversation_score_total=conv_total,
|
||
memoir_score_total=mem_total,
|
||
composite_score=comp,
|
||
judge_bundle_json=bundle,
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
|
||
|
||
async def _finalize_experiment_gate(db: AsyncSession, experiment_id: str) -> None:
|
||
runs = await eval_repo.list_runs_for_experiment(db, experiment_id)
|
||
exp = await eval_repo.get_experiment(db, experiment_id)
|
||
if not exp:
|
||
return
|
||
cases = await eval_repo.list_cases(db, str(exp.regression_set_id))
|
||
|
||
incomplete = [r for r in runs if str(r.status) not in ("completed", "failed")]
|
||
if incomplete:
|
||
return
|
||
|
||
failed = [r for r in runs if str(r.status) == "failed"]
|
||
if failed:
|
||
await eval_repo.update_experiment(
|
||
db,
|
||
exp,
|
||
status="failed",
|
||
error_message="部分 run 失败",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
return
|
||
|
||
gr = compute_gate(cases=cases, runs=runs)
|
||
await eval_repo.upsert_gate_verdict(
|
||
db,
|
||
experiment_id=experiment_id,
|
||
passed=gr.passed,
|
||
mean_composite_delta=gr.mean_delta,
|
||
protected_regressions_json=gr.protected_regressions,
|
||
details_json=gate_result_to_details(gr),
|
||
)
|
||
await eval_repo.update_experiment(
|
||
db,
|
||
exp,
|
||
status="completed",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
|
||
|
||
async def execute_experiment_full(experiment_id: str) -> None:
|
||
async with AsyncSessionLocal() as db:
|
||
exp = await eval_repo.get_experiment(db, experiment_id)
|
||
if not exp:
|
||
return
|
||
await eval_repo.update_experiment(db, exp, status="running")
|
||
await db.commit()
|
||
|
||
cases = await eval_repo.list_cases(db, str(exp.regression_set_id))
|
||
base_v = await eval_repo.get_version(db, str(exp.baseline_version_id))
|
||
cand_v = await eval_repo.get_version(db, str(exp.candidate_version_id))
|
||
if base_v is None or cand_v is None:
|
||
await eval_repo.update_experiment(
|
||
db,
|
||
exp,
|
||
status="failed",
|
||
error_message="version 不存在",
|
||
completed_at=datetime.now(timezone.utc),
|
||
)
|
||
await db.commit()
|
||
return
|
||
|
||
for case in cases:
|
||
for side, ver in ("baseline", base_v), ("candidate", cand_v):
|
||
run = await eval_repo.get_run(db, experiment_id, str(case.id), side)
|
||
if not run:
|
||
run = await eval_repo.create_run(
|
||
db,
|
||
experiment_id=experiment_id,
|
||
case_id=str(case.id),
|
||
side=side,
|
||
)
|
||
await db.commit()
|
||
await execute_eval_run(db, run=run, case=case, version=ver)
|
||
|
||
await _finalize_experiment_gate(db, experiment_id)
|