92444e7eae
- 新增 25+ 条风险规则（预算/报销/申请/通用类），完善风险规则模拟与反馈发布机制 - 引入费用审批动态路由、平台风险分级、预审与风险阶段管理 - 预算中心列表化改造，优化票据夹仪表盘与数字员工工作看板 - 新增 Hermes 风险线索收集器、Agent 链路追踪中心 - 扩展数字员工能力库（18 个领域 Skill）与交通费用自动预估 - 完善报销申请快速预览、权限控制与前端测试覆盖
4.8 KiB
4.8 KiB
Agent链路追踪中心 开发 TODO
使用规则
- 每个 TODO 必须对应
CONCEPT.md中的目标、能力或验收点。 - 只有完成并验证后，才能把
[ ]改成[x]。 - 勾选时在任务后补充简短证据，例如文件、接口、命令或验证结果。
- 如果需求发生变化，先更新
CONCEPT.md，再调整本 TODO。
1. 调研与边界
- [CONCEPT: 背景与问题] 阅读相关页面、接口、服务、测试和历史文档，记录当前实现事实。证据：已确认
agent_runs、agent_tool_calls、semantic_parse_logs、LogDetailView、DigitalEmployeeWorkRecords现状。 - [CONCEPT: 目标与非目标] 确认本轮开发范围，写清楚不做项。证据：
CONCEPT.md明确只做历史重放，不做调试重跑和 OpenTelemetry。 - [CONCEPT: 风险与开放问题] 标记无法立即确认的依赖、风险和假设。证据：
CONCEPT.md风险章节记录脏工作树和数据库初始化依赖。
2. 契约与设计
- [CONCEPT: 功能能力] 定义输入、输出、状态、权限和边界条件。证据：
CONCEPT.md功能能力章节。 - [CONCEPT: 方案设计] 明确前端、后端、算法、数据的职责边界。证据：
CONCEPT.md方案设计章节。 - [CONCEPT: 算法与公式] 补全耗时公式和变量解释。证据：
CONCEPT.md算法与公式章节。 - [CONCEPT: 指标与验收] 把验收标准转成可验证的检查点。证据：
CONCEPT.md指标与验收章节。
3. 后端实现
- [CONCEPT: 后端] 新增 trace 事件模型、schema、repository/service。证据：
AgentTraceEvent、agent_trace.py、AgentTraceService。 - [CONCEPT: 后端] 新增
agent-traces只读接口和路由注册。证据：agent_traces.pyendpoint 与router.py注册。 - [CONCEPT: 后端] 在 Orchestrator 关键节点写入 trace event。证据：
orchestrator.py记录接收、会话、语义、路由、回复、失败事件；orchestrator_execution.py记录工具调用事件。 - [CONCEPT: 数据] 实现旧 run fallback 时间线，避免旧数据详情为空。证据：
AgentTraceService.get_trace()在无事件时由AgentRun、SemanticParseLog、AgentToolCall合成只读时间线。
4. 算法/规则实现
- [CONCEPT: 算法与规则] 实现 trace 事件排序、耗时计算和状态归一化。证据：
AgentTraceService._next_sequence()、_resolve_duration_ms()、agentTraceViewModel.js。 - [CONCEPT: 结果解释] 输出可读事件标题、摘要、输入输出和错误信息。证据：Trace event schema 与
AgentTraceCenterView.vue详情面板。
5. 前端实现
- [CONCEPT: 前端] 新增 trace 服务 API 和数据归一化工具。证据：
agentTraces.js、agentTraceViewModel.js。 - [CONCEPT: 前端] 新增 Trace Center 列表与详情视图。证据：
AgentTraceCenterView.vue。 - [CONCEPT: 前端] 从现有日志详情和工作记录补充 trace 跳转入口。证据：
LogDetailView.vue、DigitalEmployeeWorkRecords.vue。 - [CONCEPT: 前端] 实现加载、空态、错误态和刷新。证据：
AgentTraceCenterView.vue列表/详情状态与刷新按钮。 - [CONCEPT: 前端] 对齐现有企业级直角、低饱和、密集信息风格。证据：
agent-trace-center-view.css使用面板、表格、状态徽标和紧凑信息布局。
6. 测试与验证
- [CONCEPT: 测试方案] 补充后端 service/API 定向测试。证据：
test_agent_trace_service.py覆盖事件记录、fallback、接口列表和详情。 - [CONCEPT: 测试方案] 补充前端数据归一化测试或可构建验证。证据：
npm.cmd --prefix web run build通过。 - [CONCEPT: 测试方案] 在 60s 超时内运行 Docker 后端定向验证。证据：
docker exec ... pytest -q server/tests/test_agent_trace_service.py server/tests/test_agent_runs_service.py，7 passed。 - [CONCEPT: 测试方案] 运行
npm.cmd --prefix web run build。证据：Vite build 成功。 - [CONCEPT: 指标与验收] 记录验证命令、结果和未覆盖风险。证据：后端测试 7 passed、Vite build 成功、重启后
/api/v1/agent-traces/{run_id}live 返回 8 个 fallback 事件；浏览器插件后续不可用，未完成最终截图巡检。
7. 文档收尾
- [CONCEPT: 指标与验收] 回看所有验收点，确认均有实现或验证证据。证据：后端 service/API 测试、前端构建、入口接入均已完成。
- [CONCEPT: 风险与开放问题] 更新剩余风险、后续任务和明确不做项。证据：
CONCEPT.md保留 OpenTelemetry、跨容器 trace、长期归档为后续待定。 - [CONCEPT: 功能一句话] 确认最终实现没有偏离原始目标。证据：本轮只做 Agent Trace Center，未处理 GL/前端状态管理两项待定问题。