Eric Wang
e72d9c9bc0
- merge main (b0ff2e0..c7ca781): workflow/20261022 moves dynamic context out of fixed prompts - collection/extraction prompts carry no inline vars; reference time and current form travel in the user message <turn_context> block; photo/confirm data kept at prompt tails - prompts: all 8 files regenerated from 20261022 (byte-identity tests point at the new export) - collect: user message = <turn_context>(本轮参考时间) + <user_input>; extraction message adds 当前表单; single trusted clock per turn threads through reply/extraction/repair - photo: raw input only (20261022 photo nodes use system_text, no wrapper) - workflow fake llm: unwraps <user_input> before event parsing - fields: accident_time normalized to extraction format (YYYY年M月D日H点m分, strip zero padding) - fixes form assertion mismatch with padded output - evals/run.py: trust_env=False - bypass Windows system proxy (registry proxy at 192.168.0.4:7897 was intercepting localhost and returning 503) - verified: 172 unit tests; ALL golden suites pass on real model (46/46): collection_skip 12/12, photo_skip 4/4, no_false 2/2, button_guidance 12/12, non_motor_vehicle 14/14, time_confirmation 2/2
AI 事故信息采集 API（LangGraph 迁移分支）
本分支是“将对话后端从 FastGPT 工作流迁移到 LangGraph”课程的迁移准备分支。
当前状态：对外 API 契约保持不变，/chat 的供应商细节已封装到后端适配层（FastGPT 仍
为唯一实现），迁移计划见 docs/langgraph-backend-migration-plan.md。
本阶段交付说明与验证证据见 docs/assignment-baseline.md。
环境要求
- Python 3.11（使用 Conda 环境
py3.11，见 AGENTS.md） fastgpt-clientSDK（当前以本地可编辑方式安装，见下文）
安装
conda activate py3.11
# 项目依赖
pip install -r requirements.txt
# FastGPT SDK（本地可编辑安装；SDK 源码在独立仓库维护）
pip install -e /path/to/fastgpt-python-sdk
配置
服务端通过环境变量读取 FastGPT 连接信息。复制示例配置并按环境填写：
cp .env.example .env
需要设置的变量：
| 变量 | 说明 |
|---|---|
ANALYSIS_SERVICE_URL |
FastGPT 服务地址 |
ANALYSIS_AUTH_TOKEN |
FastGPT API Key |
APP_ID |
FastGPT 应用 ID |
运行
python -m uvicorn src.main:app --host 127.0.0.1 --port 8000
GET /存活检查POST /chat对话（?stream=true为 SSE 流式）POST /set_info、POST /get_info、DELETE /delete_session业务数据接口
测试
conda run -n py3.11 python -m pytest -q
测试分三层：
test/api/test_public_schema_contract.py：公共请求/响应 schema 的契约冻结测试test/api/test_chat_backend_boundary.py：API 层与后端适配层的边界测试（fake 后端）test/backends/test_fastgpt_backend.py：FastGPT 适配器的翻译测试（fake SDK）
目录结构
src/
api/endpoints.py # HTTP 协议层：schema、state 前缀解析、SSE 事件
backends/chat.py # 后端中立契约（ChatBackend Protocol、ChatInput/ChatResult/事件）
backends/fastgpt.py # FastGPT 适配器：SDK 调用与响应翻译
core/fastgpt_client.py # 客户端生命周期与依赖注入（lifespan）
schemas/models.py # 公共 Pydantic 模型
docs/langgraph-backend-migration-plan.md # 十阶段迁移作业计划
evals/ # 调用真实服务的评测用例与 runner
当前状态与已知限制
作业 1—5 已完成（LLM 提议 + 代码校验架构，提示词与 workflow/20261020
逐字对齐，全量测试 143 通过）。逐作业进度、真实模型评测结果与开放问题
见 docs/langgraph-backend-migration-plan.md
文末“当前进度与已知差异”。
- 真实模型黄金评测：
collection_skip_known_info12/12 通过；photo_skip_plate_confirm0/4、no_false2/8，统一卡在短促回答“对” 的分流语义上，待与 FastGPT 应用层配置对账（差异已留档，未叠代码守卫）。 set_info/get_info仍直接依赖 FastGPT 状态与历史，迁移到共享 业务状态属于作业 6；delete_session已按后端分流（langgraph 清 checkpoint）。- 服务启动（langgraph 模式）不需要 FastGPT 配置；需要 LLM provider 配置。
- 流式为“完整答案切片”，真实增量输出属作业 8；
formUpdate差量属作业 6。