实时语义字典系统、结构智能系统、知识系统协同开发规划
一、项目目标
建立三个相互独立、通过 API 进行数据共享与协作的系统:
- 实时语义字典系统
- 结构智能系统
- 知识系统
三个系统分别开发、分别运行、分别管理自身数据,不合并为一个整体程序。
实时语义字典系统为结构智能系统提供必需的语义基础。结构智能系统利用语义依据进行识别、匹配和关系处理,通过运算方法形成相应能力。知识系统独立运行,通过 API 与其他系统共享知识数据。
二、系统总体架构
1. 实时语义字典系统
系统定位:动态语义结构构建与管理系统。
主要职责:
- 接收用户提交的文本。
- 对包含多个句子的输入进行分句和语义单元拆分。
- 提供拆分结果供用户检查、修改、增加或删除。
- 用户确认拆分结果后,自动开展需求识别与搜索查询构建。
- 根据识别出的需求和已有语义数据,动态生成搜索查询。
- 自动搜索外部资源并获取相关信息。
- 根据实际需求和获取的资源,动态构建语义结构。
- 保存语义结构、信息来源、验证状态及相关关系。
- 支持已有语义结构的匹配、复用、补充和扩展。
- 通过 API 向结构智能系统等授权调用方提供语义数据。
核心约束:
- 用户只在语义单元拆分阶段确认一次,确认后自动进入后续处理。
- 不预先固定所有概念的属性字段。
- 根据具体需求动态确定概念、元素、属性、属性值及其关系。
- 外部搜索结果不能直接视为正确事实。
- 对未验证、存在冲突或缺乏依据的信息保留相应状态。
- 语义依据不足时,不得伪造语义关系或事实。
2. 结构智能系统
系统定位:基于语义结构开展识别、匹配、关系处理和运算的独立系统。
主要职责:
- 独立管理自身程序、数据和运行过程。
- 通过 API 获取实时语义字典提供的语义依据。
- 根据语义结构识别输入内容中的概念、元素、属性及其关系。
- 将输入信息与已有语义知识进行匹配。
- 根据匹配结果处理相关关系。
- 在具备必要语义依据的基础上,运用相应计算方法形成能力。
- 对语义缺失、无法匹配或关系不明确的情况进行明确处理。
- 根据需要通过 API 与独立知识系统共享和获取数据。
核心约束:
- 不将实时语义字典内部功能直接合并进结构智能系统。
- 不以固定字段映射代替动态语义识别。
- 不在缺乏语义依据时凭空构造结论。
- 语义基础缺失时,可以请求实时语义字典构建或补充语义;无法获得有效依据时,返回未识别或无法确定的状态。
- 结构智能系统的具体运算能力应依据已经明确的业务逻辑逐项开发,不擅自增加未经确认的能力。
3. 知识系统
系统定位:独立的知识管理与数据共享系统。
主要职责:
- 独立管理知识系统自身的数据和运行过程。
- 按照已确定的知识数据结构保存和管理知识。
- 通过 API 提供授权的数据查询、读取及必要的更新能力。
- 与实时语义字典系统、结构智能系统进行数据共享。
- 根据实际接口约定处理数据标识、来源及相关状态。
核心约束:
- 不将知识系统与实时语义字典系统合并。
- 不将知识系统与结构智能系统合并。
- 不预设尚未确定的知识字段、数据映射或业务规则。
- 知识数据的具体结构、管理方式和接口内容,依据现有项目代码及后续确认的需求确定。
三、三个系统之间的关系
三个系统之间不是简单的单向流水线,而是独立系统之间的 API 协作关系。
实时语义字典系统与结构智能系统
实时语义字典系统提供语义基础,结构智能系统调用这些语义依据开展识别、匹配、关系处理和运算。
结构智能系统依赖实时语义字典提供必要的语义支持,但不因此失去独立性。
当必要语义不存在时,结构智能系统应请求语义构建或补充;无法取得有效语义依据时,应明确返回未识别状态。
知识系统与其他系统
知识系统独立管理知识数据,通过 API 与实时语义字典系统、结构智能系统进行数据共享。
具体调用方向、接口字段、数据更新规则和异常处理方式,以实际业务需求及已经确定的接口协议为准。
系统独立性要求
| 项目 | 实时语义字典系统 | 结构智能系统 | 知识系统 |
|---|---|---|---|
| 独立程序 | 是 | 是 | 是 |
| 独立运行 | 是 | 是 | 是 |
| 独立数据管理 | 是 | 是 | 是 |
| 通过 API 协作 | 是 | 是 | 是 |
| 动态语义结构构建 | 核心职责 | 按需调用 | 不预设 |
| 语义识别与匹配 | 提供语义基础 | 核心职责 | 按接口提供相关知识数据 |
| 运算形成能力 | 不预设为核心职责 | 核心职责 | 不预设为核心职责 |
四、开发实施规划
第一阶段:实时语义字典系统
以实时语义字典系统为优先开发对象。
第一阶段的实施顺序:
- 检查现有项目代码、目录、数据结构及运行环境。
- 明确现有项目与实时语义字典系统的对应关系。
- 建立文本输入和语义单元拆分功能。
- 建立拆分结果的人工检查、修改、增加、删除及确认功能。
- 建立需求识别与搜索查询动态构建功能。
- 建立外部资源搜索与信息获取功能。
- 建立动态语义结构构建功能。
- 建立语义结构、来源及验证状态的保存和管理功能。
- 建立供其他系统调用的 API。
- 根据实际代码和明确需求逐项测试。
本阶段重点是形成可实际运行的动态语义构建能力,为结构智能系统提供可靠的语义基础。
第二阶段:结构智能系统
在实时语义字典系统具备可调用的语义数据接口后,开发结构智能系统。
实施顺序:
- 检查现有结构智能系统代码及其数据结构。
- 确定与实时语义字典系统的 API 对接方式。
- 实现语义数据获取与必要性检查。
- 实现概念、元素、属性及关系的识别与匹配。
- 实现已有语义关系的处理。
- 实现基于有效语义依据的运算功能。
- 实现语义缺失、匹配失败及结果无法确定时的处理。
- 根据已经确定的具体能力要求逐项测试。
本阶段不得以重新建设一套语义字典替代第一阶段成果。
第三阶段:知识系统
独立开发或完善知识系统,并根据实际需求建立与其他系统的 API 协作关系。
实施顺序:
- 检查现有知识系统及其数据结构。
- 明确知识数据的保存、查询和管理要求。
- 确定系统间的数据共享范围。
- 确定必要的 API 接口及数据交换规则。
- 实现约定范围内的数据查询和共享功能。
- 验证知识数据与语义结构、结构智能处理结果之间的对应关系。
本阶段不得擅自改变已有知识系统的数据模型。
第四阶段:系统间协同验证
分别验证三个系统的独立运行能力和 API 协作能力。
验证范围:
- 实时语义字典系统能够独立构建、保存和管理语义结构。
- 结构智能系统能够独立运行,并通过 API 获取语义依据。
- 知识系统能够独立运行,并通过 API 提供约定的知识数据。
- 各系统能够正确处理接口调用失败、数据缺失和结果无法确定等情况。
- 各系统的程序、数据和内部职责保持独立。
- 任一系统的功能变更不会未经确认就导致其他系统的内部架构被改写。
五、开发约束
整个项目开发必须遵守以下约束:
- 不合并三个独立系统。
- 不改变已经确认的系统依赖关系。
- 不擅自重构现有项目。
- 不擅自增加未经确认的模块、字段、算法或业务流程。
- 不预先固定动态语义结构中的所有概念属性。
- 不把外部搜索结果直接当作已验证知识。
- 不在语义依据不足时伪造识别结果。
- 不以接口调用代替各系统自身应承担的核心职责。
- 开发必须以实际项目代码、已确认需求及真实运行结果为依据。
- 每次实施前核对现有代码,每次实施后验证实际功能;不得只建立空目录或测试框架就认定功能完成。
六、阶段成果与验收标准
| 阶段 | 必须交付的成果 | 验收依据 |
|---|---|---|
| 第一阶段 | 可运行的实时语义字典系统 | 能完成语义单元确认、自动搜索、动态语义构建、保存及 API 提供 |
| 第二阶段 | 可运行的结构智能系统 | 能获取语义依据、完成识别匹配和约定的运算处理 |
| 第三阶段 | 可运行的知识系统及约定接口 | 能独立管理知识并通过 API 完成约定的数据共享 |
| 第四阶段 | 系统协同验证结果 | 三个系统保持独立,并能按约定完成跨系统调用与异常处理 |
具体接口地址、请求参数、数据字段、数据库设计和代码文件,必须在检查现有项目后,依据明确需求逐项确定,不在规划阶段凭空指定。
七、最终目标
形成三个独立运行、职责清晰、通过 API 协作的系统:
- 实时语义字典系统负责动态构建和管理语义结构。
- 结构智能系统基于语义依据开展识别、匹配、关系处理和运算,形成相应能力。
- 知识系统独立管理知识,并参与跨系统数据共享。
总体原则:系统独立、接口协作、语义先有依据、结构智能据此处理、知识独立管理、能力通过实际运算形成。
本规划作为后续开发的架构依据。具体实现以现有代码和已经确认的需求为准,不因开发便利而改变系统之间的关系。
八、三个系统的接口边界与协作规则
8.1 接口设计总原则
三个系统分别独立开发、独立运行、独立管理自身数据,通过 API 交换完成协作所需的数据。
接口用于传递数据、提交请求和返回处理结果,不用于将三个系统合并为一个系统。
必须遵守以下原则:
- 职责不越界:每个系统只能直接执行自身职责范围内的业务处理。
- 数据所有权独立:各系统负责维护自身拥有的数据,不直接修改其他系统的内部数据。
- 通过接口协作:跨系统请求必须经过对方公开的 API。
- 内部实现隔离:一个系统不得依赖另一个系统的内部类、私有方法、内部目录或数据库表结构。
- 接口契约明确:接口的请求内容、返回内容、错误状态及调用权限必须有明确约定。
- 动态结构兼容:语义结构中的概念、属性和关系不得被接口设计强制限制为固定业务字段。
- 依据不足时明确返回状态:不得用虚构数据填充缺失的语义、知识或计算结果。
- 独立运行不等于完全无依赖:系统可以存在明确的业务依赖,但不得因此丧失程序、数据和内部职责的独立性。
8.2 实时语义字典系统接口边界
A. 本系统拥有的职责
实时语义字典系统负责:
- 文本分句和语义单元拆分。
- 提供语义单元的人工检查、修改和确认能力。
- 根据确认后的语义单元识别需求。
- 动态构建搜索查询。
- 获取外部资源及其来源信息。
- 根据实际需求与资源构建动态语义结构。
- 管理语义结构、概念、元素、属性、属性值及关系。
- 管理来源、验证状态、冲突信息和结构版本。
- 对外提供语义查询、匹配、读取及约定范围内的语义构建请求接口。
B. 本系统不负责的职责
实时语义字典系统不得直接代替结构智能系统完成其专属的复杂识别运算及能力形成,也不得代替知识系统管理其独立拥有的知识数据。
语义字典可以根据自身职责识别、组织和匹配语义信息,但不得把结构智能系统的全部业务逻辑纳入自身内部。
C. 对外提供的接口类别
- 语义结构查询接口。
- 语义结构读取接口。
- 语义匹配接口。
- 语义构建或补充请求接口。
- 语义结构状态及来源查询接口。
- 语义数据变更通知接口(确有需要时)。
上述为接口职责分类,不代表已经确定具体 URL、请求参数或代码文件。
D. 对外返回的数据边界
仅返回调用方完成约定业务所需的语义数据,例如:
- 语义对象标识。
- 动态语义结构。
- 概念、元素、属性、属性值及关系。
- 信息来源及其关联关系。
- 验证状态和冲突状态。
- 结构版本或更新时间。
- 查询结果状态及必要的错误信息。
具体数据字段应根据现有数据模型和实际需求确定,不得把示例字段直接固化为全部概念的统一属性。
8.3 结构智能系统接口边界
A. 本系统拥有的职责
结构智能系统负责:
- 获取和使用实时语义字典提供的语义依据。
- 对输入内容进行基于语义结构的识别和匹配。
- 处理已识别概念之间的关系。
- 根据有效语义依据开展计算、推理及决策处理。
- 形成已经明确要求的结构智能能力。
- 管理自身的计算过程、运算规则、结果和运行状态。
- 根据业务需要调用知识系统提供的知识数据。
B. 本系统不负责的职责
结构智能系统不得:
- 直接管理或修改实时语义字典的内部数据库。
- 绕过语义字典,擅自将未经确认的内容当作有效语义依据。
- 将实时语义字典内部的结构构建程序复制为自己的内部实现。
- 直接管理知识系统的内部数据存储。
- 将未识别内容自动转化为确定事实。
- 将尚未定义的计算能力视为已经实现。
结构智能系统可以保存自身的运算结果、处理记录和必要的引用标识,但不能因此取得其他系统数据的所有权。
C. 对外提供的接口类别
在具体能力明确后,可以提供:
- 结构智能处理请求接口。
- 识别与匹配结果查询接口。
- 关系处理结果接口。
- 运算结果查询接口。
- 处理状态和错误状态查询接口。
具体接口范围应根据已确认的结构智能业务逐项确定,不预先增加未经要求的功能。
D. 对外返回的结果边界
结构智能系统返回自身处理产生的结果,包括必要的:
- 处理结果。
- 语义依据引用。
- 匹配状态。
- 运算或推理结果。
- 结果可信状态或依据充分性状态。
- 无法处理、语义缺失及计算失败等状态。
结构智能系统应能够区分“没有匹配到语义”“存在语义但依据不足”“运算失败”和“已得到有效结果”,不得将这些状态混为一谈。
8.4 知识系统接口边界
A. 本系统拥有的职责
知识系统负责:
- 独立管理知识数据。
- 按自身的数据模型进行知识保存、读取、查询和更新。
- 管理知识来源、版本及必要的状态信息。
- 根据授权向其他系统提供知识查询和数据读取服务。
- 对自身知识数据的修改权限和有效性负责。
B. 本系统不负责的职责
知识系统不得代替实时语义字典完成动态语义结构构建,也不得代替结构智能系统执行其专属的语义关系运算和能力形成过程。
知识系统可以保存具有语义关联的知识,但不因此拥有实时语义字典系统的全部职责。
C. 对外提供的接口类别
- 知识查询接口。
- 知识读取接口。
- 知识详情及来源查询接口。
- 知识更新或写入接口(仅限授权调用方和约定范围)。
- 知识状态及版本查询接口。
是否需要新增、删除、批量导入或其他接口,必须根据知识系统的实际需求确定。
D. 对外返回的数据边界
知识系统只返回自身拥有且允许共享的知识数据及必要的来源、版本和状态信息。
知识系统不应擅自将未经验证的知识标记为确定事实,也不得以自身数据结构限制实时语义字典的动态属性设计。
8.5 三个系统之间的调用边界
实时语义字典系统 → 结构智能系统
实时语义字典系统可以向结构智能系统提供语义数据和语义结构变更通知。
它不直接替结构智能系统执行专属运算,也不直接修改结构智能系统的内部状态。
结构智能系统 → 实时语义字典系统
结构智能系统可以请求语义查询、语义匹配、语义结构读取,以及必要的语义构建或补充。
如果请求涉及新的语义构建,实际构建由实时语义字典系统负责。结构智能系统只接收处理结果,不直接操作语义字典内部存储。
结构智能系统 ↔ 知识系统
结构智能系统可以根据具体处理需求,通过知识系统的 API 查询或读取知识。
是否允许写入知识、提交知识更新或回传运算结果,必须另行明确权限和业务规则,不能默认开放。
实时语义字典系统 ↔ 知识系统
两个系统可以根据明确的数据共享需求交换相关数据。
语义字典可以引用知识来源或利用授权知识辅助语义构建;知识系统可以保存与语义对象相关的引用信息。
但双方不得因为数据关联而直接操作对方的内部数据库。具体调用方向和数据更新责任以正式接口约定为准。
8.6 数据所有权与修改权限
每个系统对自己拥有的数据负责。
| 数据类型 | 负责系统 | 其他系统的访问方式 |
|---|---|---|
| 动态语义结构及其关系 | 实时语义字典系统 | 通过 API 查询、读取或提交约定的构建请求 |
| 语义来源及验证状态 | 实时语义字典系统 | 通过 API 读取相关信息 |
| 结构智能运算规则及处理记录 | 结构智能系统 | 通过其公开接口访问允许共享的结果 |
| 结构智能处理结果 | 结构智能系统 | 通过 API 查询或按约定回传 |
| 独立知识数据 | 知识系统 | 通过知识系统 API 查询、读取或授权更新 |
| 跨系统引用标识 | 由实际创建该数据的系统负责维护 | 其他系统保存引用,不擅自改写标识 |
如果某类数据的所有权尚未明确,不得在开发中自行决定由哪个系统管理。
8.7 API 通用契约
三个系统的 API 应统一约定必要的通信规则,但不要求统一内部实现。
每个正式接口至少需要明确:
- 接口所属系统及业务职责。
- 调用方和被调用方。
- 请求方式及数据格式。
- 必需参数与可选参数。
- 返回数据结构。
- 成功、失败、未识别、数据缺失及权限不足等状态。
- 身份验证和调用权限。
- 超时、重试及重复请求的处理规则。
- 数据版本或兼容性规则。
- 日志、错误追踪及必要的审计要求。
具体协议、接口地址、参数名称、状态码和认证方式必须在检查现有项目后确定,不在本规划中凭空指定。
8.8 异常与依赖处理
实时语义字典不可用
结构智能系统应明确返回语义服务不可用或当前无法取得语义依据的状态。除非已有有效且允许使用的语义数据缓存,否则不得假定已经获得最新语义结果。
语义数据不存在
结构智能系统可以向实时语义字典提交构建或补充请求。语义构建完成之前,不得将缺失语义当作已识别语义。
知识系统不可用
调用知识系统的业务应明确返回知识服务不可用状态。是否可以继续处理,取决于该项业务是否必须依赖相应知识,不能统一假定所有处理均可继续。
数据冲突或版本不一致
各系统应保留可追踪的来源及版本信息。对于冲突数据,不得未经约定就覆盖原有数据或自动选择某一结果作为最终事实。
接口失败
接口调用失败不得直接被解释为业务处理成功。调用方应能够区分通信失败、权限失败、数据不存在和业务处理失败。
8.9 接口实施与验收
接口开发必须按照以下顺序实施:
- 检查三个系统现有代码及实际数据模型。
- 确认每个接口的所属系统、调用方和业务责任。
- 确认请求、返回、权限及错误处理约定。
- 分别实现各系统自己的接口。
- 分别验证接口提供方和调用方。
- 验证正常请求、数据缺失、权限不足、服务不可用和数据冲突等情况。
- 验证修改一个系统的内部实现时,不需要未经授权地修改其他系统的内部程序。
- 将已经实现并验证的接口契约记录为正式版本。
接口只有在真实调用、返回数据正确且异常状态处理符合约定后,才能视为完成。
8.10 最终边界原则
实时语义字典系统负责构建和管理语义依据;结构智能系统负责基于语义依据进行识别、匹配、关系处理和运算;知识系统负责独立管理知识。
三个系统可以相互请求服务、共享数据和传递引用,但不能越过 API 直接控制对方的内部实现或数据存储。
接口边界明确后,各系统可以独立开发和升级,同时维持必要的业务依赖与数据协作,不改变既定的总体架构。