> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 本体论理论

> 从实体、关系、属性、约束与推理解释 UOSE系统的理论基础。

本体论在 UOSE系统中的价值，不是把业务概念写成一份静态词表，而是把企业系统里的对象、关系、属性、约束和动作表达成可计算、可校验、可治理的语义契约。它让智能体的推理对象从自然语言片段变成稳定的业务对象。

## 实体

实体是业务世界中可以被识别、引用和操作的对象。它可以是一个客户、一张订单、一项指标、一个语义模型、一张数据库表，也可以是一个知识图谱中的概念节点。

实体在 UOSE 中必须具备：

* 稳定标识：例如外部键、内部实体 ID、ontology ID。
* 类型归属：例如 `semantic_indicator`、`database_table`。
* 可读名称：用于搜索、展示和 Agent 解释。
* 属性集合：用于描述对象状态、字段、粒度、证据和运行上下文。

实体的意义在于让 Agent 不再只说“销售额指标”，而是能定位到具体资源中的具体指标对象，并携带其模型、Cube、时间维度、可过滤字段等上下文。

## 关系

关系表达实体之间的结构性联系。它可以是包含、引用、导航、依赖、派生或证据关联。

典型关系包括：

* 语义模型包含 Cube：`semantic_model_has_cube`。
* Cube 包含指标、度量和维度。
* SAP OData Entity Set 指向 Entity Type。
* 数据库表包含列、约束和索引。
* 知识库包含知识实体，知识实体之间存在 GraphRAG 关系。

关系让 Agent 能够沿图谱读取上下文。例如，从一个指标出发，可以找到所属 Cube、可用维度和事实查询契约；从一个 OData Entity Set 出发，可以找到字段定义和可导航对象。

## 属性

属性是实体和关系上的结构化描述。它既可以承载业务信息，也可以承载运行信息。

在 UOSE 中，属性常见用途包括：

* 描述资源对象：名称、状态、版本、更新时间。
* 描述执行上下文：`analysis_contract`、`query_capabilities`、`key_schema`。
* 描述图谱证据：别名、来源、置信度、mention 样本。
* 描述安全边界：是否可写、是否支持 CSRF、是否截断同步。

属性必须尽量结构化。只有结构化属性才能被 Agent 稳定读取，被策略稳定匹配，被审计稳定回放。

## 约束

约束定义对象如何被合法使用。它回答“能不能做”“需要什么条件”“哪些输入是不合法的”。

约束包括：

* 类型约束：动作只能作用在指定实体类型上。
* 参数约束：动作输入必须满足 schema。
* 业务约束：写动作是否需要审批、是否需要幂等键。
* 运行约束：最大查询行数、最大同步对象数、源系统 metadata restriction 和同步级选择。
* 权限约束：策略绑定决定 allow、deny 或 require\_approval。

约束让 UOSE 的执行链路保持可控：Agent 可以生成计划，但计划必须被系统校验。

## 推理与校验

UOSE 使用本体图谱帮助 Agent 做可解释推理，但最终执行不依赖 Agent 自证正确。系统通过以下机制形成第二道门：

* ontology snapshot 保存资源语义事实。
* RDF 或本地投影支持实体检索、邻域查询和 schema 查询。
* action manifest 定义动作契约和风险等级。
* `simulateAction` 在执行前校验目标、参数、策略和运行 readiness。
* 审计记录保存输入、输出、策略判定和证据引用。

因此，本体论在产品中的角色是：把企业知识变成 Agent 可读、系统可控、用户可追溯的操作空间。