1. 产品说明
1.1 产品定位
客户经营教练Agent是一款面向销售团队的智能辅导型Agent，聚焦“客户当前状态如何、是否值得持续投入、下一步应该如何经营”这几个高频问题。它围绕客户对象，自动完成客户评分、经营诊断、外部尽调补充和经营建议输出，帮助销售和管理者快速建立对客户的全局认知。
1.2 核心价值
在客户经营过程中，销售团队通常会遇到几个典型难题：
- 不清楚客户当前的整体状态，只能看到局部信息
- 知道客户需要经营，但说不清重点应该放在哪里
- 对客户关系、组织突破口和增长空间缺乏系统判断
- 缺少面向下一步经营动作的具体建议
- 团队成员对同一客户的判断不一致，难以形成统一认知
客户经营教练Agent的核心价值，就是把“碎片化认知”变成“结构化经营判断 + 标准化经营建议”，帮助团队提升客户经营质量和持续投入效率。
2. 用户使用
2.1 在ShareAgent对话中使用
在ShareAgent中直接发起客户诊断及建议类意图询问，例如：
1、生成这个客户的画像
2、客户当前状态和经营重点是什么
3、这个客户值不值得继续投入，下一步怎么经营？
提出客户诊断/建议类问题后，ShareAgent会将问题自行路由到“客户经营教练Agent”进行处理。
客户经营教练Agent接收到问题后执行 客户数据查询 → 客户尽调 → 客户评分 → 诊断并生成建议 ，最终生成报告（Markdown及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由以下 4 个 skill 构成：
sfa-biz-router：路由 skill，负责识别当前问题属于线索、商机还是客户，以及分别处于什么状态/阶段，并推荐下游处理Skill的能力。
sfa-account-due-diligence-report：客户尽调 skill，负责通过外部搜索补充客户公开信息，形成尽调结果。
sfa-account-score：客户评分 skill，负责读取客户及关联数据，完成评分并输出评分依据。
sfa-account-diagnosis：客户诊断 skill，负责基于评分结果做进一步诊断，输出风险、策略和行动建议
3.4 客户经营教练Agent的运行逻辑
3.4.1 输入问题
即在前文2.1、2.2中讲的ShareAgent中发起询问及Agent自动化任务 对Agent能力的触发。
3.4.2 识别卖方行业
客户经营教练Agent的诊断逻辑不是一套通用模板硬套所有行业，而是要先知道“卖方是谁、卖的是什么、属于什么行业”，才能选对后面的诊断 Flow、评分标准和推进方法。
卖方行业识别的方法：sfa-account-score、sfa-account-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
Agent中的4个Skill调用关系：sfa-biz-router → sfa-account-due-diligence-report → sfa-account-score → sfa-account-diagnosis。
sfa-account-score 、sfa-account-diagnosis这两个Skill执行处理流程及评分/诊断规则时会根据租户所在行业查询Know-how，以查到的Know-how作为流程及评分/诊断规则标准。
行业查询Know-how查询方式：每个Skill的references/下的.md文件，在头部均有一段优先查询远端文档(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租户不可见。
Skill的结构构成：
路由 skill：sfa-biz-router
SKILL.md描述中有定义Flow，此文件在项目实施落地过程中不建议做调整。
references/routing-methodology.md中描述具体路由标准和状态/阶段识别标准。项目实施落地过程中，此文件中的“状态/阶段识别标准”部分可以基于不同行业/客户做适当调整。
客户尽调 skill：sfa-account-due-diligence-report
- references/00-workflow.md 定义“整个尽调报告怎么跑”，它是总流程编排说明，负责约束从信息收集、分析判断到报告生成的执行顺序。
- references/crm-cli-map.md 定义“CRM 数据该用哪些 CLI 查”，它是 CRM 查询命令映射表，负责指导如何从 CRM 拉取客户尽调所需的内部数据。
- references/enterprise-cli-map.md 定义“企业外部信息该用哪些 CLI 查”，它是企业信息查询命令映射表，负责指导如何获取外部工商、企业背景等尽调信息。
- references/evidence-rules.md 定义“哪些内容能算证据、怎么使用证据”，它是证据使用规则，负责约束报告中的判断必须能回溯到明确来源。
- references/report-template.md 定义“标准尽调报告怎么写”，它是报告正文模板，负责约束各章节的内容结构与呈现顺序。
- references/html-report-template.md 定义“HTML 报告怎么呈现”，它是 HTML 报告模板，负责约束尽调报告在页面化展示时的结构与样式承载方式。
- references/output-contract.md 定义“最终输出必须满足什么约束”，它是输出契约说明，负责约束交付内容、字段要求和结果边界。
- references/quality-checklist.md 定义“报告完成前要检查什么”，它是质量检查清单，负责在交付前校验完整性、一致性和可信度。
- references/role-output-rules.md 定义“不同角色视角下怎么输出内容”，它是角色化输出规则，负责约束报告在不同使用角色下的表达重点和口径。
- references/seller-context-rules.md 定义“如何结合卖方自身背景来解读客户”，它是卖方上下文规则，负责让尽调结论结合我方业务定位、能力边界和合作场景。
- references/skill-composition.md 定义“这个 skill 会组合哪些能力来完成任务”，它是 skill 组合说明，负责解释尽调报告生成过程中各子能力或子 skill 的分工关系。
客户评分 skill：sfa-account-score
- references/data-query.md 定义“查什么数据、怎么查”，它是客户评分前的数据查询说明，负责定位客户对象、查询主数据、销售记录以及各评分维度所需的事实证据。
- references/score-standard.md 定义“怎么打分、怎么评级”，它是客户评分规则本身，负责把查到的事实转换成分数、评级和准入判断。
- references/output_template.md 定义“最终评分报告怎么写”，它是客户评分结果的输出模板，负责约束基本信息、综合评估、分维度评分结果和结论建议的呈现结构。
客户诊断 skill：sfa-account-diagnosis
- references/data-query.md 定义“查什么数据、怎么查”，它是客户诊断前的数据查询说明，负责定位客户对象、查询主数据、销售记录以及诊断所需的关键上下文。
- references/flow.md 定义“怎么分析、按什么顺序生成诊断”，它是客户诊断的流程编排，负责组织诊断视角、分析步骤和输出顺序。
- references/global-diagnosis-criteria.md 定义“怎么判断诊断结论是否成立”，它是全局诊断标准，负责约束客户状态、推进质量、风险判断和跟进策略的统一口径。
- references/output_template.md 定义“最终诊断报告怎么写”，它是客户诊断报告的输出模板，负责约束概要、核心结论、诊断分析、风险与建议等内容的呈现结构。
- references/risk-identification-knowhow.md 定义“怎么识别和表达风险”，它是风险识别方法说明，负责把客户短板、推进问题和管理风险整理成分级风险输出。
- references/stage-action-knowhow.md 定义“下一步动作怎么给”，它是阶段推进方法论，负责把当前问题和阶段状态转成跟进策略与具体行动建议。
- references/customer-focus-rules.md 定义“怎么判断客户经营重心”，它是客户聚焦规则说明，负责识别当前客户经营中最需要优先关注的问题与资源投入方向。
- references/growth-space-rules.md 定义“怎么判断增长空间”，它是增长潜力判断规则，负责评估客户的可拓展空间、增长机会和后续经营价值。
- references/org-breakthrough-rules.md 定义“怎么判断组织突破口”，它是组织突破分析规则，负责识别客户内部组织关系中的关键突破点、推进抓手和协同路径。
3.4.3 按需取CRM数据
sfa-account-score 、sfa-account-diagnosis两个Skill的references/data-query.md 中定义运行该Skill需获取哪些关联数据。
3.4.4 形成诊断
sfa-account-score评分过后会将评分结果及评分依据传递至下游sfa-account-diagnosis进行诊断，由sfa-account-diagnosis生成诊断结果。
3.4.5 模板化输出
最终客户诊断报告由sfa-account-diagnosis的输出模板references/output_template.md来定义。
输出形式分为两种：
1、Markdown，该格式报告严格按照references/output_template.md约束输出。
2、HTML，该格式报告是在Markdown输出的基础上，调用scripts/build-html-report.py脚本，按照assets/output.html样式进行输出。