customer-profile

name	customer-profile
description	客户画像查询与修改。根据客户姓名查询AUM、风险偏好、资产配置及近期变动等画像数据，支持查询、手动修改和智能更新画像。智能更新基于拜访记录自动生成新画像，更新前需确认。触发词：客户画像、查询客户、获取画像、修改画像、更新画像、智能更新画像。

客户画像（查询/修改/智能更新）

概述

根据客户姓名查询客户画像数据，支持查询、手动修改和智能更新三种模式。数据统一存储在 references/mock_profiles.json，无本地缓存或输出文件。

输入

• 客户经理姓名（必填）：从 user_profile.json 或信息录入文件获取
• 客户姓名（必填）：从信息录入文件的顶层 customer 字段获取，或由用户直接提供

数据源

客户画像数据存储在 references/mock_profiles.json，按经理分组，查询和修改均直接操作该文件。

数据结构示例：

{
  "经理A": {
    "张三": { "customer_name": "张三", ... },
    "李四": { "customer_name": "李四", ... }
  },
  "经理B": {
    "赵六": { "customer_name": "赵六", ... }
  }
}

查询时先按经理定位，再按客户姓名查找。客户不存在则直接报错，不返回默认画像。

⛔ 隐私保护规则

严禁暴露其他经理的客户信息。 每个经理只能查看和修改自己名下的客户画像数据。

• 当客户不在当前经理名下时，不得透露该客户归属于哪位经理
• 不得列出其他经理名下的客户姓名
• 错误提示只能说明「未找到该客户」，并引导查询当前经理名下的客户列表
• 返回的 available_customers 字段仅包含当前经理名下的客户，绝不能包含其他经理的客户

---

🔍 模式一：查询画像（query）

触发

用户表达「查画像」「获取画像」「客户画像」时进入。

API调用

python3 scripts/mock_cfs_api.py \
  --manager "<经理>" \
  --customer "<客户姓名>" \
  --mode query

返回结果包含 error 字段时，说明客户不存在。此时 available_customers 会返回当前经理名下的所有客户列表。

客户不存在时的回复格式：

❌ 未找到客户「XX」

您名下的客户：客户A、客户B、客户C

需要查询您名下某位客户的画像吗？

⚠️ 严禁在回复中透露该客户归属于哪位其他经理，严禁列出其他经理名下的客户。

展示格式

🔍 查询客户「客户XX」画像...

✅ 客户画像：
| 客户等级 | 高净值客户 |
| AUM | 800万+ |
| 风险偏好 | 稳健 |
| 近期变动 | 短期理财即将到期 |

📋 Demo数据，正式版对接CFS。

---

✏️ 模式二：手动修改画像（update）

触发

用户表达「修改画像」「改一下客户信息」时进入。用于客户画像数据发生变化，需要直接手动修改指定字段的场景。

交互流程

1. 用户指定要修改的字段和新值
2. 调用API修改画像数据（客户不存在时与查询模式同理，不暴露其他经理信息）
3. 展示修改结果（旧值 → 新值）

API调用

python3 scripts/mock_cfs_api.py \
  --manager "<经理>" \
  --customer "<客户姓名>" \
  --mode update \
  --updates '{"aum":"900万+","recent_changes":"短期理财已到期"}'

--updates 参数为JSON格式，支持修改任意字段，如 aum、risk_preference、recent_changes、asset_allocation、tags 等。

修改结果

有变化：

✏️ 修改客户「客户XX」画像...

✅ 画像已修改：
| 字段 | 原值 | 新值 |
|------|------|------|
| AUM | 800万+ | 900万+ |
| 近期变动 | 短期理财即将到期 | 短期理财已到期 |

📋 Demo数据，正式版对接CFS。

无变化：

✏️ 修改客户「客户XX」画像...

✅ 画像数据无变化

---

🔄 模式三：智能更新画像（smart_update）

触发

用户表达「更新画像」「刷新画像」「智能更新画像」时进入。用于拜访完成后，根据拜访记录和现有画像自动生成新画像，更新前需用户确认。

与手动修改的区别

对比项	手动修改（update）	智能更新（smart_update）
触发词	「修改画像」「改一下」	「更新画像」「刷新画像」
数据来源	用户手动指定字段和值	AI根据拜访记录+现有画像自动生成
更新范围	仅修改指定字段	全量分析，多字段联动更新
确认机制	直接修改	预览变更→用户确认→执行更新

交互流程

1. 读取拜访记录文件（visit_input_{经理}_{客户}.json）和拜访纪要
2. 读取当前客户画像
3. AI分析拜访内容，智能推断画像更新内容，重点关注以下字段：
   • recent_changes：根据本次拜访沟通内容更新近期变动
   • tags：根据客户反馈和意向更新标签（新增意向标签、移除过期标签）
   • holding_products：如有新增产品认购，更新持有产品列表
   • asset_allocation：如资产配置发生变化，更新配置比例
   • risk_preference / risk_tolerance：如客户风险偏好有明显变化，更新风险属性
   • aum：如AUM规模有明显变化，更新资产规模
4. 调用API预览变更（不加 --confirm）
5. 展示变更对比，请用户确认
6. 用户确认后，调用API执行更新（加 --confirm）

智能推断规则

recent_changes 更新规则：

• 根据拜访纪要中的「客户需求与动态摸排」和「本次拜访成效」提炼最新变动
• 保留与本次拜访不相关的历史变动信息
• 新变动信息前置，历史信息后置
• 避免信息冗余，合并同类变动

tags 更新规则：

• 根据客户反馈新增意向标签（如「配置意向」「产品认购」）
• 移除已过时的标签（如「闲置资金」→ 客户已配置后移除）
• 保留与本次拜访无关的标签
• 标签总数控制在3-6个

holding_products 更新规则：

• 仅在客户明确认购新产品时新增
• 产品到期或赎回时移除
• 不确定时不修改

asset_allocation 更新规则：

• 仅在客户资产配置发生实质性变化时更新
• 比例变化需有明确依据（如客户已认购/赎回产品）
• 不确定时保持原值

risk_preference / risk_tolerance 更新规则：

• 仅在客户明确表达风险偏好变化时更新
• 变化需有充分依据（如「客户表示愿意尝试更高风险产品」）
• 不确定时保持原值

API调用

第一步：预览变更

python3 scripts/mock_cfs_api.py \
  --manager "<经理>" \
  --customer "<客户姓名>" \
  --mode smart_update \
  --updates '<AI生成的更新JSON>'

返回 status: "preview" 表示预览模式，未实际更新。changed 字段展示所有变更字段的旧值和新值。

第二步：确认更新

python3 scripts/mock_cfs_api.py \
  --manager "<经理>" \
  --customer "<客户姓名>" \
  --mode smart_update \
  --updates '<同上更新JSON>' \
  --confirm

返回 status: "updated" 表示已实际更新。

展示与确认

预览变更展示：

🔄 智能更新客户「客户XX」画像...

根据拜访记录分析，以下字段建议更新：

| 字段 | 原值 | 新值 |
|------|------|------|
| 近期变动 | 短期理财即将到期，部分活期闲置 | 短期理财已到期，部分资金已配置固收+产品，仍有部分闲置待配置 |
| 客户标签 | 存量盘活、稳健型、固收偏好、闲置资金、低利率敏感 | 存量盘活、稳健型、固收偏好、配置意向、低利率敏感 |
| 持有产品 | XX稳健理财90天、XX固收+组合、XX货币基金 | XX固收+组合、XX稳健理财180天、XX货币基金 |

📝 变更说明：
- 近期变动：客户短期理财已到期，部分资金已配置固收+产品
- 客户标签：「闲置资金」→「配置意向」（客户已有明确配置意向）
- 持有产品：XX稳健理财90天到期移除，新增XX稳健理财180天

确认更新画像？（回复「确认」更新，或指定要调整的字段）

用户确认后：

✅ 客户画像已更新：

| 字段 | 原值 | 新值 |
|------|------|------|
| 近期变动 | 短期理财即将到期，部分活期闲置 | 短期理财已到期，部分资金已配置固收+产品，仍有部分闲置待配置 |
| 客户标签 | 存量盘活、稳健型、固收偏好、闲置资金、低利率敏感 | 存量盘活、稳健型、固收偏好、配置意向、低利率敏感 |
| 持有产品 | XX稳健理财90天、XX固收+组合、XX货币基金 | XX固收+组合、XX稳健理财180天、XX货币基金 |

📋 Demo数据，正式版对接CFS。

无变化时：

🔄 智能更新客户「客户XX」画像...

✅ 画像数据无需更新，当前画像已是最新状态。

用户调整

用户确认前，可以要求调整特定字段：

• 「标签不要改」→ 从 updates 中移除 tags 字段
• 「近期变动改成XX」→ 修改 recent_changes 的值
• 「持有产品不要动」→ 从 updates 中移除 holding_products 字段

调整后重新预览，再次确认。

---

画像字段说明

字段	说明	智能更新优先级
customer_name	客户姓名	不更新
customer_level	客户等级（如高净值客户）	低（仅在明显升级/降级时）
card_type	卡类型（如白金卡）	低（仅在等级变更时联动）
aum	管理资产规模	中（大额变动时）
risk_preference	风险偏好	低（需明确证据）
risk_tolerance	风险承受能力	低（需明确证据）
asset_allocation	资产配置分布	中（配置实质性变化时）
recent_changes	近期变动	高（每次拜访后必评估）
holding_products	持有产品列表	中（认购/赎回时）
tags	客户标签	高（每次拜访后必评估）

与其他skill的接口

• 输入：客户经理姓名 + 客户姓名（来自 user_profile.json）
• 输入（智能更新）：拜访记录 + 拜访纪要 + 现有画像数据
• 输出：画像数据（供 visit-note 读取并填入纪要模板的 {customer_profile} 区域）