1. 产品说明
1.1 产品定位
线索转换教练Agent是面向线索管理模块的智能业务助手，围绕“线索识别 → 线索评分 → 线索诊断”形成闭环，帮助销售或销售管理者快速判断一条线索是否值得继续投入、当前处于什么成熟状态、为什么能/不能推进，以及下一步应该如何跟进。
它不是通用问答助手，也不是 CRM 自动化执行器，而是一个聚焦线索转化决策支持的教练型 Agent。其核心职责是：把用户对线索的模糊判断需求，转化为结构化评分与可执行诊断建议。
1.2 核心价值
在线索推进过程中，销售团队通常会遇到几个典型难题：
- 不清楚当前线索质量高低，难以判断是否值得继续投入
- 知道线索有问题，但说不清问题出在哪
- 缺少明确的下一步推进策略，跟进动作容易凭经验、靠感觉
- 团队成员对同一条线索判断不一致，难以形成统一认知
线索转换教练Agent的核心价值，就是把“经验判断”变成“规则化诊断 + 标准化建议”，帮助团队提升线索转化效率和推进一致性。
1.3 能力边界
- 判断线索真实状态
- 对线索进行标准化评分，评价线索质量
- 基于评分结果生成线索诊断、风险识别和跟进建议
1.4 Agent输入与输出
| 核心输入 | 说明 |
|---|---|
| 线索对象 | object_id + LeadsObj 或线索名称，用于定位目标线索 |
| 用户意图 | 如评分、诊断、是否值得跟、下一步怎么跟 |
| 评分结果 | 诊断场景必需，由 sfa-leads-score 提供，sfa-leads-score见下文3.3介绍 |
| 阶段信息 | 可选，用于辅助判断推进状态 |
| 补充事实 | 用户补充的业务背景信息 |
| 核心输出 | 说明 |
|---|---|
| 路由结果 | 判断是否为线索，并推荐进入后续 Skill |
| 状态摘要 | 输出当前线索状态与判断边界 |
| 评分结果 | 输出线索质量和成熟度评分 |
| 诊断结论 | 输出问题、风险、转化判断与建议 |
| 行动方向 | 给出下一步跟进或培育建议 |
| HTML 报告 | 按需输出诊断报告文件 |
2. 用户使用
2.1 在ShareAgent对话中使用
在ShareAgent中直接发起线索诊断及建议类意图询问，例如：
1、帮我给这个线索打分
2、这条线索值不值得继续投入
3、下一步怎么跟 / 识别推进卡点与风险
在ShareAgent的对话框中输入问题
提出线索诊断/建议类问题后，ShareAgent会将问题自行路由到“线索转化教练Agent”进行处理。
线索转化教练Agent接收到问题后执行 线索数据查询 → 线索评分 → 诊断并生成建议 ，最终生成报告（Markdown及HTML，其中HTML可选择性生成）
可选生成HTML格式报告
选择生成HTML后，Agent会产出HTML格式的报告，通过点击可以在界面中打开展示。
若需全屏查看，可点击右上角“新窗口打开”的图标实现新页签全屏查看
2.2 Agent配置自动化任务生成诊断报告
线索诊断报告除在ShareAgent中进行对话产生外，也支持配置Agent自动化任务来定时对指定条件的线索生成诊断报告。
入口：ShareAgent>自动化
2.3 在线索数据详情页中查看诊断结果
ShareAgent中对话产生的诊断报告、Agent自动化任务产生的诊断报告，都会自动展示到线索数据详情页/AI诊断 页签组件中，以便于个人后续查看或团队成员共享。
3. 管理员配置
3.1 租户所属行业配置
线索转化教练Agent进行线索评分和诊断时，会根据使用者(租户)的行业不同而选择匹配其行业的Knowhow作为评分规则和诊断及建议规范。
这就要求需知晓租户的行业信息，租户级行业信息维护入口：后台管理>业务规则管理>业务洞察Agent>业务洞察Agent设置>公司服务形态
** 延展信息：线索转化教练Agent读取租户行业并匹配行业Konwhow作为评分及诊断规范的逻辑说明见下方“3.4 线索转化教练Agent的运行逻辑”模块
3.2 配置线索对象AI诊断组件
生成的诊断报告若想在线索数据详情页进行查看，需在线索对象中放出“AI诊断”组件（拖出即可，无需其他配置）。
配置入口：后台管理>对象管理>预设对象管理>销售线索>布局
组件拖出后，会自动获取线索诊断报告的最新报告进行呈现。（诊断结果的呈现不按人员做区分，A员工触发的诊断结果，B员工可看，且B员工重新触发诊断，结果会覆盖A员工所生成结果）
3.3 线索转化教练Agent的构成
线索转换教练Agent由以下 3 个 skill 构成：
sfa-biz-router：路由 skill，负责识别当前问题属于线索、商机还是客户，以及分别处于什么状态/阶段，并推荐下游处理Skill的能力。sfa-leads-score：线索评分 skill，负责读取线索及关联数据，完成评分并输出评分依据。sfa-leads-diagnosis：线索诊断 skill，负责基于评分结果做进一步诊断，输出风险、策略和行动建议
3.4 线索转化教练Agent的运行逻辑
3.4.1 Skill的调用关系
Agent中的三个Skill调用关系：先路由，再评分，后诊断。
sfa-biz-router先做入口识别与路由 负责判断对象是不是线索、当前状态大致如何，并推荐后续该走哪个 Skill。sfa-leads-score再做线索评分 当对象已确认为线索且用户需要判断线索质量时，输出标准化评分结果。sfa-leads-diagnosis基于评分结果做诊断 必须消费sfa-leads-score的Scoring_Result，进一步输出问题判断、风险识别和跟进建议。
3.4.2 识别卖方行业
线索转化教练Agent的诊断逻辑不是一套通用模板硬套所有行业，而是要先知道“卖方是谁、卖的是什么、属于什么行业”，才能选对后面的诊断 Flow、评分标准和推进方法。
卖方行业识别的方法：sfa-leads-score、sfa-leads-diagnosis 两个Skill的references中均有data-query.md，其中均包含“卖方行业配置”查询模块，如下：
卖方行业配置（SELLER_INDUSTRY）
读取卖方主营行业配置，得到 `SELLER_INDUSTRY`，用于增强远端 knowhow 检索主题：
```bash
sharecrm sales get-config-by-key --data '{"key":"service_models"}'
```
返回结果中如存在明确行业名称，则记为 `SELLER_INDUSTRY`。
- 若返回为空、不可用或无法判断行业：`SELLER_INDUSTRY` 置空。
- `SELLER_INDUSTRY` 为空时，后续远端 knowhow 查询不拼接行业，并在诊断输出中标注“缺少卖方行业信息”。
- 不得由模型猜测行业，不得用客户行业字段替代卖方行业。3.4.2 加载诊断Flow
加载Know-how：sfa-leads-score、sfa-leads-diagnosis这两个Skill执行处理流程及评分/诊断规则时会根据租户所在行业查询Know-how，以查到的Know-how作为流程及评分/诊断规则标准。
行业查询Know-how查询方式：每个Skill的Skill.md文件，在Flow部分会有优先查询远端文档(Know-how)的指令，示例如下：
这段指令会查询 后台管理>业务规则管理>业务洞察Agent>Knowhow中的文档，过滤条件由3部分构成：
1.SELLER_INDUSTRY：赋值为“3.4.2 识别卖方行业”获取到的值，匹配文档中的"卖方(我方)/"下的行业信息，比如图中的"SaaS软件"行业。
2.scene：固定赋值"business_insight"（含义为业务洞察），匹配文档中的"场景"信息。
3.coreTopics：每个references/下的.md文件描述各不相同，匹配文档中的"核心主题"。
通过以上3点过滤条件，筛出来符合条件的文档后返回给Skill做为流程及评分/诊断规则标准。** 租户级评分/诊断逻辑若有个性化调整需求，可以通过此方式做调整 **
Know-How的存储：
**延展信息：Know-how由“纷享预设”、“租户自定义”两部分构成，其中“纷享预设”的Know-how租户不可见。
Skill的结构构成：
路由 skill：sfa-biz-router
SKILL.md描述中有定义Flow，此文件在项目实施落地过程中不建议做调整。
references/routing-methodology.md中描述具体路由标准和状态/阶段识别标准。项目实施落地过程中，此文件中的“状态/阶段识别标准”部分可以基于不同行业/客户做适当调整。
线索评分 skill：sfa-leads-score
- references/data-query.md 定义“查什么数据、怎么查”，它是评分前的数据查询说明，负责定位线索、查询主数据、销售记录以及各评分维度所需的事实证据。
- references/score-standard.md 定义“怎么打分、怎么评级”，它是评分规则本身，负责把查到的事实转换成分数和评级。
- references/output_template.md 定义“最终评分报告怎么写”，它是评分结果的输出模板，负责约束基本信息、综合准入评估、七问量化评估和三要素评估的呈现结构。
线索诊断 skill：sfa-leads-diagnosis
- references/data-query.md 定义“查什么数据、怎么查”，它是诊断前的数据查询说明，负责定位线索、查询主数据、销售记录以及卖方行业等关键上下文。
- references/flow.md 定义“怎么分析、按什么顺序生成诊断”，它是诊断生成阶段的流程编排，负责组织洞察诊断、线索画像和下一步推进。
- references/global-diagnosis-criteria.md 定义“怎么判断诊断结论是否成立”，它是全局诊断标准，负责约束诊断判断和跟进策略的统一口径。
- references/output_template.md 定义“最终报告怎么写”，它是诊断报告的输出模板，负责约束报告结构与呈现方式。
3.4.3 按需取CRM数据
sfa-leads-score、sfa-leads-diagnosis两个Skill的references/data-query.md 中定义运行该Skill需获取哪些关联数据，数据来源于。
3.4.4 形成诊断结果
sfa-leads-score评分过后会将评分结果及评分依据传递至下游sfa-leads-diagnosis进行诊断，由sfa-leads-diagnosis生成诊断结果。
3.4.5 模板化输出
最终线索诊断报告由sfa-leads-diagnosis的输出模板references/output_template.md来定义。
输出形式分为两种：
1、Markdown，该格式报告严格按照references/output_template.md约束输出。
2、HTML，该格式报告是在Markdown输出的基础上，调用scripts/build-html-report.py脚本，按照assets/output.html样式进行输出。