要让租户级语义准确，需要做好六件事
| 要做的事 | 用户需要完成什么 | 主要改善 |
| 选对范围 | 只让正式、有效、与业务有关的对象和字段参与 AI 使用 | 减少找不到、找错对象和字段 |
| 分清重点 | 给字段设置合适的高、中、低业务相关度 | 让 AI 抓住对象的核心含义 |
| 写清含义 | 补充对象描述、字段备注和枚举说明 | 减少相似对象、金额、日期和状态混淆 |
| 统一口径 | 维护企业术语、计算规则、流程和 SOP | 让回答符合本企业的说法和做法 |
| 完成更新 | 保存后执行租户语义更新，并确认任务完成 | 让调整进入实际使用状态 |
| 真实验收 | 用真实问题、同义问法和反例进行验证 | 确认用户实际提问时结果正确 |
最重要的原则 先缩小范围，再写清含义，最后用真实问题验证。不要一开始就把所有对象、字段都开放给 AI，也不要把所有字段都设为高相关。安全边界 “对 AI 不可见”不是权限设置。敏感数据仍必须依赖角色权限、数据权限和其他既有安全控制。
1 开始前先确定范围
不要从“把所有内容都维护一遍”开始。先选一个业务场景，例如销售订单分析、客户分层、合同审批或回款统计，再完成该场景的语义治理。
1.1 建议先准备三类信息
- 核心业务对象：这个场景主要涉及哪些对象，例如客户、商机、合同、订单和回款记录。
- 常用业务问题：整理 10 至 20 个真实问法，优先使用一线用户已经问过的问题。
- 当前有效口径：确认业务负责人认可的术语、指标公式、流程和 SOP，避免把历史版本录入为现行规则。
1.2 建议明确两类负责人
| 角色 | 主要职责 |
| 语义管理员 | 维护可见性、字段相关度、描述、知识条目，执行更新并记录结果 |
| 业务确认人 | 确认对象边界、字段含义、指标口径、流程和 SOP 是否符合当前业务 |
语义管理员负责“配置正确”，业务确认人负责“业务正确”。两类责任不能由系统自动替代。
1.3 什么叫“语义准确”
一次业务问答至少要通过三个判断：
- 找得对：AI 找到正确的业务对象和字段。
- 理解对：AI 正确理解状态、金额、日期、枚举和业务边界。
- 用得对：AI 按本企业当前有效的术语、规则、流程和 SOP 回答。
2 决定哪些对象和字段对 AI 可见
“对 AI 可见”用于控制 AI 是否应主动考虑某个对象或字段。开启后，AI 可以在相关问题中使用它；关闭后，可以减少测试项、历史副本和技术字段造成的干扰。
图 1 对象语义管理界面示意,界面以实际版本为准
2.1 哪些内容建议开启
- 用户会直接查询、筛选、统计或分析的正式业务对象。
- 能说明业务状态、金额、时间、分类或关系的关键字段。
- 低频但不可替代的主数据、合规对象或关键关系字段。
- 名称和说明清晰，不容易与其他对象或字段混淆的内容。
2.2 哪些内容建议关闭
- 测试、临时、备份、历史版本、停用或明确废弃的对象。
- 技术主键、同步标记、内部版本、排序值等技术字段。
- 长期无实际用途的空壳对象。
- 含义不清、重复或容易误导 AI 的辅助字段。
2.3 不确定时，用三个问题判断
- 用户会不会在业务问题中主动提到它？
- 没有它，是否会影响正确理解或完成当前业务？
- 开启它，是否容易与其他对象或字段混淆？
前两个问题均为“否”时，通常可以关闭。第三个问题为“是”时，先补充描述或备注，再决定是否开启。
2.4 调整后会有什么影响
| 调整 | 通常会带来的变化 | 不会发生的变化 |
| 关闭对象或字段 | 减少无关内容和相似内容的干扰 | 不会删除数据，也不会改变用户权限 |
| 开启对象或字段 | AI 可以在相关问题中主动考虑它 | 不代表 AI 每次都一定使用它 |
提醒 某些业务功能可能已经明确指定了对象或字段，因此“不可见”不等于任何场景都不能使用。它只用于管理 AI 的主动理解范围。
3 给字段设置合适的业务相关度
业务相关度表示“这个字段对理解该对象有多重要”。它不是必填级别、敏感级别、使用频率或权限等级。
3.1 高、中、低怎么选
| 等级 | 通俗理解 | 典型字段 |
| 高 | 不看这个字段，就很难说清对象是谁、处于什么状态或核心业务结果是什么 | 订单状态、合同金额、商机阶段、客户引用、签约日期 |
| 中 | 用户可能会查询或筛选，但它不是对象的核心定义 | 联系方式、普通说明、一般业务属性 |
| 低 | 对业务理解帮助较小，主要用于技术、内部辅助或临时处理 | 排序值、同步标记、内部备注、临时标签 |
3.2 判断是否为高相关，只问四个问题
- 它是否决定对象的身份、状态或阶段？
- 它是否是关键金额、关键业务日期或核心关系？
- 去掉它后，是否容易把该对象与相似对象混淆？
- 业务负责人是否认为它是解释该对象时必须说明的内容？
只有明确满足这些条件的字段才建议设为高。高相关字段应少而精。
3.3 调整后的影响
- 调高：AI 会更重视该字段。适合真正定义对象的字段；设置过多会让对象失去重点。
- 调中：字段仍可用于查询和筛选，但不会被当作对象的核心特征。
- 调低：减少弱业务字段对 AI 的干扰，适合技术字段和内部辅助字段。
3.4 与 AI 可见性的推荐组合
| 业务相关度 | 通常建议 |
| 高 | 对 AI 可见 |
| 中 | 对 AI 可见 |
| 低 | 对 AI 不可见 |
确有特殊业务需求时可以调整组合，但必须记录原因并进行专项验证。避免无意形成“高相关但不可见”或“低相关却大量可见”的状态。
4 写清对象描述和字段备注
可见性决定“AI 是否应该考虑”，相关度决定“哪个字段更重要”，描述和备注决定“AI 是否理解正确”。当名称相似时，描述质量尤其重要。
4.1 对象描述怎么写
一个合格的对象描述应回答四个问题：
- 用途：这个对象记录什么业务。
- 范围：什么情况下产生一条记录，包含和不包含什么。
- 区别：它与相似对象有什么不同。
- 注意事项：统计时优先使用哪些字段，有哪些常见误用。
推荐模板：本对象用于记录【业务场景】。每条记录代表【记录粒度】。包含【范围】，不包含【排除项】。与【相似对象】的区别是【区别】。分析【场景】时使用【推荐字段或关联对象】。
示例：销售订单
记录客户正式下单后的交易信息，每条记录对应一笔已确认交易。包含已签约订单，不包含报价单和意向单。统计签约金额时使用“订单金额（含税）”；分析到账情况时关联“回款记录”。
不要只写“销售订单用于记录销售订单”。重复名称不能帮助 AI 理解业务边界。
4.2 字段备注怎么写
一个合格的字段备注应回答：
- 字段表示什么。
- 单位、取值或枚举分别是什么。
- 它与相似字段有什么区别。
- 计算、筛选或使用时要注意什么。
推荐模板：本字段表示【含义】，单位/取值为【单位或枚举】。与【相似字段】的区别是【区别】。在【场景】中使用本字段；【例外或注意事项】。
示例：订单金额
客户实际签约的含税总金额，单位为元。报价金额是谈判报价，订单金额是最终成交价。统计签约金额时使用本字段；计算实际到账时使用实收金额。
4.3 特别容易写错的三类字段
| 字段类型 | 必须写清 |
| 金额 | 币种、含税或未税、计划或实际、是否受退款影响 |
| 日期 | 创建、签约、支付、到期还是业务归属时间 |
| 状态/类型 | 每个枚举的业务含义，以及哪些值应包含或排除 |
5 维护企业自己的业务知识
AI 需要知道企业“怎么说、怎么算、怎么做”。这些内容分别由术语、规则、流程和 SOP 承担。
图 2 规则和术语管理界面示意，界面以实际版本为准
5.1 该用术语、规则还是 SOP
| 类型 | 解决的问题 | 至少写清 |
| 术语 | “这个词在本企业是什么意思？” | 定义、包含与不包含、同义词、适用对象 |
| 规则 | “这件事按什么条件判断或计算？” | 对象、字段、条件、时间范围、结果、例外 |
| SOP | “遇到这个场景应该怎么做？” | 适用场景、角色、步骤、分支、完成标准、异常处理 |
5.2 简洁模板
术语模板：【术语】是指【定义】。适用于【对象/场景】。包含【范围】，不包含【范围】。同义词或缩写为【内容】。
规则模板：【规则名称】适用于【对象/场景】。当【条件】时，按【计算或判断方式】处理。统计时间以【时间字段】为准。以下情况除外：【例外】。
SOP 模板：【SOP 名称】适用于【场景】。由【角色】处理。前置条件为【条件】。步骤为【步骤】。出现【异常】时按【处理方式】执行。完成标准为【标准】。
5.3 流程内容重点维护什么
无论是审批、业务流、工作流、阶段流程还是 AI FLOW，用户只需确保以下内容清晰：
- 流程服务哪个业务对象和场景。
- 什么情况下开始。
- 正常情况下经过哪些关键步骤。
- 不同条件下走哪个分支。
- 谁负责处理，最终完成什么动作。
- 驳回、缺失信息或其他异常如何处理。
流程名称、节点名称和说明应使用稳定的业务语言，避免“节点 1”“处理一下”“其他”等无法表达用途的名称。
5.4 避免知识互相打架
- 当前只保留一个有效口径；旧版本应停用或明确标注适用时期。
- 同名但含义不同的内容，应在名称中增加场景，例如“GMV（零售）”和“GMV（渠道）”。
- 一条内容只表达一个主题。长 SOP 应按适用条件、关键步骤、异常处理或完成标准拆分。
- 规则发生变化时，同时检查相关术语、流程和 SOP 是否需要更新。
- 数字、公式、比例、日期和审批角色必须由业务负责人确认。
判断标准：用户读完一条知识后，应该能回答“适用于谁、什么时候用、怎么算或怎么做、有哪些例外”。不能回答，就还不够清楚。
6 语义建模
客户购买【ShareAgent】产品后，系统会自动提供语义层通用版，无需任何配置即可使用基础语义检索能力。
如需获得更贴合企业自身业务特征的完整语义能力，则需手动开启语义初始化，系统将基于租户的实际配置生成个性化语义数据，此过程会消耗租户算粒。
6.1 算粒消耗说明
算粒是在ShareAgent中使用不同LLM的换算单位。在语义管理中，以下两类操作会消耗算粒：
| 消耗类型 | 说明 | 费用参考 |
| 语义初始化建模 | 首次生成租户级语义，AI算粒消耗量与对象、字段、指标、图表、流程、配置、规则/术语的数量正相关 | 约 150–5000算粒 |
| 语义增量建模 | 系统配置变更后自动更新语义，消耗量与变更频率正相关 | 按实际变更量计算 |
6.2 开启企业专属版语义
路径：语义管理 →语义建模管理→ 开启【企业专属建模】
开启后，系统将使用基于当前租户的完整配置（对象、字段、流程、规则术语等）生成全量的个性化语义数据，AI 回答将更贴合企业实际业务。
开启【企业专属建模开关】后，系统将实时监听配置变更，定期自动更新语义数据，确保 AI 始终基于最新配置进行回答。
6.3 实施期间建议临时关闭动态更新
如果系统配置尚未稳定（如对象、字段仍在频繁调整），建议暂时关闭【企业专属建模】。
原因：配置来回修改会触发重复的语义生成动作，造成算粒的无效消耗。
待配置稳定后再重新开启，系统将仅针对最终的变化内容重新生成语义，不会重复计算。
6.4 算粒不足时的处理
当AI算粒余量不足时，系统将自动暂停语义初始化建模/增量建模，并呈现“异常”状态，提示算粒不足。待补足算粒后，系统将从中断处继续生成，不会从0开始生成。
图 3 企业专属语义建模界面示意，界面以实际版本为准
7 沙盒更改集
支持创建沙盒时，同步拷贝租户语义库的数据到沙盒企业，以减少对沙盒企业的首次建模token消耗，但后续增量建模仍需要消耗沙盒企业的AI算粒资源。
因语义数据强依赖租户级配置，而沙盒环境各类临时性配置居多，会影响语义数据的准度，因此不支持从沙盒出站语义数据入站到主企业。
8 建立可持续的日常运营
租户语义不是一次性配置。对象、字段、业务口径和流程变化后，都要同步检查语义内容。
首次建设建议顺序见下，后续增量更新系统将自行更新语义。
- 关闭测试、临时、备份、停用和废弃对象。
- 校准核心对象字段的高、中、低相关度和 AI 可见性。
- 补充容易混淆的对象描述。
- 补充关键金额、日期、状态和引用字段备注。
- 整理核心术语、指标规则、流程和 SOP。
- 更新租户语义。
- 用真实问题集验收并记录结果。
9 常见问题
1、关闭“对 AI 可见”后，数据是否更安全？
不一定。该开关用于管理 AI 的主动理解范围，不是权限控制。敏感数据仍应依赖原有权限设置。
2、高相关字段是不是越多越好？
不是。高相关字段过多会让对象失去重点。只把真正决定对象身份、状态、金额、日期、分类或核心关系的字段设为高。
3、对象数据很少，是否应该关闭可见？
不要只看数据量。低频主数据、合规对象或关键关系对象即使记录少，也可能十分重要。应结合真实问题和业务价值判断。
4、为什么字段已经调高，AI 仍然理解不准确？
相关度只能表示“重要”，不能补充“含义”。请继续检查字段备注、单位、枚举、相似字段区别，并确认租户语义更新已完成。
5、一个很长的 SOP 应该录成一条吗？
通常不建议。应按适用条件、关键步骤、分支、完成标准和异常处理拆分，同时使用统一主题名称保持关联。
6、修改后多久生效？
以控制台任务状态和实际测试为准。修改内容、租户规模和当前任务状态不同，完成时间也会不同。