Skip to main content
本体空间是检查已发布语义的运行时界面。它会归组展示本体定义、本体自有数据、关联业务对象和按项目分区的图谱，帮助用户确认哪些内容已经可以用于搜索、助手推理和插件消费。
**适用角色：**本体建模人员、分析人员和 Agent 构建者。**最小权限：**已发布本体和资源的读取权限。**完成后得到：**可搜索的实体、邻域图谱以及可传给助手的 Snapshot / graph version 上下文。
修改定义应使用本体工作室；本体空间用于回答：当前激活的是哪个语义版本、有哪些对象、对象如何连接、这次结果由哪个准确快照支撑？

​
界面布局

页面包含三个工作区域： 资源面板和助手面板都可以收起。助手面板支持调整宽度，并在浏览器中记住设置。

​
汇总与健康状态

顶部汇总当前组织的数据：
  • 本体定义数；
  • 本体自有数据数；
  • 业务对象数；
  • 缺失快照的资源数；
  • 快照失败的资源数；
  • 总节点数与 RDF 三元组数。
每个资源或分区会显示以下健康状态：
资源可见不等于已经可以被 Agent 或插件使用。排查搜索或 Action 发现前，先确认健康徽标和当前快照。

​
资源归组

当资源带有本体定义引用时，导航会按本体定义归组。一个分组可以包含：
  • 本体定义资源本身；
  • 随定义发布的本体自有数据；
  • 引用该定义的业务对象或资源；
  • 按分区发布的图谱，例如特定项目的业务对象子图。
没有定义引用的资源会显示在未关联本体定义下。通过这个区分，可以把人工设计的领域本体与适配器生成或遗留资源图谱分开检查。 资源搜索可以匹配定义名称、业务对象类型与业务键、描述、资源 ID、所有者、版本、资源类型或标签，也可以按资源类型和健康状态筛选。

​
全局实体搜索

可以按以下字段跨资源搜索有效实体：
  • 显示名称；
  • 外部键；
  • 别名；
  • 实体类型。
还可以使用实体类型或资源类型缩小范围。结果包含匹配字段、资源与分区、实体类型编码、外部键和图谱引用。选择结果后，页面会切换到对应资源图谱，并把该实体加入助手上下文。 搜索结果有数量上限。如果宽泛查询达到上限，应缩小关键词或增加实体类型筛选，而不是把结果当作完整导出。

​
实例图谱

选择一个 ready 资源或分区，打开实例图谱。图谱会展示：
  • 作为节点的实体实例；
  • 作为边的关系实例；
  • 类型化属性和身份字段；
  • 源端点、目标端点和方向；
  • resource、snapshot、graph version、ontology 与 partition 引用；
  • 已注册时使用资源专属可视化。
选择实体后可以查看详情，并把它交给本体助手。图谱是快照视图：它描述已发布语义状态，不会修改工作室草稿或源系统。 底层图模型详见实体、关系、属性图谱。

​
快照历史

为所选资源或分区打开快照历史。最近 30 条记录会展示：
  • 源数据版本；
  • 是否为当前快照；
  • 发布和投影健康状态；
  • 创建时间；
  • graph version；
  • 实体数、关系数和三元组数。
快照历史可用于解释数量变化、复现 Agent 或插件判断，以及区分“消费者读取旧版本”和“当前发布失败”。当操作需要可复现时，下游应携带 snapshot ID 与 graph version。

​
本体助手

当前组织存在有效本体助手时，本体空间会把助手挂载在图谱旁。每次请求可以携带：
  • definition ID、定义资源 ID 和语义版本；
  • 所选资源和可选分区；
  • snapshot ID 与 graph version；
  • 业务对象类型和业务键；
  • 所选实体的 ID、类型编码、外部键、名称和图谱引用；
  • 当前搜索词。
因此可以直接询问：
  • 哪些对象和关系解释了当前业务对象？
  • 选中实体适用哪些约束或 Action？
  • 当前对象与早期快照相比发生了什么变化？
  • 哪个来源或证据支撑这个属性？
助手严格使用当前组织范围，并依赖管理员初始化。如果没有有效助手或 ChatKit frame，页面会显示配置提示，不会静默回退到其他组织或 tenant 的助手。

​
删除本体实例或分区

本体空间支持显式删除运行时实例：
  • 删除分区会清理该项目子图的快照历史、实体、关系、查询缓存和 RDF 图；
  • 删除资源实例会归档资源，并清理其运行时快照、实例投影、查询缓存和 RDF 图。
统一本体定义和其他项目分区不会被删除。操作前的确认窗口会说明准确目标与影响。
删除运行时实例不同于在本体工作室删除或归档本体定义。继续前请确认所选 resource ID 和 partition key。

​
Web 验收路径

进入数据与本体 → 本体空间，先在资源导航中选择目标本体定义或资源，再查看健康状态和当前快照。选择 ready 资源后使用实体搜索，点击结果进入实例图谱；需要助手解释时再打开本体助手，确保上下文中的 resource、snapshot 和 graph version 与当前选择一致。 **成功信号：**顶部汇总和资源卡片都有实体/关系数量，搜索结果显示实体类型与外部键，图谱详情包含 Snapshot 和 graph version。missing_snapshot、publish_failed 和 projection_failed 都必须先排障。

​
验收清单

  • 资源出现在正确的本体定义分组。
  • 健康状态为 ready，存在当前 Snapshot。
  • 至少搜索到一条实体并打开邻域图谱。
  • 助手上下文包含当前资源和版本标识。
  • 删除或归档操作前已核对 resource ID 与 partition key。
发布或同步资源后，建议确认：
  1. 资源出现在预期的本体定义分组中；
  2. 健康状态为 ready，并存在当前快照；
  3. 节点数、关系数和三元组数符合预期；
  4. 可以按名称或外部键找到一个已知对象；
  5. 对象图谱包含预期类型关系和属性；
  6. 快照历史显示正确源版本与 graph version；
  7. 助手可以获得所选对象，无需用户再次描述对象身份；
  8. 下游插件会固定并重新校验资源、实体类型、快照和图版本上下文。
接下来阅读阀门业务工作台如何使用已发布本体上下文。