金蝶云星空 SOP 智能查询(ima 知识库)
用途
通过已连接的 ima 知识库(ima-mcp) 回答金蝶云星空(Kingdee Cloud)实施/运维/二开类问题。
核心价值是 降低搜索量:同类问题优先从历史工单直接获取结论,避免重复翻开发 SOP、实施文档、金蝶社区。
何时触发
当用户提出以下类型的问题时使用本 skill:
- 某单据(资产接收单、费用报销单、销售出库单、采购订单、发票等)的字段在「审批/提交/保存」时能否 修改 / 锁定 / 必录 / 可见
- 字段被锁定、灰色不可改、暂存可编辑保存后不可改
- 单据下推(上推/下查)后字段控制
- BOS 设计器调整字段属性、服务规则、实体服务规则
- 审批流节点字段可编辑性配置
- 任何 "金蝶 + 字段 + 状态/权限" 组合的配置咨询
输入要求(必填,缺则先追问)
每次查询必须明确以下两项,才能直接定位到具体客户、避免全盘检索:
- 客户名称(如「浙江巴泰医疗科技有限公司」「浙江拓峰科技」)——用于在工作订单表的 客户 列精确过滤,只查该客户的记录。
- 问题 / 需求描述(如「资产接收单审批时这几个字段能否设置为可修改」)——用于关键词匹配工单的「问题描述」列。
若用户未提供客户名称,先追问「请问是哪个客户的问题?」,不要直接对全库做宽泛检索。
明确客户后,优先在 search_knowledge 结果中按客户名二次过滤,再 fetch_media_content 后在解析阶段用客户名做行级筛选。
前置条件
- ima-mcp 连接器已连接(
connector-status中ima-mcp为 connected)。 - 知识库中存在「客户服务SOP」类知识库,内含 历史工单表(通常为
00001历史工单.xlsx,ima 返回为 markdown 表格)。 - 知识库 ID 因账号而异,需先用
get_knowledge_base_list定位,不要硬编码。
分层搜索策略(核心)
严格按照以下优先级执行,命中即停,不再向下展开,以最小化搜索量:
第 1 层:客户 SOP 历史工单(必须最先查,且按客户过滤)
get_knowledge_base_list找到「客户服务SOP」类知识库,取得knowledge_base_id。search_knowledge(在该知识库内)用 「客户名 + 问题关键词」 组合检索,例如「浙江巴泰医疗 资产接收单 审批 可修改」。检索结果优先按客户命中。- 若命中相似工单:
- 用get_knowledge_list+fetch_media_content拉取工单表完整内容(大文件为单行 JSON,按 markdown 表格行解析)。
- 解析阶段 先按「客户」列过滤出该客户的全部记录,再在其中按问题关键词匹配同款/同类工单:问题类型、处理方案、解决人、时间。
- 直接据此给出结论,跳到第 2、3 层不需要再查。
第 2 层:开发 SOP / 实施文档(仅当第 1 层无命中时)
- 在开发 SOP / 实施文档类知识库搜索同类字段控制案例,用于补充「可能存在的问题」。
第 3 层:金蝶官方社区(仅当第 1、2 层都无命中时)
- 用 WebSearch 检索金蝶社区(vip.kingdee.com)官方解答,附上可点击链接。
- 参考链接见
references/kingdee_field_locking.md。
> 原则:有历史工单 → 不读开发 SOP / 实施文档 / 金蝶官方;无历史工单 → 才依次读开发 SOP → 金蝶官方。
标准回复格式(固定三段式)
无论命中哪一层,最终回复均按以下结构输出,保持简洁:
1️⃣ 历史相似工单及解决方案(来源:客户服务SOP 知识库)
| 工单号 | 客户 | 问题 | 解决方案 | 解决人/时间 |
结论:能/不能设置 + 一句话依据。
2️⃣ 可能存在的问题(来源:开发SOP / 实施文档)
列出字段被锁定的常见控制点 + 风险提示(见 references)。
3️⃣ 金蝶官方解决方案(来源:金蝶社区)
官方做法要点 + 🔗 社区链接。
- 若第 1 层命中:第 2、3 层可省略或简写为「已有历史工单支撑,详见上」。
- 若未命中历史工单:第 1 层标注「未找到相似历史工单」,第 2、3 层正常展开。
解析历史工单表的要点
fetch_media_content 返回内容可能很大,按以下方式提取:
- 内容为 markdown 表格,表头以 |唯一性ID 开头;每行以 | 分隔。
- 用 Python 解析:按 \n 分行 → 识别表头行 → 先按「客户」列筛选出目标客户的所有行 → 再在其中按问题关键词(审批/字段/锁定/必录/可改/单据名)匹配。
- 关键列索引(从 0 起,按实际表头对齐):问题描述、问题类型、客户、工单号、解决人(创建人)、处理方案。
- 若目标客户在该表中无记录,说明第 1 层未命中,按分层策略进入第 2 层。
领域知识
金蝶单据字段「不可改/锁定」通常由 4 处控制,排查需逐一确认(详见 references/kingdee_field_locking.md):
1. 单据类型控制(字段勾选「修改时不可维护」)
2. 单据状态控制(BOS 单据状态「审核中」锁定)
3. 实体服务规则(如「提交后锁定××字段」)
4. 流程节点界面配置(审批流节点字段锁定)
Resources
references/
kingdee_field_locking.md— 字段锁定的 4 类控制点详解、典型工单案例、金蝶官方社区链接,供需要时加载。