xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity

feat: T-04 Core RO Tool 节点——chat Tool 接入+归属校验+agent_tool_call 落库

Browse Source 
- app/tool/core_tools.py: 三只读 Tool(query_customer_profile/holdings/recent_trades, Core RO 仅 SELECT) + TOOL_REGISTRY 白名单(requires_customer); JSON 安全化(Decimal 两位/时间 isoformat)
- app/service/tool_service.py: match_intent 关键词意图(仅 customer/advisor; risk/analyst 空转归 C1/C2) + assert_tool_access 归属断言(customer 本人/advisor assigned/risk_officer 全量/其余拒, 口径对齐 deps.assert_customer_access) + run_tool 编排(白名单→校验→执行→agent_tool_call 落库, 落库失败降级 warning)
- agent_service: 图 START→tool→llm→guard; Tool 结果注入 LLM 上下文(SystemMessage); 降级回复带 Tool 摘要; chat() 可选 session 上下文(缺省空转, T-07 兼容)
- session_repository: insert_tool_call(message_id 一期 NULL, session_id+trace_id 可还原)
- 归属拒绝口径: Tool 层不抛 403 改 blocked 留痕(AUTH_403_* 同码), 对话内呈现——API 层 deny 铁律不变
- tests: test_chat_tools 20 例(三态+落库字段+降级+图注入) + test_chat 4 例(全链路/JWT 外 debug 通道), _ddl 补 agent_tool_call/core_holding, 297 绿
- 真库冒烟: uvicorn+真 MySQL/Redis chat 触发持仓查询 success 落痕 47ms, 现场已清理
This commit is contained in:
GaoYiYuan_0626
2026-09-07 08:43:36 +08:00
parent 3c3ce4e5d6
commit 301c78edc3
13 changed files with 1002 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/memory/MEMORY.md
+11 -10
View File
@@ -9,7 +9,7 @@
**项目是什么：** 金融四 Agent（客户财富 / 代理人 / 数据分析 / 风控）共用数据层与合规底座；**不**互调 LLM，跨 Agent 走 L1/L2/L3 画像与预警表。
**当前进度：** 需求与表设计已定 · **风控模块 B1~B9b 全部完成（M2 tag risk-m2），M4 复核已闭环（2026-09-07），风控阶段 B 正式完结** · **Wave 0 已完成（2026-09-07，经独立 AI 评审闭环）**：T-01 JWT 鉴权（auth_service Auth SDK + deps 工厂替换 + X-Agent-Type 准入矩阵）/ T-02 审计中间件（http_access + 独立 request_id + 4xx/500 统一错误体 + input_guard_log 双写）/ T-06 chat 最小闭环（POST /api/chat + 会话落库 + Redis 窗口）/ T-07 LangGraph StateGraph 骨架 + DeepSeek（无 key 降级），**273 测试绿**。**下一步：T-03 输入防护 / T-04 Core RO 封装 Tool / T-21 Milvus / 风控阶段 C（C0~C3，A-6 对话验收）**。**开发在分支 `feature/risk`（未合入 main）。**
**当前进度：** 需求与表设计已定 · **风控模块 B1~B9b 全部完成（M2 tag risk-m2），M4 复核已闭环（2026-09-07），风控阶段 B 正式完结** · **Wave 0 已完成（2026-09-07，经独立 AI 评审闭环）**：T-01 JWT 鉴权（auth_service Auth SDK + deps 工厂替换 + X-Agent-Type 准入矩阵）/ T-02 审计中间件（http_access + 独立 request_id + 4xx/500 统一错误体 + input_guard_log 双写）/ T-06 chat 最小闭环（POST /api/chat + 会话落库 + Redis 窗口）/ T-07 LangGraph StateGraph 骨架 + DeepSeek（无 key 降级）· **T-04 Core RO Tool 节点已完成（2026-09-07）**：app/tool/core_tools.py 三只读 Tool + tool_service（意图/归属校验/run_tool）+ 图 tool 节点 + agent_tool_call 落库，**297 测试绿**。**下一步：T-21 Milvus / T-03 输入防护 / 风控阶段 C（C0~C3，A-6 对话验收，C1 复用 run_tool）**。**开发在分支 `feature/risk`（未合入 main）。**
**仓库地图：**
@@ -21,8 +21,9 @@
| `app/api/knowledge.py` `admin.py` | 空壳 | 待 T-21（Milvus/RAG）与审计查询台 |
| `app/service/auth_service.py` | **已实现（T-01）** | Auth SDK：JWT 验签（HS256 dev/RS256 生产）、必填 claims、jti 吊销（Redis fail-open）；签发 CLI `scripts/dev/issue_dev_token.py` |
| `app/service/risk/*` + `service/suitability.py` | **已实现** | RISK-001~005 规则 / 预警聚合 / L3 写入 / AML / 引擎编排 / SUIT-001~008 / locks+redis_gateway 公共原语（B7） |
| `app/service/agent_service.py` `memory_service.py` | **已实现（T-07/T-06）** | LangGraph StateGraph（llm→guard）+ DeepSeek（无 key 降级）；Redis 会话窗口 + MySQL 回源 |
| `app/repository/session_repository.py` | **已实现（T-06）** | agent_session / agent_message 读写 |
| `app/service/agent_service.py` `memory_service.py` | **已实现（T-07/T-06/T-04）** | LangGraph StateGraph（tool→llm→guard）+ DeepSeek（无 key 降级）；T-04 tool 节点（关键词意图 customer/advisor + tool_service.run_tool）；Redis 会话窗口 + MySQL 回源 |
| `app/service/tool_service.py` `app/tool/core_tools.py` | **已实现（T-04）** | 对话 Tool 编排（白名单/归属校验/agent_tool_call 落库）+ Core RO 三只读 Tool（L0/持仓/流水）；风控四 Tool 归 C1 复用 run_tool |
| `app/repository/session_repository.py` | **已实现（T-06/T-04）** | agent_session / agent_message / agent_tool_call 读写 |
| `app/gateway/` | **已实现** | 模拟交易网关（仅 gateway_repository 可 INSERT core_trade，B5） |
| `app/repository/core_ro.py` | **已实现** | Core 只读 SELECT（含风控扩展 sum_trades_on_date / list_trades_range / list_active_customers） |
| `app/repository/risk_repository.py` | **已实现** | risk_alert / risk_suitability_log / L3 / risk_aml_list / audit_log / input_guard_log 读写 |
@@ -31,7 +32,7 @@
| `scripts/core/*.sql` + `reset.ps1` | **已实现** | Core 模拟库 DDL + 种子 |
| `scripts/agent/` `scripts/demo/` `scripts/dev/` | **已实现** | AML 名单种子 + 风控演示数据 + subscribe_alerts/rebuild_alerts + issue_dev_token（JWT 签发） |
| `scripts/sync/*.py` | **已实现** | 归属同步 + Neo4j 全图 |
| `tests/` | **已实现** | 21 个测试文件 273 用例（sqlite 隔离；DDL 单一事实源 `_ddl.py`；`test_integration_risk.py` 走真 MySQL + TRD-TEST- 前缀隔离） |
| `tests/` | **已实现** | 22 个测试文件 297 用例（sqlite 隔离；DDL 单一事实源 `_ddl.py`；`test_integration_risk.py` 走真 MySQL + TRD-TEST- 前缀隔离） |
| `docs/需求拆解/` | 已定 | 场景 P0、矩阵、合规原文 |
| `docs/PRD/PRD-风控监测Agent.md` | **已冻结** | 风控 PRD v1.0 + 规则表附录 |
| `docs/项目框架设计/表设计/` | 已定 | Agent 共用 11 表 + agent 专用 SQL |
@@ -49,13 +50,13 @@
5. mysql … < scripts/agent/seed-aml-list.sql # AML 名单种子
（风控演示：scripts/demo/prepare_risk_demo.sql，reset 后重跑）
6. python scripts/sync/sync_advisor_rel.py && python scripts/sync/sync_neo4j.py
7. uvicorn app.main:app --reload → GET /health；python -m pytest（209 绿）
7. uvicorn app.main:app --reload → GET /health；python -m pytest（297 绿）
```
> **本机 ①~⑤已执行、`.env` 已配置，勿重做**；本机状态与已知坑（mysql.exe 路径 / reset.ps1 交互式 -p / `redis`、`python-jose` 包漏装已补）见 `FLOW.md` §0 尾注。
> **演示库状态（2026-09-07）**：已按演示 SOP §2 重灌并清理冒烟数据（alerts 0 / AML 8 / 会话 0），pytest 全量可直接跑；**下次演示/走查后再按 SOP §2 重灌**（核查单⑥前置断言会对走查残留显式 fail，属防护行为）。
**下一步开发（见 TODO）：** T-03 输入防护 / T-04 Core RO 封装 Tool（agent_tool_call 随 C1）/ T-21 Milvus / 风控阶段 C（C0~C3，A-6 对话验收）。演示走查按 `docs/项目框架设计/演示SOP-风控模块.md`（debug 头通道仍有效；JWT 通道签发用 `scripts/dev/issue_dev_token.py`）。
**下一步开发（见 TODO）：** T-21 Milvus / T-03 输入防护 / 风控阶段 C（C0~C3，A-6 对话验收；C1 风控四 Tool 复用 T-04 run_tool）。演示走查按 `docs/项目框架设计/演示SOP-风控模块.md`（debug 头通道仍有效；JWT 通道签发用 `scripts/dev/issue_dev_token.py`）。
**禁止（改代码前必记）：** Core 正式 C1~C5 不可被画像覆盖 · 审计表只 INSERT · 代理人草稿不外发 · 仅 R-02 可阻断交易 · 四 Agent 不互调 LLM。
@@ -64,8 +65,8 @@
## 1. 项目简介
- **名称：** JinRong 金融四 Agent 智能管家
- **当前阶段：** **Wave 0 共用底座完成（2026-09-07：JWT / 审计中间件 / chat 闭环 / LangGraph 骨架，273 绿）**；风控模块 B1~B9b 完成（M2 tag risk-m2）+ M4 复核闭环，阶段 B 完结；下一批 = T-03/T-04/T-21 + 风控阶段 C（A-6 对话线验收）
- **当前优先级：** Wave 0（T-01 JWT / T-02 审计中间件 / T-06 / T-07 LangGraph）→ 风控阶段 C（A-6）→ Wave 1
- **当前阶段：** **T-04 Core RO Tool 节点完成（2026-09-07：tool 节点+归属校验+agent_tool_call 落库，297 绿）**；Wave 0 共用底座完成（T-01 JWT / T-02 审计中间件 / T-06 / T-07 LangGraph）；风控模块 B1~B9b 完成（M2 tag risk-m2）+ M4 复核闭环，阶段 B 完结；下一批 = T-21/T-03 + 风控阶段 C（A-6 对话线验收）
- **当前优先级：** T-21 / T-03 → 风控阶段 C（A-6）→ Wave 1
------
@@ -128,7 +129,7 @@ Core 模拟：scripts/core/reset.ps1 · 文档 docs/项目框架设计/Core模
种子：scripts/agent/seed-aml-list.sql（AML 名单）· scripts/demo/prepare_risk_demo.sql（reset 后重跑）
依赖：requirements.txt（LangGraph + langchain-core/openai + FastAPI + SQLAlchemy）
启动：uvicorn app.main:app --reload → GET /health
测试：python -m pytest（273 用例；集成测试需本机演示数据，未灌库时自动 skip）
测试：python -m pytest（297 用例；集成测试需本机演示数据，未灌库时自动 skip）
运维/演示脚本：scripts/demo/subscribe_alerts.py（订阅推送演示）· rebuild_alerts.py TRD-xxx（引擎异常补偿重放）
JWT 联调：python scripts/dev/issue_dev_token.py --sub STAFF-30001 --roles risk_officer（+ Authorization: Bearer + X-Agent-Type）
配置：.env（见 .env.example）
@@ -172,6 +173,6 @@ RBAC 联调账号：scripts/dev/rbac-seed-reference.md
2. 改动属于 api / service / tool / repository 哪一层？
3. 是否需 customer_id 归属与 JWT RBAC？
4. Core 是模拟库只读还是 agent 库读写？
5. 如何验证？（`python -m pytest` 全量（当前 273 绿）· uvicorn 启动 + /health · SQL / sync 脚本 · 对照 REQUIREMENTS 验收列）
5. 如何验证？（`python -m pytest` 全量（当前 297 绿）· uvicorn 启动 + /health · SQL / sync 脚本 · 对照 REQUIREMENTS 验收列）
大任务：FRAMEWORK/FLOW 与实现状态不符时先更新 memory 再编码（用户确认跳过除外）。