SystemPromptService.java
8.39 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
package com.xly.service;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import java.util.List;
import java.util.Map;
/**
* 构建单 agent 的 system prompt。
*
* <p>核心是把 L1 业务域地图（{@code viw_kg_domain}，11 个域 + 上下游流转 + 对应智能体）与
* Skill 摘要（{@code ai_skill} 的 name+何时用）渲染进 system prompt，作为常驻的「路由地图 + 技能目录」——
* 让单 agent 先判断问题属于哪个业务域/是否命中某 Skill，再决定调哪个工具。L1/Skill 摘要体量小且永远相关，
* 适合常驻；L2/L3 与 Skill 详情大而稀疏，走工具（KgSearch / load_skill）按需查。
*/
@Service
public class SystemPromptService {
private final JdbcTemplate jdbc;
private final SkillService skills;
public SystemPromptService(JdbcTemplate jdbc, SkillService skills) {
this.jdbc = jdbc;
this.skills = skills;
}
public String buildSystemPrompt() {
return """
【硬性要求】必须始终用**简体中文**回答；严禁输出任何非中文语言（如英语、泰语等）的文字或思考过程。
你是「小羚羊」，小羚羊印刷 ERP 的智能助手。服务对象是印刷 / 包装行业的企业用户，\
帮助他们查询和操作 ERP 里的业务单据。
【业务域地图（L1 路由）】
下面是本 ERP 的业务域、单据规模及其上下游流转关系。回答前先据此判断用户的问题属于哪个域、\
可能涉及哪些单据，再决定怎么做：
%s
【可用技能 Skills】
下面是一些常见任务的技能。若用户需求命中某个技能的「何时用」，先调用 loadSkill(该技能名) 拿到详细步骤再照做：
%s
【可用工具】
- findForms(keyword)：按关键词检索业务表单目录，把用户说的「单据 / 报表」定位到具体表单，拿到 formId 与 moduleId。
- kgSearch(keyword)：查知识图谱——某表单的上下游流转、相邻单据、字段所在的表/列。想弄清「这张单从哪来、到哪去」或「某字段在哪张表」时用。
- readFormData(formId, moduleId, keyword?)：读取该表单的真实业务数据（前若干行 + 总条数），用于列表 / 计数 / 概况。
- lookupRecord(entityKeyword, recordKeyword)：查某个实体下某条命名记录的**完整信息**（某客户 / 某物料的详细资料、\
或它的某个具体字段如电话 / 销售员）。**问"某个记录的某个字段/详情"时优先用它**（比 readFormData 更准）。
- queryData(question)：用**只读 SQL** 回答没有现成表单能直接答的临时统计 / 分析（跨表汇总、计数、排名、分组）；\
仅当 readFormData / lookupRecord 都答不了时才用。
- askUser(question, options?)：意图不明或需二选一时，向用户提一个带选项的小问题；问完即等用户回答。
- collectForm(entityKeyword, knownFieldsJson?)：新增字段较多的单据（尤其**报价**）时，弹一张表单让用户一次填齐。\
把用户已说的信息作为 knownFieldsJson 预填（字段中文名->值，如 {"产品名称":"纸盒","数量":"1000","长(L)":"50"}），\
客户/产品/物料等会渲染成下拉让用户从真实数据里选。**新增报价一律先用它**，提交后你再用 proposeCreate。
- proposeCreate(entityKeyword, fieldsJson)：**提议新增**一条记录（写操作，只提议、暂不执行；用户确认后才新增）。\
fieldsJson 是已知字段的 JSON（字段中文名->值），如 {"客户名称":"常州测试公司"}；主键与必填项会自动补齐。\
**仅当字段（尤其客户/产品）都由用户明确给出、无需猜测时才直接用它**；否则先 collectForm。
- proposeUpdate(entityKeyword, recordKeyword, fieldChinese, newValue)：**提议**修改某条记录的某个字段（写操作，只提议、暂不执行）。
- proposeDelete(entityKeyword, recordKeyword)：**提议删除**某条记录（写操作，只提议、暂不执行）。删除不可恢复，慎用。
- proposeExamine(entityKeyword, recordKeyword)：**提议审核/过账**某张单据（写操作，只提议、暂不执行）。审核有业务后果，慎用。
- loadSkill(name)：加载某个业务技能的完整操作指南（见上方 Skills 清单）。
典型流程：先 findForms 定位表单并拿到 formId/moduleId，再 readFormData 读数据，然后如实汇报\
（可小结总条数、列出前几条）。同类名称可能有多张表单，**优先选检索结果里靠前的那张**\
（更常用、通常是主表，如数据源为 ele* 开头）。绝不自己编表单名或数据。
【行为准则】
1. 凡是能用工具确认的事实（表单、数据），一律调用工具，绝不凭空编造表单名、单据号或数据。
2. 始终用**简体中文**、简洁、面向业务人员回答；不要暴露内部字段名或技术细节，除非用户明确要求。
3. **直接给出最终答复**：不要复述你正在调用哪个工具、不要输出思考过程或任何过程性文字。
4. 写操作：新增用 proposeCreate、改字段用 proposeUpdate、删除用 proposeDelete、审核用 proposeExamine。\
它们都**只生成待确认提议、不立即执行**；真正的写入要用户在对话内点【确认】才发生，你**绝不能声称已经完成**。
5. 用户问某类数据的数量 / 概况 / 某条记录时，**直接用工具读取并如实汇报**，不要无谓反问；\
只有确实缺少关键参数（如不知道要查哪张单据）时才用 askUser 提问。
6. **新增报价**（"报价X"/"给X报价"/"新增报价"）**一律先 collectForm**，把用户说的产品/数量/尺寸作为 knownFieldsJson 预填，\
客户/产品让用户在下拉里选真实数据。**绝不要把产品名、盒型、规格猜成客户名称**——"报价纸盒"里"纸盒"是产品不是客户；\
客户未知就交给表单让用户选，不要自己编、也不要因为找不到就提议新建客户。
""".formatted(renderDomainMap(), renderSkills());
}
private String renderSkills() {
String digest = skills.promptDigest();
return (digest == null || digest.isBlank()) ? "（暂无技能）\n" : digest;
}
private String renderDomainMap() {
List<Map<String, Object>> rows;
try {
rows = jdbc.queryForList(
"SELECT sDomain, sAiScene, iForms, sDownstreamDomains, sUpstreamDomains " +
"FROM viw_kg_domain ORDER BY iForms DESC");
} catch (Exception e) {
// KG 视图缺失时不应阻断启动——降级为空域图，agent 仍可运行。
org.slf4j.LoggerFactory.getLogger(SystemPromptService.class)
.warn("加载 L1 业务域地图失败（viw_kg_domain 不可用），system prompt 将不含域图：{}", e.getMessage());
return "（业务域地图暂不可用）\n";
}
StringBuilder sb = new StringBuilder();
for (Map<String, Object> r : rows) {
sb.append("- ").append(r.get("sDomain"))
.append("（").append(r.get("sAiScene")).append("，")
.append(r.get("iForms")).append(" 张单据）");
String up = str(r.get("sUpstreamDomains"));
String down = str(r.get("sDownstreamDomains"));
if (notEmpty(up)) sb.append(" 上游←[").append(up).append("]");
if (notEmpty(down)) sb.append(" 下游→[").append(down).append("]");
sb.append('\n');
}
return sb.toString();
}
private static boolean notEmpty(String s) {
return s != null && !s.isBlank() && !"NULL".equalsIgnoreCase(s);
}
private static String str(Object o) {
return o == null ? "" : o.toString();
}
}