English: This folder documents a recipe-driven pipeline for agent logs
(JSONL with messages + choices / response_choices). Core operators live
under data_juicer/ops/mapper/ (e.g. agent_dialog_normalize_mapper,
agent_bad_case_signal_mapper, dialog_* quality mappers); default prompts
and flattened dialog labels are English-first for upstream reuse—override
user_label / assistant_label on the normalize mapper or subclass mappers
for other locales.
| 需求 | 文档 |
|---|---|
只出 HTML 报告（已有 processed.jsonl） |
BAD_CASE_REPORT.md |
| 怎么跑 smoke / full / 校准 / 常见问题 | QUICKSTART_BAD_CASE.md |
| 分层逻辑、信号表、insight 字段、jq | BAD_CASE_INSIGHTS.md |
| 后处理 Python 脚本参数 | scripts/README.md |
| LLM 算子加速 | PERFORMANCE_LLM.md |
端到端配置：agent_interaction_quality_analysis.yaml；无 API 冒烟：minimal_configs/09_bad_case_smoke.yaml。
| 项 | 说明 |
|---|---|
| pre-commit | pre-commit run --all-files。若 build-op-doc 提示 Operator document is updated，需将 docs/Operators.md（及 docs/operators/ 若生成）纳入同一提交；可按需再跑一轮 hook 直至 build-op-doc 通过。 |
| 算子文档 | 新增/改名 mapper 后，以 python .pre-commit-hooks/build_op_doc.py 更新表格；线上算子表见仓库根目录 docs/Operators.md。 |
| 信号 ↔ 报告 | 若增加 agent_bad_case_signals 的 code，请同步 scripts/bad_case_signal_support.py，以便 HTML 归因表一致。 |
| 单测（示例） | pytest tests/ops/mapper/test_agent_bad_case_signal_mapper.py tests/ops/mapper/test_agent_insight_llm_mapper.py tests/ops/mapper/test_usage_counter_mapper.py tests/utils/test_agent_output_locale.py tests/demos/agent/test_generate_bad_case_report_smoke.py -q |
| 根 README | 与本目录的交叉链接见 仓库 README「Documentation」 中的 Agent quality 条目。 |