模块 2 · 认识主要角色

四个 Agent,
各干各的活

它们不互相打电话(不调彼此的 LLM)。要共享信息,走数据库里的画像层、预警表、平台 API。 像一栋楼里的四个窗口,共用同一套档案室。

四个窗口分别是谁

客户财富 Agent

服务登录客户本人:查持仓/流水、产品规则 RAG、合规话术。代码:登录客户 14 节点编排(customer_service.py)登录客户 14 节点编排

代理人助手

服务理财师:聊名下客户、公开知识库。代码:顾问通用 tool→llm→guard 编排(agent_service.py)顾问通用 tool→llm→guard 编排 + advisor 分支

数据分析 Agent

NL→SQL 问数、看板 metrics、口径资产。独立路由 /api/analyst/*

风控监测 Agent

预警台账、适当性、AML、模拟交易触发规则。代码:app/service/risk/*

群聊:一次请求里谁跟谁说话

理财师问「客户 CUST-9527 持仓如何」——简化对话:

代码地图(改功能前先找门)

app/
FastAPI 应用入口(main.py)FastAPI 应用入口 — 挂载所有路由
四 Agent 对话 HTTP 入口(chat.py)四 Agent 对话 HTTP 入口 — app/api/chat.py
问数 REST 路由(analyst.py)问数 REST 路由 — app/api/analyst.py
风控 REST(risk.py)风控 REST — app/api/risk.py · 模拟交易 HTTP 入口(simulate.py)模拟交易 HTTP 入口 — app/api/simulate.py
登录客户 14 节点编排(customer_service.py)登录客户 14 节点编排 — app/service/customer_service.py
顾问通用 tool→llm→guard 编排(agent_service.py)顾问通用 tool→llm→guard 编排 — app/service/agent_service.py
web/
src/pages/* — 四角色页面
src/api/*.ts — 调后端(注意鉴权头差异)

客户打开「客户助手」时,编排跑在哪?