241 lines
15 KiB
Markdown
241 lines
15 KiB
Markdown
# 四个 Agent 数据交互矩阵
|
||
|
||
> 需求拆解阶段产物 · 2026-09-05（v2 修正：用户画像采集与共享）
|
||
> 依据：`docs/需求拆解/业务场景优先级清单.md` 与四类用户故事
|
||
> 说明：本表描述 **谁产生/采集哪些数据、谁消费这些数据**；外部业务系统单独列出，不当作 Agent。
|
||
|
||
---
|
||
|
||
## 1. 图例
|
||
|
||
| 符号 | 含义 |
|
||
| --- | --- |
|
||
| **采集** | 该 Agent 在运行过程中**写入/落库/产出**的数据（含用户输入、对话提炼、问卷结果） |
|
||
| **使用** | 该 Agent **读取**的数据，来源可以是外部系统、统一画像库或其他 Agent 产出 |
|
||
| **只读** | 只查不改 |
|
||
| **读写** | 可创建/更新 |
|
||
| **—** | 无直接关系 |
|
||
|
||
**原则**
|
||
|
||
- 四个 Agent **不直接互调 LLM**；跨 Agent 数据通过 **统一数据层（含用户画像库）+ 各 Agent 产出表/事件流** 交换。
|
||
- **用户画像**由 **客户财富 Agent、代理人助手 Agent** 在前台交互中持续采集与丰富，写入 **统一用户画像库**，供代理人、风控、数据分析及客户本人读取。
|
||
- 核心系统的 **正式风险测评等级（C1~C5）** 仍是权威来源；Agent 采集的是 **偏好、风格、诉求、规划** 等画像 enrich 层，**不替代**正式测评，但可辅助适当性与服务。
|
||
- 客户持仓、盈亏等**事实口径**来自核心业务系统，禁止各 Agent 各算一套。
|
||
|
||
---
|
||
|
||
## 2. 用户画像：谁采集、谁使用（核心修正）
|
||
|
||
### 2.1 画像分层
|
||
|
||
| 层级 | 来源 | 谁写入 | 谁读取 | 说明 |
|
||
| --- | --- | --- | --- | --- |
|
||
| **L0 基础画像** | 核心业务系统 | 非 Agent（开户/测评系统） | 四 Agent 只读 | 姓名、年龄、职业、正式风险等级 C1~C5、资产规模 |
|
||
| **L1 客户侧 enrich** | 客户财富 Agent 交互 | **客户财富 Agent** | 客户本人；代理人；风控；数据分析 | 风格测评、资金规划、阈值偏好、对话行为标签 |
|
||
| **L2 服务侧 enrich** | 代理人助手 Agent 交互 | **代理人助手 Agent** | 代理人；风控；数据分析 | 沟通诉求、跟进要点、代理人侧资产概况快照、服务标签 |
|
||
| **L3 监测 enrich** | 风控监测 Agent | **风控监测 Agent** | 风控；数据分析；代理人（只读） | 监测分层、预警关联标签（不改 L0 正式风险等级） |
|
||
|
||
### 2.2 用户画像字段明细（Agent 采集项）
|
||
|
||
| 画像字段 | 采集方 Agent | 采集方式 | 使用方 | 关联场景 | 优先级 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| 投资风格标签（价值/成长/趋势等） | **客户财富** | 问卷 + 行为分析 | 客户财富；**代理人**；**风控**；**数据分析** | C-07 | P1 |
|
||
| 资金比例规划（股债比、加仓比例等） | **客户财富** | 客户确认的规划方案 | 客户财富；**代理人**；**风控** | C-08 | P1 |
|
||
| 亏损阈值与提醒偏好 | **客户财富** | 客户自设配置 | 客户财富；**风控**（规则参考） | C-04 | P0 |
|
||
| 对话行为标签（关注行业、产品偏好等） | **客户财富** | 会话提炼（非投资建议） | **代理人**；**数据分析** | C-01~C-02 等 | P1 |
|
||
| 投后复盘偏好与归因摘要 | **客户财富** | 定期复盘产出 | 客户本人；**代理人** | C-09 | P1 |
|
||
| 客户资产概况快照（结构化） | **代理人助手** | A-01 查数后结构化缓存 | **代理人**；**数据分析** | A-01 | P0 |
|
||
| 沟通诉求、关注点、待办 | **代理人助手** | A-06 跟进整理 / A-03 上下文 | **代理人**；**风控**（服务适当性参考） | A-03、A-06 | P0/P1 |
|
||
| 服务侧标签（如「关注赎回」「咨询转换」） | **代理人助手** | 会话与跟进提炼 | **代理人**；**数据分析** | A-01、A-06 | P1 |
|
||
| 监测分层（正常/关注/高风险） | **风控监测** | R-05 评分 / 预警关联 | **风控**；**数据分析**；代理人（只读） | R-05 | P2 |
|
||
| 适当性校验历史摘要 | **风控监测** | R-02 每次校验 | **客户财富**；**代理人**；交易系统 | R-02 | P0 |
|
||
|
||
---
|
||
|
||
## 3. Agent × Agent 总览矩阵（含用户画像）
|
||
|
||
行 = **数据采集方（产出方）**；列 = **数据使用方（消费方）**。
|
||
**粗体** = 用户画像相关流向。
|
||
|
||
| 采集 ↓ \ 使用 → | 客户财富 | 代理人助手 | 数据分析 | 风控监测 | 共用底座 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| **客户财富** | 自身画像读写 | **L1 用户画像**（风格/规划/偏好） | **L1 用户画像**（统计/解读） | **L1 用户画像**（适当性辅助） | 会话/Tool 审计 |
|
||
| **代理人助手** | — | 自身 + **L2 服务画像** | **L2 服务画像**（诉求/标签统计） | **L2 服务画像**（服务适当性参考） | 会话/Tool/草稿审计 |
|
||
| **数据分析** | — | — | — | — | SQL/查数审计 |
|
||
| **风控监测** | 适当性结果、**L3 监测标签** | **L3 监测标签**（只读） | 预警台账 + **画像监测统计** | — | 判定/预警审计 |
|
||
| **共用底座** | 鉴权上下文 | 鉴权 + 合规巡检 | 鉴权 + SQL 留痕 | 鉴权 + 判定留痕 | — |
|
||
|
||
> **修正说明**：上一版错误地将「代理人、数据分析不消费其他 Agent 产出」写死。按需求，**客户与代理人 Agent 是用户画像的主要采集方**，画像写入统一库后，**代理人、风控、数据分析** 均应能读取（在 RBAC 范围内）。
|
||
|
||
---
|
||
|
||
## 4. 数据对象明细矩阵（主表）
|
||
|
||
| 数据对象 | 数据类型 | 采集方 | 使用方 | 读写 | 用途 | 优先级 |
|
||
| --- | --- | --- | --- | --- | --- | --- |
|
||
| **统一用户画像库（L1 客户 enrich）** | **画像** | **客户财富** | 客户财富；**代理人**；**风控**；**数据分析** | 写 / 只读 | 风格、规划、阈值、行为标签共享 | P0/P1 |
|
||
| **统一用户画像库（L2 服务 enrich）** | **画像** | **代理人助手** | 代理人；**风控**；**数据分析** | 写 / 只读 | 诉求、跟进、服务标签共享 | P0/P1 |
|
||
| 客户对话与会话上下文 | 会话 | 客户财富 | 客户财富；共用底座 | 读写 / 只读 | 多轮问答；画像提炼原料；审计 | P0 |
|
||
| 用户亏损阈值配置 | 客户配置 | 客户财富 | 客户财富；风控；**画像库** | 读写 / 只读 | C-04 提醒；风控规则参考 | P0 |
|
||
| 投资风格测评答卷与标签 | 客户配置 | 客户财富 | 客户财富；**代理人**；**风控**；**数据分析** | 读写 / 只读 | C-07；适当性辅助；人群统计 | P1 |
|
||
| 资金比例规划与偏离记录 | 客户配置 | 客户财富 | 客户财富；**代理人**；**风控** | 读写 / 只读 | C-08 偏离提醒；服务准备 | P1 |
|
||
| 对话行为标签（非投资建议） | 画像 | 客户财富 | **代理人**；**数据分析** | 写 / 只读 | 了解客户关注点 | P1 |
|
||
| 客户侧提醒推送记录 | 事件日志 | 客户财富 | 客户财富；共用底座 | 写 / 只读 | 阈值/波动提醒留痕 | P0/P1 |
|
||
| 客户资产概况快照 | 画像 | 代理人助手 | 代理人；**数据分析** | 写 / 只读 | A-01 沟通前快速画像 | P0 |
|
||
| 沟通诉求 / 跟进要点 / 待办 | 画像 | 代理人助手 | 代理人；**风控** | 写 / 只读 | A-03/A-06；服务侧风险参考 | P0/P1 |
|
||
| 服务侧标签 | 画像 | 代理人助手 | 代理人；**数据分析** | 写 / 只读 | 诉求分类、运营统计 | P1 |
|
||
| 代理人 Agent 会话与 Tool 调用 | 会话 | 代理人助手 | 代理人；共用底座 | 读写 / 只读 | 答疑、画像汇总；A-05 合规巡检 | P0 |
|
||
| 合规话术草稿 | 草稿 | 代理人助手 | 代理人（人工复核后外用） | 读写 | A-03，读取 **L1+L2 画像** 生成 | P0 |
|
||
| 客户跟进日志草稿 | 草稿 | 代理人助手 | 代理人（人工确认后归档） | 读写 | A-06；确认后回写 **L2 画像** | P1 |
|
||
| 违规话术标记与会话风险标签 | 合规事件 | 代理人助手 | 代理人；共用底座 | 写 / 只读 | A-07 | P1 |
|
||
| 高频咨询聚合统计（脱敏） | 聚合统计 | 代理人助手 | 运营人员 | 写 / 只读 | A-08 | P1 |
|
||
| 自然语言查数请求与解读结果 | 会话 | 数据分析 | 数据分析；内部员工 | 读写 | D-01~D-05；可问「某风格客户有多少」 | P0 |
|
||
| 只读 SQL 及执行留痕 | 审计 | 数据分析 | 数据分析；共用底座；合规 | 写 / 只读 | D-04 | P0 |
|
||
| 交易事件监测快照 | 事件 | 风控监测 | 风控监测 | 读写 | R-01/R-04 | P0 |
|
||
| 风控预警单 | 业务单据 | 风控监测 | 风控；**数据分析** | 写 / 只读 | D-03 台账统计 | P0 |
|
||
| 适当性校验与阻断结果 | 判定结果 | 风控监测 | 风控；客户财富；**代理人**；交易系统 | 写 / 只读 | R-02；C-07/C-11；代理人知悉客户边界 | P0 |
|
||
| 风险评分与监测分层（L3） | 画像 | 风控监测 | 风控；**数据分析**；代理人（只读） | 写 / 只读 | R-05；不改 L0 正式等级 | P2 |
|
||
| AML 名单命中记录 | 合规事件 | 风控监测 | 风控；合规官 | 写 / 只读 | R-03 | P0 |
|
||
| 全链路审计日志 | 审计 | 共用底座 | 四 Agent；合规 | 写 / 只读 | F-02 | P0 |
|
||
| 鉴权与数据归属上下文 | 安全上下文 | 共用底座 | 四 Agent | 只读 | F-01；代理人只看名下客户画像 | P0 |
|
||
| 输入清洗与拦截记录 | 安全事件 | 共用底座 | 共用底座；合规 | 写 / 只读 | F-03 | P0 |
|
||
|
||
---
|
||
|
||
## 5. 外部系统 → Agent 数据流（非 Agent 采集）
|
||
|
||
| 外部数据源 | 使用方 Agent | 读写 | 典型用途 | 优先级 |
|
||
| --- | --- | --- | --- | --- |
|
||
| **L0 基础画像**（正式风险等级、年龄、职业等） | 四 Agent | 只读 | 适当性硬约束、权限校验 | P0 |
|
||
| 持仓 / 资金流水 / 资产分布 | 四 Agent | 只读 | 事实查询；A-01 概况；R-01 上下文 | P0 |
|
||
| 交易记录 / 交易事件流 | 风控、分析、客户 | 只读 | 大额监测、复盘 | P0 |
|
||
| 产品知识库 / 交易规则库 | 客户、代理人 | 只读 | 规则解读 | P0 |
|
||
| 行情 / 净值 | 客户财富 | 只读 | C-05 | P0 |
|
||
| 适当性规则引擎 | 风控监测 | 只读 | R-02 校验逻辑 | P0 |
|
||
| AML 名单 | 风控监测 | 只读 | R-03 | P0 |
|
||
| 产品销售汇总表 | 数据分析 | 只读 | D-02 | P0 |
|
||
| 业务制度 / 合规话术规范 | 代理人助手 | 只读 | A-03/A-04 | P0 |
|
||
|
||
---
|
||
|
||
## 6. 按 Agent 汇总：采集 vs 使用
|
||
|
||
### 6.1 客户财富 Agent
|
||
|
||
| 方向 | 数据 |
|
||
| --- | --- |
|
||
| **采集（产出）** | **L1 用户画像**（风格、规划、阈值、行为标签）；会话；提醒记录 |
|
||
| **使用（外部 L0）** | 正式风险等级、持仓/流水/分布；产品库；行情 |
|
||
| **使用（其他 Agent）** | 风控 → 适当性结果、L3 监测标签 |
|
||
| **画像被谁用** | **代理人**（沟通准备）；**风控**（适当性辅助）；**数据分析**（人群统计） |
|
||
|
||
### 6.2 代理人助手 Agent
|
||
|
||
| 方向 | 数据 |
|
||
| --- | --- |
|
||
| **采集（产出）** | **L2 服务画像**（资产概况快照、诉求、跟进、服务标签）；话术/跟进草稿；合规事件 |
|
||
| **使用（外部 L0）** | 正式风险等级、持仓事实 |
|
||
| **使用（其他 Agent 画像）** | **客户财富 → L1 画像**（A-03 话术、沟通前了解客户） |
|
||
| **使用（风控）** | 适当性结果、L3 监测标签（只读，服务边界参考） |
|
||
| **画像被谁用** | **风控**（服务适当性）；**数据分析**（诉求/标签分布统计） |
|
||
|
||
### 6.3 数据分析 Agent
|
||
|
||
| 方向 | 数据 |
|
||
| --- | --- |
|
||
| **采集（产出）** | 查数请求；只读 SQL；解读；留痕 |
|
||
| **使用（外部）** | 持仓/流水/产品汇总 |
|
||
| **使用（画像）** | **L1 客户画像 + L2 服务画像 + L3 监测标签**（如「C4 客户有多少」「关注赎回标签分布」） |
|
||
| **使用（风控）** | 预警台账（D-03） |
|
||
|
||
### 6.4 风控监测 Agent
|
||
|
||
| 方向 | 数据 |
|
||
| --- | --- |
|
||
| **采集（产出）** | 预警单；适当性结果；**L3 监测标签**；AML 命中 |
|
||
| **使用（外部 L0）** | 正式风险等级、交易流、AML 名单 |
|
||
| **使用（画像）** | **L1 客户画像 + L2 服务画像**（R-02 辅助判断、R-05 评分维度） |
|
||
| **画像被谁用** | 客户财富、代理人（只读）；数据分析（统计） |
|
||
|
||
---
|
||
|
||
## 7. 关键跨 Agent 链路（时序）
|
||
|
||
### 7.1 用户画像：双端采集 → 统一库 → 多方使用
|
||
|
||
```text
|
||
客户对话 / 问卷 / 规划确认
|
||
→ 客户财富 Agent 采集 L1（风格、阈值、规划、行为标签）
|
||
→ 写入【统一用户画像库】
|
||
|
||
代理人查客户 / 跟进整理 / 沟通记录
|
||
→ 代理人助手 Agent 采集 L2（概况快照、诉求、待办、服务标签）
|
||
→ 写入【统一用户画像库】
|
||
|
||
【统一用户画像库】
|
||
├→ 代理人助手：A-03 话术草稿、沟通前准备（读 L1+L2）
|
||
├→ 风控监测：R-02/R-05 适当性与评分辅助（读 L0+L1+L2，不改 L0）
|
||
├→ 数据分析：人群分布、交叉统计（读 L1+L2+L3，只读）
|
||
└→ 客户财富：客户本人查看/更新 L1
|
||
```
|
||
|
||
### 7.2 适当性：风控采集 → 客户 + 代理人使用
|
||
|
||
```text
|
||
交易/推荐请求 + 画像库（L0+L1）
|
||
→ 风控监测（R-02）采集：校验结果、阻断原因
|
||
→ 客户财富：匹配说明（C-07/C-11）
|
||
→ 代理人助手：知悉客户可购买边界（服务时不踩线）
|
||
```
|
||
|
||
### 7.3 预警台账：风控采集 → 分析使用
|
||
|
||
```text
|
||
交易事件流 → 风控采集预警单 → 数据分析（D-03）只读统计 → 风控专员人工处置
|
||
```
|
||
|
||
### 7.4 合规审计
|
||
|
||
```text
|
||
四 Agent 会话/Tool/SQL/判定 → 共用底座审计 → 代理人合规台（A-05）
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 画像读写权限（RBAC）
|
||
|
||
| 角色 | L1 客户 enrich | L2 服务 enrich | L3 监测 enrich |
|
||
| --- | --- | --- | --- |
|
||
| 客户本人 | 读写（自己的） | 不可见 | 不可见 |
|
||
| 理财代理人 | 只读（名下客户） | 读写（名下客户） | 只读（名下客户） |
|
||
| 风控专员 | 只读 | 只读 | 读写 |
|
||
| 数据分析（内部） | 只读（脱敏/聚合） | 只读（脱敏/聚合） | 只读 |
|
||
| 合规 | 审计只读 | 审计只读 | 审计只读 |
|
||
|
||
---
|
||
|
||
## 9. 禁止的数据流向
|
||
|
||
| 禁止项 | 原因 |
|
||
| --- | --- |
|
||
| Agent 画像层 **覆盖** L0 正式风险等级 | 正式 C1~C5 只能由测评系统或人工审核变更 |
|
||
| 数据分析 **修改** 画像库 | 只统计、只解读 |
|
||
| 代理人 **自动** 将 L2 画像或话术推送给客户 | A-03/A-06 须人工复核 |
|
||
| 风控 **自动** 冻户 / 改正式风险等级 | 仅写 L3 监测标签与预警 |
|
||
| 跨代理人读取他人客户画像 | F-01 数据归属 |
|
||
| 画像用于 **投资建议 / 收益承诺** | 合规边界 |
|
||
|
||
---
|
||
|
||
## 10. 与业务场景的映射索引
|
||
|
||
| 数据对象 | 关联场景 ID |
|
||
| --- | --- |
|
||
| L1 用户画像 | C-04, C-07, C-08, C-09 → A-03, R-02, D-01/D-05 |
|
||
| L2 服务画像 | A-01, A-03, A-06 → R-02, D-01/D-05 |
|
||
| L3 监测画像 | R-05 → 代理人/分析只读 |
|
||
| 持仓/流水/分布 | C-01, A-01, D-01, R-01 |
|
||
| 预警单 | R-01~R-04, D-03 |
|
||
| 适当性结果 | R-02, C-07, C-11, A-03 |
|