全国市场潜量洞察报告员

1.1 功能简介

全国市场潜量洞察报告员，适用于帮助管理员生成硬编排格式的全国规模以上客户市场潜量报告，包括数据概览与趋势、市场占有率分析等内容。

1.2 使用场景

支持生成如下分析报告：

• 全国各行业市场潜量分析报告；

• 全国某行业市场潜量分析报告；
  

• 某省份各行业潜量分析报告；

• 某省份某行业潜量分析报告。
  

1.3 效果演示

以生成全国各行业规上市场潜量分析报告为例，效果如下所示：

2.1 前置操作

以管理员身份登录 Data Agent 平台，添加客户市场潜量分析相关的数据与知识库，并创建「全国市场潜量洞察报告员」Agent，进入 Agent 配置页面。

操作步骤可参考文档：创建Agent

2.2 基础配置

1）选择已在「管理后台>模型」中添加过的 AI 大模型，这里选择「deepseek-v3.2」模型

2）配置详细的系统提示词，帮助 Agent 明确角色定位、技能流程、调用技能，该示例提示词参考如下：

# 角色定义
你是一个规上客户潜量分析报告撰写专家

# 行为约束
1、当遇到涉及报告生成的问题时，必须调用报告生成技能进行报告生成，不允许基于已有报告直接输出报告内容，不允许编造数据
2、对报告生成总结时，只需要进行简要的文字描述，不要提供附件、图表等内容

2.3 添加数据

将 FineBI 中用于生成分析报告的市场潜量类仪表板数据添加至 Agent 中。

2.4 添加技能

选择并添加「仪表板报告生成」技能，基于报告的硬编排特性，我们在此处选择「上传报告模板」，通过 AI 解析并生出一套报告模板：

2.4.1 调整技能章节提示词

根据实际报告需求，调整 AI 生成的报告提示词：

1）全篇提示词

添加全篇提示词，用于约束和规范整篇报告的风格和格式，并且定义作用于整篇报告的字段过滤逻辑等。本示例的全篇提示词如下：

整体报告风格和格式要求：
1.结论分析需要自然语言描述，禁止不通顺
2.只客观展示分析内容和关键数据原文
3.关键数据需要加粗（使用**加粗时应在加粗符号前后固定添加一个空格，如"销售额和成本额分别为 **xxx** 和 **xxx**"，注意xxx前后没有空格），不要描述数据源的来源、字段的来源等
过滤条件填写规则：
1. 对于时间相关的参数: 如果用户查询中没有明确提到年份，则默认填入2025，不要填入null
2. 以下参数名只能填入特定的参数值：
- 参数名为"区域"：仅能填入"东区"/"西区"/"南区"/"北区"
- 参数名为"省份"：仅能填入具体省份的名称，若用户输入为简称则需补全为全称，全称包括：安徽省, 澳门特别行政区, 北京市, 福建省, 甘肃省, 广东省, 广西壮族自治区, 贵州省, 海南省, 河北省, 河南省, 黑龙江省, 湖北省, 湖南省, 吉林省, 江苏省, 江西省, 辽宁省, 内蒙古自治区, 宁夏回族自治区, 青海省, 山东省, 山西省, 陕西省, 上海市, 四川省, 台湾省, 天津市, 西藏自治区, 香港特别行政区, 新疆维吾尔自治区, 云南省, 浙江省
- 参数名为"Kline名称"：仅能填入"石油化工"/"传统电力"/"钢铁"等具体行业名称
  - 不能填入"各行业"这样抽象的参数，不能填入"Kline行业xxx"
  - 若用户查询没有具体的行业名称，则不要填写
  - 若用户查询的行业带有"行业"后缀，则去除（如查询为"石油化工行业"，只保留"石油化工"）
- **注意**："区域"和"省份"参数只能填写其中的一个，若填写了"区域"则不需要填写"省份"，若填写了"省份"则不需要填写"区域"
- **特殊情况**：若用户查询[地区]明确为【全国】或【各区域】或【各省份】，则直接填入"东区,西区,南区,北区"，不要填写"省份"参数

2）章节标题

将报告标题、章节标题修改为实际报告标题，以【】作为占位符，标注地区、行业、年份、省份等变量字段。技能在执行过程中，将自动匹配用户提问中的对应维度信息，完成内容的动态适配与生成。

3）章节内容

通过自然语言描述需要技能在该章节输出的图表内容或分析方向，提示词内容包含以下规则：

• 数据源选取规则；

• 字段筛选规则；

• 指标等计算逻辑规则；

• 图表格式规则。

本示例的章节提示词内容如下：

【地区】【行业】规上客户潜量分析报告
本报告基于2017年至2023年规上客户数据，给到系统性诊断分析。报告将从区域/行业/客户进行深入分析，旨在全面呈现规上客户在区域及行业中的现状，识别潜量较大的区域/行业/客户为后续赢取提供数据支撑
（1）标题填写规则：【地区】、【行业】占位符需要基于用户提问填入具体名称，规则如下：
[地区]来源于用户提问的具体地区，如全国/具体区域/具体省份（注：若用户提问没有提到具体地区，则默认填入"全国"）
[行业]来源于用户提问的具体行业，如石油行业（注：若用户提问没有提到具体行业，则不需要填入[行业]）
报告标题中不允许保留【地区】【行业】的占位符
（2）引言填写规则
引言部分为固定文案，直接写入报告的标题下方，直接以正文格式展示
引言中的2017年至2023年表示参考数据的年份，非报告的基准年份，不要写入到标题中
一、区域分析与趋势
区域数据概览
基于用户提问年份的组件数据源生成一个区域数据表格，如果用户提问地区为全国，则选取"区域年份数据"组件和"区域复合增长率"组件，如果用户提问地区为具体省份，则选取"区域省市数据"组件和"省市复合增长率"组件，然后基于选取的两个组件生成区域数据表格，包括以下字段：
Region：根据用户提问的地区选取，规则如下
如果用户提问为【全国】，则对应于"区域年份数据"组件的"区域"字段
如果用户提问为【具体省份】，则对应于"区域省市数据"组件的"城市"字段
营收(亿元)([对比年份])：来源于对应组件的“营业收入(亿元)（对比年份）”字段
数据源为(亿元)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
字段名中的[对比年份]需要替换为"对比年份"字段的具体年份
潜量(kL)([对比年份])：来源于对应组件的“潜量(KL)（对比年份）”字段
数据源为(kL)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
字段名中的[对比年份]需要替换为"对比年份"字段的具体年份
客户数：来源于对应组件的“客户数”字段
格式：含千分位，整数
售出(kL)：来源于对应组件的“售出(KL)”字段
数据源为(kL)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
SOW%：来源于对应组件的“市场占有率”字段
格式：百分比，四舍五入保留1位小数
交易客户数：来源于对应组件的“交易客户数”字段
格式：含千分位，整数
CAGR复合增长率：基于以下规则进行计算后填写
从选取的复合增长率组件中获取与区域对应的"营业收入(2023年)"和"营业收入(2017年)"两个字段的值
CAGR复合增长率=(营业收入(2023年)/营业收入(2017年))^(1/6)-1，其中（1/6）为固定值，表示2017年至2023年的间隔
格式：百分比，四舍五入保留1位小数
CAGR复合增长率是一个固定年份（2017年-2023年）的分析指标，与用户提问[年份]无关
字段展示顺序：Region、营收(亿元)([对比年份])、客户数、潜量(kL)([对比年份])、CAGR复合增长率、售出(kL)、SOW%、交易客户数
格式要求：必须使用markdown表格格式展示以上字段
只展示表格数据，不要数据源的来源、字段的来源、格式、计算逻辑、计算公式等描述，不要表格的标题
区域整体数据
基于年份为2023年和2025年的两组组件数据（注意组件选取原则：如果用户提问地区为全国，则选取"区域年份数据"组件，如果用户提问地区为具体省份，则选取"区域省市数据"组件），选取区域、潜量、售出、市场占有率（即SOW指标）、交易客户数这几个字段，遵循以下分析思路进行分析：
（1）基于2025年的数据，筛选出高潜量且低市场占有率的三个地区，筛选规则如下：
先将所有行业按潜量进行降序排列，筛选出潜量最大的前5个的地区；基于筛选出的地区，按SOW进行升序排列，选出SOW最低的3个地区作为最终的分析对象。
描述要求：筛选过程不需要展示，只需要描述筛选出的地区以及相关的指标，若符合条件的地区总数不足要求数量，则以实际存在的地区数量为准，全部纳入分析，无需补齐
（2）核心数据的对比
基于2023年和2025年的组件数据，对（1）中选出的Top3的区域，输出包含“售出量(kL)”、“交易客户数”、“市场占有率(SOW%)”、“单客平均售出量”四个指标的2023年值、2025年值、变化量、变化率的对比表格。
SOW% = 售出 / 潜量；单客平均售出量 = 售出 / 交易客户数。
格式要求：使用表格展示，注意Markdown表格后不要连续写两个换行符\n
（3）SOW 变化原因深度拆解
对每个Top3的区域，进行SOW%从2023年到2025年变化的因素分解分析。当前潜量实际不变，SOW% 变化主要由售出量变化驱动，售出量受交易客户数和单客平均售出量影响。
分解步骤：计算总售出变化量；计算交易客户数增长带来的贡献；计算单客平均售出量变化带来的影响；并验证两者之和约等于总售出变化量。
描述要求：不需要描述计算和验证过程，直接给出结果
格式要求：列举区域的指标数据时使用 - 符号（Markdown无序列表）进行展示
（4）给出结论
综合分析结果，给出明确结论。结论需指出导致 SOW% 变化的根本原因，并说明是否存在“增员不增效”的情况。
二、行业分析与趋势
行业数据
基于用户提问年份的“Kline行业数据”组件数据源和"行业复合增长率"组件数据源，生成一个行业数据表格，包含以下字段：
Kline行业：来源于组件中的“Kline名称”字段
若Kline名称为空，则展示为“其他行业”
营收(亿元)([对比年份])：来源于该组件的“营业收入(亿元)（对比年份）”字段
数据源为(亿元)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
字段名中的[对比年份]需要替换为"对比年份"字段的具体年份
客户数：来源于该组件的“客户数”字段
格式：含千分位
潜量(kL)([对比年份])：来源于该组件的“潜量(KL)（对比年份）”字段
数据源为(kL)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
字段名中的[对比年份]需要替换为"对比年份"字段的具体年份
售出(kL)：来源于该组件的“售出(KL)”字段
数据源为(kL)的数量单位，无需再次转化
格式：含千分位，四舍五入保留1位小数
SOW%：来源于该组件的“市场占有率”字段
格式：百分比，四舍五入保留1位小数
交易客户数：来源于该组件的“交易客户数”字段
格式：含千分位
CAGR复合增长率：基于以下规则进行计算后填写
从"行业复合增长率"组件中获取与行业对应的"营业收入(2023年)"和"营业收入(2017年)"两个字段的值
CAGR复合增长率=(营业收入(2023年)/营业收入(2023年))^(1/6)-1，其中（1/6）为固定值，表示2017年至2023年的间隔
格式：百分比，四舍五入保留1位小数
字段展示顺序：Kline行业、营收(亿元)([对比年份])、客户数、潜量(kL)([对比年份])、CAGR复合增长率、售出(kL)、SOW%、交易客户数
内容要求：表格中必须展示“Kline行业数据”组件数据源中提供的全部行业，只展示数据，不要数据源的来源、字段的来源、格式、计算逻辑等描述
格式要求：表格中必须按照“CAGR复合增长率”字段进行降序排列，注意Markdown表格后不要连续写两个换行符\n
行业整体分析
基于2017年和2025年这两个年份的“行业明细数据”组件数据，选取行业、营业收入、市场占有率、交易客户数这几个字段，以及计算的行业的CAGR复合增长率，遵循以下分析思路进行分析：
首先描述CAGR最高的行业：描述CAGR最高的行业从2017年至2023年的CAGR数据变化，并说明所有行业的CAGR的平均值。
基于“行业复合增长率”组件数据，计算行业的CAGR复合增长率（不需要生成报告，只用于数据查询），计算规则如下
获取行业对应的"营业收入(2023年)"和"营业收入(2017年)"两个字段的值
CAGR复合增长率=(营业收入(2023年)/营业收入(2017年))^(1/6)-1，其中（1/6）为固定值，表示2017年至2023年的间隔
格式：百分比，四舍五入保留1位小数
年份基准说明：CAGR复合增长率是一个固定年份（2017年-2023年）的分析指标，与用户提问[年份]无关
参考示例：
示例一（多个行业）：目前[CAGR最高的行业名称]行业2017年至2023年CAGR增长达到[该行业的CAGR值]%，高于其它行业，整个行业的平均CAGR为[所有行业CAGR的平均值]%。
示例二（仅有1个行业）：目前[唯一个的一个行业名称]2017年至2023年CAGR增长达到[该行业的CAGR值]%。
然后逐个分析每个行业的市场占有率：按行业CAGR从高到低的顺序，依次对每一个行业进行描述。以2017年到用户提问[年份]的时间区间为时间基准，依次对每个行业进行市场占有率分析：先描述该行业从2017年到用户提问[年份]的时间区间的市场占有率的具体数值变化，然后选择性地描述四个候选指标（营业收入、潜量、售出、交易客户数）的具体数值变化，并基于指标关系从四个候选指标中选取导致了市场占有率变化趋势的若干个指标，说明这若干个指标对于市场占有率存在[正面/负面]影响
时间基准：选择【2017年】和【用户提问[年份]】两个时间点，匹配组件数据源的"当前年份"字段对应的数据
用户提问[年份]：如果用户提问中没有明确提到年份，则默认年份显示为2025年
指标关系：市场占有率=售出[当前年份]/潜量[对比年份]；交易客户数[当前年份]和售出[当前年份]是强正关系；营收[对比年份]和潜量[对比年份]为强正关系（即：交易客户数、售出的增加会对市场占有率提升起到正向影响；交易客户数、售出的减少会对市场占有率提升起到负向影响；潜量、营收的增加会对市场占有率的提升起到负向影响；潜量、营收的减少会对市场占有率的提升起到正向影响）
潜量和营业收入字段的年份为字段名对应的[对比年份]，要求描述时不要说明对应的年份，直接描述为：潜量/营业收入从xx[下降/上涨]到xx，[下降/上涨]了xx%
候选指标选取原则：以行业的【市场占有率】的变化结果为导向，反推导致这个变化结果的候选指标（即：若市场占有率下降，则只需找出对市场占有率有负向影响的若干个指标进行描述，不要描述对市场占有率有正向影响的指标）
特殊情况：若某地区的"市场占有率"字段的数值始终为0%，则描述为"市场占有率从2017年到用户提问[年份]均为0%"，并给出候选指标的具体数值变化或百分比变化，但不要描述这些候选指标对于市场占有率变化的影响
参考示例（每个行业加上序号，仅有一个行业则不需要添加序号）：
1.xx行业：交易客户数从2017年的xx家下降到用户提问[年份]的xx家，下降了xx家，营收从xx亿上升到xx亿元，增长了xx%，其中市场占有率从xx%下降到xx%。交易客户数的下降以及营收的上涨对于市场占有率的提升起到负向影响
2.xx行业：交易客户数从2017年的xx家上升到用户提问[年份]的xx家，售出从xxKL增长到xxKL，增长分别达到xx%和xx%，其中市场占有率从xx%上升到xx%。交易客户数和售出的上升对于市场占有率的提升起到正向的影响
3.xx行业：实际售出从2017年的xxKL上升到用户提问[年份]的xxKL，上涨了xx%，潜量从xxKL降低到xxKL，下降了xx%，其中市场占有率从xx%上升到xx%。实际售出的上升和潜量的下降对于市场占有率的提升起到正向的影响
格式和内容要求：
禁止输出任何表格，禁止使用任何箭头、加减号代表数据变化，严格参照输出格式，使用上涨或下降描述数据变化
禁止使用括号展示具体数据，严格按照输出格式直接展示数据
禁止进行任何形式的归因、解释或推测性分析
禁止描述数据源的来源、字段的来源、计算逻辑等
必须展示“行业明细数据”组件提供的全部行业，不要遗漏
每一个行业的描述使用Markdown有序列表展示，注意换行

4）添加仪表板组件至报告

选择仪表板中相应明细表组件，分别做为表格和附件插入第三、四章节，技能生成报告时将对应输出表格与附件。

2.4.2 配置章节数据

完成章节提示词的调整后，需要为每一章节配置可用数据。点击章节标题左侧  按钮，选择已经在「Agent 配置页面>数据」中添加的仪表板中的组件。

本示例中，章节可用数据如下表所示：

2.5 配置会话体验

1）设置合适的欢迎语，例如：“生成全国规模以上客户市场潜量报告，包括数据概览与趋势、市场占有率分析等”

2）设置首轮推荐问题，提高问答效率，可参考下表：

2.6 测试并发布

以上内容配置完成后，可在右侧预览测试区域实时查看 Agent 首页效果，并发送对话测试 Agent 的回答准确度，测试无误后即可保存并将「全国市场潜量洞察报告员」发布至工作台与独立 URL。

管理员搭建并发布 Agent 后，普通成员用户即可在 Data Agent 平台首页选择并进入 Agent，新建会话进行提问。

与 Agent 对话以及会话操作详情，可参考文档：使用Agent 2.3 与Agent对话