Cube 企业应用与 AI 平台技术白皮书
版本 2.0(详细图解版) · 2026 年 11 月 22 日 · 面向架构师、技术负责人、业务负责人及实施团队
Cube 将企业门户、组织身份、应用构建、业务流程、知识、业务语义和智能体放在同一套平台能力体系中。企业既可以建设新的业务应用,也可以接入现有系统,让员工通过统一入口办理业务,让 AI 在明确的业务口径与授权范围内参与工作。
本文依据本次核对的 Cube 开发包代码、平台说明和门户界面编写。代码中存在的能力、现场可见的入口与客户环境的集成验收是三个不同层次。 文中应用案例是实施示例,正式交付应以部署版本、License、资源授权和目标环境验收为准。
阅读导航与图解课程
本文按“平台与架构 → 17 项模块 → 业务贯穿场景 → 部署与验收 → 治理与选型”组织。每个模块配有真实产品截图、可展开播放的中文操作课程及开发手册入口。截图呈现演示环境中的实际 UI,不把演示数据视为经营实绩;课程采用真实操作关键帧与动态标注,非连续录屏。
| 阅读目的 | 建议路径 |
|---|---|
| 判断是否适合企业建设 | 平台定位、能力全景、贯穿场景、选型与实施路线 |
| 理解技术责任边界 | 总体架构、身份与数据、执行分工、事务与运行治理 |
| 查看真实产品操作 | 各模块“真实界面与操作视频”,或进入学习中心 |
| 进行开发与配置 | 开发手册,先完成开发环境与场景基线 |
01 平台定位与设计原则
企业建设 AI 应用时,难点往往集中在模型之外:业务口径分散、数据访问权限不一致、工具和流程各自运行、操作结果难以核验。Cube 通过共享平台能力,把“员工入口—业务应用—知识与数据—智能执行—运行治理”连接起来。
- 统一入口:门户展示员工可访问的应用、待办、消息、知识与智能体,保持原系统的业务归属。
- 能力复用:应用、流程、提示词、技能、工具和语义模型可按权限组合,减少重复配置。
- 语义先行:在需要跨系统理解业务时,先定义对象、口径、规则与数据映射,再让智能体使用。
- 执行有据:区分分析建议、待审批计划、业务执行及真实回执,保留可追踪标识。
- 逐步建设:先跑通一个可验证的业务场景,再扩展应用和 AI 能力。
典型建设对象包括统一办公平台、CRM、采购与库存协同、设备维修、知识问答、经营分析与业务自动化。接入 SAP、ERP、MES 等外部系统需要对应接口、连接器及项目映射,并非录入系统名称即可完成集成。
02 总体架构与职责分层
图为架构职责示意;Portal、Design、Admin 分别面向使用、设计与治理,实际部署不要求每个逻辑模块独立进程。
员工与业务人员 实施与应用开发者 平台管理员
│ │ │
▼ ▼ ▼
Portal 门户 Design 设计端 Admin 管理端
应用 / 待办 / 消息 表单 / 流程 / 页面 身份 / 组织 / 模型 / 审计
知识 / 智能体 / 办公 报表 / 语义 / AI构建 集成配置与平台治理
└─────────────────────┬─────────────────────┘
▼
企业应用与公共能力:应用元数据、BPM、消息、知识、语义、资产目录
▼
执行体系:业务编排 / 智能体 / Harness 任务 / 模型网关
▼
业务数据与基础设施:平台数据库、缓存、文件、连接器、外部业务系统
代码组织包含 apps/portal、apps/admin、apps/design、apps/backend 和 apps/service。前端工作区区分员工使用、应用设计与平台治理;后端按门户、组织、认证、流程、知识、语义、大屏和 AI 等领域组织。模块划分不意味着每个模块在所有部署方式下都独立运行,实际进程与依赖应按交付架构核对。
模型网关负责模型接入与调用治理;业务编排负责可定义的业务步骤;BPM 负责审批责任与流程状态;Harness 负责目标、计划、任务与结果。几者通过接口和上下文协作,各自保留运行与权限检查。
03 统一能力全景
| 能力域 | 模块 | 主要产物 |
|---|---|---|
| 员工协同 | 门户、统一待办、统一消息、统一新闻公告 | 工作入口、任务列表、通知、企业内容 |
| 身份与组织 | 统一安全认证、统一组织 | 登录会话、组织与角色、资源授权 |
| 应用生产 | 统一应用构建、统一流程定义、统一大屏或报表、AI 应用构建 | 表单、列表、页面、流程、报表、应用版本 |
| 知识与智能 | 统一知识库、智能体及提示词/技能/工具/MCP、业务语义 | 可引用知识、可调用能力、业务上下文 |
| 执行与治理 | 统一 Harness 调度、统一安全审计、统一大模型网关、统一业务编排 | 任务、执行计划、日志、模型路由与回执 |
以下 17 个模块分别说明业务价值、技术组成与集成边界。开发步骤见开发手册。
04 门户
门户是员工进入平台的工作入口。工作台汇集待办、常用应用、快捷入口、知识与智能体,员工按当前身份访问资源。门户内容既包含平台数据,也可以包含经配置的业务页面或示例工作台。
技术组成:Portal 工作台路由、门户定义与用户配置、栏目组件、快捷入口和应用收藏。首页展示与业务数据通过相应服务接口连接,门户权限与应用内部权限需要分别生效。
应用示例:销售进入工作台查看待跟进事项、进入 CRM、查阅产品资料,再调用商机分析助手。
集成边界:演示卡片中的商机或回款数字不等于已接入的实时指标。新增外部卡片时,应明确数据源、刷新周期、空态和失败提示,并核验跳转后权限。
工作入口、业务归属与工作台组合
门户以当前身份为起点,组织工作台、应用中心、审批入口、消息、知识和智能体。工作台中的卡片是业务入口与数据摘要;完整单据、审批责任和数据写入规则仍由来源模块维护。比如“待办数为 8”只表示聚合查询结果,不代表 8 笔业务已进入可办理状态,进入详情时仍应重新检查任务有效性。
| 工作区 | 读者关心的信息 | 集成设计重点 |
|---|---|---|
| 我的工作 | 待办、申请、已办、待阅、协同 | 明确来源任务标识、分页、统计口径及跳转参数 |
| 常用应用 | 当前有权访问的应用与收藏 | 收藏只改变入口,不提升权限;应用下线后应有清晰提示 |
| 内容与知识 | 新闻、制度、文档和知识库 | 公告可见范围与知识共享范围分别维护 |
| 智能助手 | 可使用的智能体及业务能力 | 区分对话、分析与实际业务执行,保留原任务或运行标识 |
典型使用链为“识别今日工作 → 打开已授权应用 → 查询或办理 → 返回工作台核对状态”。门户聚合应考虑局部失败:某一业务服务超时,不应把整个门户变成空白页;区块应显示加载、无数据、无权限或失败状态,避免把失败显示为数量零。
跨系统接入时,需要梳理登录方式、应用编码、深链接、PC/移动地址和目标系统可用性。外部系统的按钮打开成功,只证明导航有效,还应核对目标用户映射和业务资源授权。
门户:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“进入常用应用”涉及的入口与资源;示例或空态以演示环境为准。
观看《门户》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
门户 · 动态操作讲解3:54 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
05 统一待办
统一待办集中呈现员工需要办理、已经办理、本人发起或抄送的事项。平台同时存在聚合任务接口与 BPM 任务接口,页面需按事项类型进入原业务办理链路。
技术组成:任务聚合查询、任务数量统计、BPM 待办与流程实例、办理详情和状态回读。建议用“来源系统 + 业务标识 + 任务标识”关联跨系统事项。
应用示例:报价审批在门户进入待办,审批人核对报价与附件后完成办理;原流程记录审批结果,门户刷新待办数量。
集成边界:展示待办不会自动接管外部系统的流程引擎。外部事项的同步、撤回、已办回写和重复任务处理需要独立适配,数量汇总也要说明统计口径。
任务身份、办理链路与状态一致性
统一待办围绕“谁需要处理哪一个业务事项”组织工作。流程定义标识一种审批规则,流程实例标识某一次业务流转,任务标识当前节点的具体办理责任。三者应分别记录,不能仅以单据标题作为任务唯一键。
| 对象 | 用途 | 容易混淆的边界 |
|---|---|---|
| 业务单据 | 保存采购、合同等业务事实 | 单据存在不表示审批已发起 |
| 流程实例 | 保存流转路径与实例状态 | 实例存在不表示当前用户可办理 |
| 当前任务 | 保存节点、参与人和办理动作 | 任务可能因撤回、转办或其他人办理而失效 |
| 已办与历史 | 追踪曾经办理的行为 | 已办记录不等于整个业务已完成 |
典型办理链为“查待办 → 查看来源单据与附件 → 确认当前节点 → 执行允许动作 → 核对接口回执 → 刷新任务与历史”。聚合端应保留来源类型、任务 ID、实例 ID、单据 ID 与更新时间。跨系统任务接入还需制定防重键、回调认证和状态对账机制。
并发情况下,两个窗口可能看到同一任务,办理端必须检查任务当时是否仍有效。统一待办不能通过前端删除列表项来模拟完成;失败或结果未知时,先查询原流程与单据,再判断是否允许重试。
统一待办:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“核对我的待办”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一待办》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一待办 · 动态操作讲解3:04 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
06 统一消息
消息中心按业务场景组织消息模板、接收人规则、通道配置和投递任务,并提供投递记录、站内收件箱、回调与重试接口。原有门户站内信接口仍然存在,接入时应选定主链路,避免重复通知。
技术组成:消息场景绑定、模板变量、通道策略、任务与分发记录、已读状态、失败补偿。短信、邮件或企业通信通道能否使用,取决于供应商、凭据和回调配置。
应用示例:采购申请到达审批节点后生成站内通知;根据接收人和通道策略发送通知,并保留投递结果。
集成边界:业务成功、消息提交成功、通道送达、员工已读是不同状态。重试必须沿用幂等关联,回调需验证来源;不能用已读回执替代审批结果。
从业务事件到员工收件箱
统一消息将业务事件、内容模板、接收人、通道、投递记录分开管理。采购审批到达某个节点,是消息触发事件;给哪一组人员发什么内容,是消息场景配置;站内、邮件或其他供应商通道是投递方式。这样可以在保持业务含义稳定的同时调整通知渠道。
业务事件 → 场景与模板 → 接收人解析 → 消息任务 → 通道分发
↓
业务办理状态 ← 业务系统 投递回执 / 员工阅读
投递提交、供应商接受、最终送达与员工已读应分别展示。消息中心不能用“任务创建成功”代替“员工已收到”。对于需要重试的通道,实施方案应明确幂等键、最大次数、退避间隔、超时结果与人工补偿入口。
模板变量应有定义、样例和缺失处理,链接应指向当前用户有权访问的单据。通知正文只携带办理所需信息,敏感详情通过登录后的业务页面查看。发送规则、通道凭据和回调验签属于服务端配置,不能放到门户脚本里。
统一消息:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“编写并预览模板”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一消息》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一消息 · 动态操作讲解3:02 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
07 统一新闻公告
新闻公告为企业制度、业务动态与通知提供集中发布入口。栏目、内容和门户展示解耦,支持按栏目查询、阅读及发布状态管理。
技术组成:新闻内容、栏目分类、发布与下架、阅读入口和门户展示。后台保存草稿后,需走发布操作才能作为正式内容展示。
应用示例:总部发布销售政策,在门户公告区展示,并由知识维护人员决定是否同步进入知识库。
集成边界:新闻发布、消息通知和知识索引属于不同链路。下架公告后,关联知识、外部缓存或已发送通知的处理需要有明确规则。
企业内容生命周期
新闻公告解决企业内容的集中编排与展示,消息中心解决“把变化通知给谁”,知识库解决“让内容可检索与可引用”。三者可以配合,但生命周期互不替代。发布一条制度公告后,是否发送消息、是否同步到知识库,需要分别确认和记录。
建议项目按“内容草稿 → 审阅 → 正式发布 → 到期复核 → 下架/归档”管理内容;这是一套实施流程,是否每一步都有独立系统状态,应以当前部署的编辑和发布入口核对。制度类内容还应标注业务所有人、适用组织、生效时间、版本及替代关系。
发布后不仅要验证文章详情,还要验证栏目列表、门户轮播、搜索入口和无权用户访问。标题可见而正文受限、附件无权限、过期轮播残留等问题应纳入验收。新闻下架不会自动撤回已发消息,也不能假定已被知识库解析的旧版本自动失效,应建立跨模块内容变更清单。
统一新闻公告:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“创建内容草稿”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一新闻公告》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一新闻公告 · 动态操作讲解2:54 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
08 统一安全认证
认证中心为平台不同端提供登录与会话基础。代码包含 OAuth2 相关客户端配置、会话管理及 SSO 会话恢复链路;前端也提供 PKCE 登录相关处理。
技术组成:认证服务、注册客户端、访问令牌与会话、密码策略、登录退出及客户端回调配置。
应用示例:员工登录后访问门户、应用设计或管理端;各资源按登录身份及授权校验访问范围。
集成边界:单点登录解决身份连续性,应用仍需校验菜单、功能与数据权限。已有系统接入应核对协议、回调白名单、会话退出、令牌有效期与人员标识映射;不应把浏览器可见配置当作服务器机密的存储位置。
身份连续性与资源授权
认证链回答“当前是谁”,授权链回答“该身份现在能做什么”。平台前端包含密码登录、OAuth 授权码交换、PKCE、刷新与退出相关接口;服务端提供认证和 SSO 相关控制器。实际采用的登录方式取决于部署配置和客户端注册,不应把所有代码入口视为全部已启用。
访问业务页面 → 判断会话 → 认证端验证身份 → 回调与状态校验
→ 建立本端身份 → 获取角色与资源 → 每次请求再校验数据和动作
多端场景中,Portal、Admin 与 Design 的跳转需要统一公开来源地址与回调规则。浏览器的协议、域名、端口和路径参与回调校验;开发环境混用 localhost 与 127.0.0.1 可能造成会话不连续。
密码策略、令牌有效期、刷新、主动退出、强制退出和用户停用需形成完整会话策略。单点退出能影响哪些客户端,应通过实际会话验证;隐藏菜单不能替代接口授权。外部身份接入还需要稳定人员标识、账号冲突处理和停用传播机制。
统一安全认证:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“核对客户端配置”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一安全认证》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一安全认证 · 动态操作讲解2:57 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
09 统一组织
组织模块维护人员、组织分组、组织维度与角色等基础信息,为应用可见范围、流程选人、知识权限和管理权限提供依据。
技术组成:人员、机构/分组、角色与授权、关系及同步接口。不同业务可能按部门、岗位或项目角色选择参与人,应明确主数据归属。
应用示例:销售申请由所在部门负责人审批;区域销售只访问本区域业务;离职人员同步停用并清理有效会话。
集成边界:组织同步需要稳定的外部 ID、增量与离职策略。组织记录更新不等于所有业务授权已刷新,应验证缓存、历史任务与交接规则。
组织主数据与多维授权
统一组织为应用、流程、知识和智能执行提供人员与组织关系。企业中行政部门、项目组、岗位、业务区域和应用角色可能同时存在;实施时应明确哪一种关系负责审批选人,哪一种关系负责资源授权,哪一种关系用于报表维度。
| 主数据 | 建议管理约定 | 影响范围 |
|---|---|---|
| 人员 | 稳定外部 ID、唯一账号、启停与归属 | 登录、待办归属、应用与知识权限 |
| 组织分组 | 编码、父子关系、维度、有效期 | 组织树、数据范围、流程选人 |
| 角色 | 业务职责、授权范围、责任人 | 菜单、动作、管理能力 |
| 人员关系 | 主属/兼职、岗位与项目归属 | 审批、代理、区域数据;支持范围逐项核对 |
组织同步应优先采用外部 ID 映射,避免按姓名匹配。新增、移动、兼岗和离职要分别制定规则。离职不仅是停用用户,还涉及有效会话、未办任务、数据负责人、文档共享和应用维护责任的交接。
授权变化的生效时机应对缓存、现有会话与后台任务分别验证。历史流程记录应保留当时的办理事实,不应因组织树调整而改写历史责任。
统一组织:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“建立组织与人员”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一组织》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一组织 · 动态操作讲解2:56 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
10 统一应用构建
统一应用构建以应用为边界组织数据模型、表单、列表、页面、菜单与资源权限。开发者可从业务需求建立应用结构,再配置页面和业务操作。
技术组成:应用目录、主子表模型、表单设计、列表视图、页面、大屏资源、菜单授权与版本。AI 构建和人工设计应复用已发布的原生资源,避免形成两套互不相认的定义。
应用示例:采购应用包含供应商、采购申请主子表、审批流程和执行看板;CRM 包含客户、报价、合同及回款关联。
集成边界:页面预览通过不足以证明应用可交付。应分别验证字段约束、主子表读写、按钮行为、数据权限、版本导出与目标环境安装。涉及高码项目时,还需满足运行环境、构建与交付配置。
应用元数据与原生资源模型
应用构建将业务对象、字段、表单、列表、按钮、菜单和资源权限组织为可管理的应用。原生资源是平台设计器与运行时共同识别的定义。AI 生成和人工配置需要回到同一套资源,才能继续编辑、授权、导出和升级。
| 资源层 | 典型内容 | 设计关注点 |
|---|---|---|
| 数据层 | 主表、明细、字段、关系 | 主键、金额精度、字典、约束、审计与数据归属 |
| 交互层 | 表单、列表、页面、按钮 | 校验、查询、分页、附件、错误回显 |
| 流转层 | 流程绑定、编排与业务动作 | 状态机、并发、防重与失败恢复 |
| 访问层 | 菜单、角色、功能与数据范围 | 查看、编辑、导出和动作权限分别检查 |
| 交付层 | 版本、资源包与安装配置 | 依赖、原生资源回读与目标环境回归 |
例如采购申请主表保存申请部门、币种和总额,明细保存物料、数量和单价。总额的服务端计算和流程状态约束不能仅依赖前端只读属性。保存主子表后还应检查完整单据回读,而非只检查新增行返回值。
平台应用开发、高码工程与独立交付具有不同构建依赖。是否支持特定扩展、数据库或部署形态,应结合支持矩阵和交付方式核对,不能从设计界面推导为任意工程均可一键部署。
统一应用构建:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“设计主子表模型”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一应用构建》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一应用构建 · 动态操作讲解2:53 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
11 统一流程定义
流程定义为审批与协作配置参与人、节点、条件和表单关联;BPM 实例承载每一次具体办理的进度与结果。
技术组成:流程定义与模型、节点配置、表单绑定、流程实例、待办、意见和运行管理。业务动作可以在明确的节点和权限条件下接入编排或智能体。
应用示例:采购申请按金额分支审批,审批完成后触发业务单据转换;AI 可辅助提取附件与解释风险,由指定人员作审批决定。
集成边界:流程定义发布与流程实例完结分别验收。流程退回、撤回、转办、会签和无有效审批人等异常分支应测试;流程变更对在途实例的处理按引擎配置确认。
审批责任、流程状态与业务动作
BPM 的核心是确定办理责任和流转路径。应用状态机描述业务是否可编辑、可转换或可归档;流程状态描述实例当前走到哪里。二者需要建立明确关联,但不应直接混为一个字段。
流程设计需要明确开始条件、节点表单、办理人来源、条件分支、意见和结束动作。以采购审批为例,金额应先按指定币种和精度确定,再用于分支;“大于”和“大于等于”的差异会影响临界金额的审批人。组织为空或负责人失效时,需要明确提示或转人工处理,不能静默通过。
| 变更 | 需要核对的对象 | 实施决策 |
|---|---|---|
| 节点人员变化 | 当前任务与后续节点 | 是重新解析、人工转办还是保留原责任 |
| 定义发布新版本 | 新实例与在途实例 | 不默认假设在途实例自动迁移 |
| 业务撤回/驳回 | 单据状态、任务、历史 | 可再次提交的字段和流程版本 |
| 审批后调用接口 | 业务结果、流程回执 | 明确提交成功与业务完成的差异 |
AI 可协助整理附件、风险摘要和依据,审批决定仍由授权主体按业务制度作出。流程结束后调用外部系统时,需要对接口失败和结果未知建立补偿方案;流程实例结束不等于所有外部副作用已完成。
统一流程定义:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“绘制节点与分支”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一流程定义》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一流程定义 · 动态操作讲解2:47 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
12 统一大屏或报表
平台包含大屏与报表相关服务、设计接口及运行入口,用于把应用数据呈现为经营看板、统计报表或业务明细。
技术组成:大屏视图、数据模型、图表、权限、历史与分享管理,以及报表相关资源。多视图列表、定制页面与专业大屏在应用构建中具有各自的资源定义。
应用示例:采购看板呈现待审批金额、交期风险和供应商分布;CRM 报表按统一口径计算净销售额与逾期应收。
集成边界:图表外观、数据接通、指标正确和访问授权须分别核对。分享链接与导出文件也应测试数据范围;未接入实时数据时应标注为示例或快照。
指标口径、数据范围与展示资源
报表首先是可解释的指标,再是可视化。一个“销售额”指标至少要定义订单/合同来源、含税与否、币种、状态过滤、时间字段和撤销处理。看板、问数、智能体和经营周报应尽量复用同一指标定义。
大屏设计、报表资源和多视图列表服务不同需求:大屏强调组合展示与布局,报表强调统计和明细对账,列表强调业务数据浏览与操作。某个界面能呈现图表,不代表其发布、分享和导出权限完全相同。
建议保留指标说明卡:指标编码、负责人、单位、计算方式、来源、统计周期、刷新时间和权限范围。图表旁应呈现数据时间,区分实时查询、缓存与周期汇总。空值、无权限、无数据与接口失败应有不同表现。
分享和导出属于独立数据出口,应单独验收。页面只显示某部门数据时,导出不能退回全量查询;分享地址也不能绕过登录、角色与资源范围。地图、外部数据集、实时消息流等能力以实际连接器和部署资源为前提。
统一大屏或报表:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“连接授权数据”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一大屏或报表》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一大屏或报表 · 动态操作讲解2:48 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
13 统一知识库
知识库为企业资料提供组织、检索和问答能力,包含知识库、文档、分片、共享权限和门户入口。RAG 问答将可用知识片段提供给模型,回答依据与普通检索候选分别呈现。
技术组成:文件与文档管理、解析和检索、知识权限、问答及引用。向量、重排与问答模型需要各自可用的模型能力配置。
应用示例:销售咨询产品交付条款,助手返回有来源的说明;维修人员查询设备手册,再结合授权业务数据核对设备状态。
集成边界:上传成功不等于解析或索引成功;检索命中不等于回答被证据支持。没有依据、权限不足与模型调用失败应分别提示。完整冻结评测、发布门禁等治理目标需按版本核实,不能把规划内容写成现成能力。
从资料到可引用答案
知识链路包含资料登记、解析、片段、索引、检索、上下文组装和回答。每个阶段都应可诊断:上传成功不代表解析完成,全文就绪不代表向量就绪,搜索找到候选也不代表生成答案已经有足够依据。
授权资料 → 解析与片段 → 全文 / 向量 / 可选重排 → 授权候选
↓
答案与引用 ← 组织上下文 ← 当前问题与历史
当前部署指南将 PostgreSQL 作为默认全文检索策略,基于已解析并启用的片段召回;不要求先配置 embedding。向量检索可以采用 pgvector,也存在其他可选组件,须核对实际配置与兼容性。向量链路需要可用 embedding 模型及能力绑定,重排则需要独立重排能力,不能用普通聊天模型替代。
知识治理需要管理资料所有人、版本、有效期、共享范围与冲突规则。权限应贯穿检索候选、文档打开、引用与下载;不能只在知识库入口隐藏文件。模型回答应说明引用与适用范围,资料不足或相互冲突时保留不确定性。
验收样本应覆盖正确问题、同义表达、无答案、过期资料、跨部门越权及带有恶意指令的文档。文档内容只能作为资料,不能获得替用户授权调用工具或更改规则的权力。
统一知识库:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“上传并检查加工”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一知识库》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一知识库 · 动态操作讲解2:50 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
14 智能体与能力资产
智能体把模型、指令和可访问资源组合成面向任务的工作助手。提示词模板、技能、工具与 MCP 各自维护,可以在智能体配置中按需绑定。
| 资产 | 主要职责 | 接入与验证要点 |
|---|---|---|
| 提示词模板 | 角色、任务、输入变量与输出约定 | 用真实变量测试,避免把示例文本当作业务事实 |
| 技能 | 可复用的方法、步骤与工具使用约定 | 核对技能内容、依赖、发布状态及实际可执行范围 |
| 工具 | 明确输入输出的业务操作 | 校验 Schema、权限、副作用、超时与错误语义 |
| MCP | 通过协议发现和调用服务工具 | 连接测试、工具发现、认证、输入校验与服务可用性 |
| 知识库 | 文档与知识依据 | 使用可访问库,核验检索与引用 |
| 业务语义 | 统一口径、对象关系及受控上下文 | 使用已发布版本、有效映射与场景绑定 |
应用示例:合同助手先读取合同信息与制度,再给出风险提示。生成合同或通知外部人员时,应调用经过授权的业务动作并核验结果。
集成边界:配置可以独立创建或关联应用,引用须使用真实资源 ID。工具、知识库、技能和 MCP 并非全部必填。保存为草稿与正式发布分开;“有某个工具”不等于当前身份有权执行。技能的文本步骤也不自动赋予底层权限。
智能资产的分工与执行契约
| 资产 | 负责什么 | 推荐管理信息 |
|---|---|---|
| 提示词模板 | 角色、目标、输入结构、回答约束 | 版本、变量、样例、输出格式与无依据行为 |
| 技能 | 可复用的任务方法和执行约定 | 适用场景、前置条件、依赖工具、成果与限制 |
| 工具 | 读取数据或执行具体操作 | 输入输出 Schema、权限、副作用、超时、幂等与回执 |
| MCP 服务 | 按协议暴露外部能力 | 服务来源、连接方式、认证引用、工具白名单与健康检查 |
| 智能体 | 组合模型、知识、资产与业务上下文 | 所属应用、绑定资产、可见范围、版本与发布状态 |
资产绑定是引用关系,不会自动授予来源资源权限。MCP 连接成功说明协议握手或服务可达,还应分别验证工具发现、单次只读调用、身份传递和写入策略。工具描述中声称“只读”,也应与实际执行器核对。
运行时应把模型判断、工具请求、工具响应和最终总结分开留存。模型声称“已经提交”不能替代执行器回执。写入型工具需要明确审批、幂等、防重和结果核验;返回未知时,应阻止无条件自动重放。
智能体测试至少包括:有依据回答、知识不足、无权资源、参数不合法、工具失败、超时、恶意指令和重复动作。评测应记录绑定版本与实际模型,避免模型或知识更新后继续引用旧结论。
智能体与能力资产:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“准备技能与工具”涉及的入口与资源;示例或空态以演示环境为准。
观看《智能体与能力资产》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
智能体与能力资产 · 动态操作讲解2:58 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
15 统一 Harness 调度
Harness 在平台中组织“业务目标—计划—执行任务—结果”。它把已发布、可访问的能力与输入约束用于规划,向员工呈现需要补充的条件、待确认动作、运行状态与产物。
技术组成:业务范围、能力目录、需求、计划、任务运行、结果及发布申请。任务记录与真实工具回执共同用于判断完成情况。
应用示例:员工提出“分析本月逾期回款并准备跟进报告”。系统发现只读分析能力,必要时追问时间和对象;涉及写入或通知的步骤先显示具体对象与参数,再按审批要求执行。
与定时任务的关系:Harness 的任务计划管理与 XXL-JOB 等定时任务管理属于不同职责。定时触发、分布式执行和进程重启恢复,应按具体执行链路与部署配置验收。
集成边界:已核对的设计任务链路包含模型生成方案与异步执行,但不应据此承诺每个步骤都能持续自主重规划,或所有任务都能持久化重启恢复。业务结果未知时,先对账再决定是否重试。
目标、计划、确认、运行与证据
Harness 将复杂目标整理为计划和可执行任务,把能力选择、参数、作用域和结果串联起来。它适合经营周报、合同审查、应收分析等需要多种能力协作的场景。确定性单据转换仍应优先交给业务编排,审批责任交给 BPM。
目标与作用域 → 计划草案 → 依赖检查 → 人工确认 → 领取运行
↓
业务终态核验 ← 工具回执与成果 ← 分步执行与状态
确认应绑定计划摘要、需求版本、作用域、操作参数和能力契约。用户修改计划或参数后,应重新确认。执行前仍需复核授权、发布版本、调用地址和风险策略,避免计划形成后权限或数据已变化。
结果要区分内容生成、操作提交、已核验完成与结果未知。报告正文是内容成果,受理号是提交证据,只有领域系统可回查的终态才能证明业务完成。平台计划与办公受控业务计划可能使用不同 ID,日志关联时应保留其对应关系。
后台执行是额外运行契约。定时或事件触发还需验证调度归属、执行身份、持久化队列、重启恢复、租约、防重、取消和外部结果核验。普通异步线程不能直接表述为可恢复的企业任务调度;自动重规划和无人值守运行需以现场验证结果为准。
统一 Harness 调度:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“描述目标并补条件”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一 Harness 调度》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一 Harness 调度 · 动态操作讲解2:59 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
16 统一安全审计
安全审计覆盖身份会话、平台操作、AI 运行、模型调用与业务动作等多个领域。相关日志与管理入口分布在认证、系统、AI 治理、语义和业务编排模块中。
技术组成:有效会话管理、系统日志、模型调用审计、运行轨迹、语义执行计划与动作回执、编排节点日志。
应用示例:管理员从异常任务找到运行标识,核对用户、应用、模型路由、审批记录及业务回执,确认失败发生在模型调用还是业务写入。
集成边界:多领域日志不等于所有记录天然统一到一张表。项目应建立 taskId、runId、traceId、业务主键等关联规范,分别配置保留期、访问权限和脱敏。日志存在并不自动构成防篡改存证或特定合规认证。
分层审计与跨模块关联
平台审计、业务审计与模型调用审计关注点不同。平台审计记录账号与配置变更;业务审计记录谁对哪张单据做了什么;智能执行审计记录计划、工具、模型与结果。建立关联规范后,才能把一次员工请求追踪到实际单据与模型成本。
| 层面 | 应关注的记录 | 不能据此推断 |
|---|---|---|
| 登录与管理 | 登录结果、配置操作、操作者与时间 | 已登录不等于已获业务权限 |
| 应用与流程 | 单据、实例、节点、意见和回执 | 操作日志不自动表示业务提交成功 |
| 智能运行 | 计划、任务、工具响应与业务核验 | 模型总结不等于执行结果 |
| 模型网关 | 能力绑定、调用状态、用量与费用口径 | 单次调用成功不等于全场景成功 |
项目可以约定统一关联 ID,并保留服务各自原生的 requestId、planId、jobId、runId、instanceId 与业务 ID。字段名称和支持情况应以具体接口为准,不能假定每个日志都天然包含同一字段。
审计本身也需要授权、脱敏、保留与检索策略。配置密钥、完整令牌、个人信息和敏感提示词不应进入普通日志。平台页面存在日志查询入口,不代表已经具备法律意义上的不可篡改归档;若有此要求,需要独立存储、权限隔离与恢复验证。
统一安全审计:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“配置访问和保留”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一安全审计》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一安全审计 · 动态操作讲解2:58 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
17 统一大模型网关
模型网关统一管理模型端点、凭据、能力绑定和调用治理。业务组件按能力使用模型,减少把供应商地址或密钥写入应用的情况。
技术组成:模型提供方、加密凭据、主备能力绑定、健康探测、调用审计、用量与价格、预算和内容策略。
| 能力标识示例 | 主要用途 |
|---|---|
task.chat |
门户任务对话 |
design.generate |
页面与应用设计生成 |
desktop.assistant |
DSH 助手 |
agent.runtime |
智能体与规划调用 |
knowledge.answer |
知识回答 |
embedding.retrieve |
文本向量检索 |
knowledge.rerank |
知识重排 |
vision.chat |
支持视觉输入的实际模型 |
应用示例:办公对话使用一个模型,知识检索采用独立的向量和重排模型;管理员统一查看调用量与成本策略。
集成边界:端点保存成功和目录非空不代表真实调用通过;需执行健康探测并用实际业务请求验证。文本、向量、视觉和重排能力不能仅靠名称互换。成本估算依赖实际用量与有效价格,缺少计费信息时不能显示为零成本。
能力绑定与模型治理链路
网关把“业务需要的能力”与“具体供应商模型”解耦。业务调用 knowledge.answer,管理员决定该能力使用哪个主模型与备用模型。调整绑定不应要求业务页面直接持有供应商密钥。
| 能力标识 | 主要用途 | 前置核验 |
|---|---|---|
task.chat / agent.runtime |
任务对话、智能体 | 文本、流式与所需工具能力 |
design.generate / desktop.assistant |
应用设计、DSH 助手 | 结构化生成、工具或实际上下文需求 |
knowledge.answer |
知识回答 | 文本生成;引用由知识链路提供 |
embedding.retrieve |
文本向量 | embedding 协议、维度与索引空间 |
embedding.image / vision.chat |
图像向量、视觉问答 | 两种不同任务,模型不能互相假定兼容 |
knowledge.rerank |
检索重排 | 实际受支持的重排协议 |
端点、凭据、绑定、健康、价格、预算和内容策略构成治理链。保存配置不会自动请求供应商;保存 provider、credential 或 binding 会使相关健康状态失效,需要重新探测。能力目录非空仅表示配置存在,不说明网络、额度、License 和预算均可用。
降级不是任意换模型:要同时满足协议、上下文、输出格式、工具和向量维度要求。流式响应已经输出部分内容后,不应静默重试而拼接出重复答案。embedding 模型更换时,还需处理旧索引与新向量空间,不能只改模型名称。
费用统计需同时记录价格版本、币种、生效区间和供应商 usage 是否可得。缺少 token 统计时不应把成本记为真实零费用;预算、内容策略与审计是否启用,要在目标租户逐项确认。
统一大模型网关:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“安全保存凭据”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一大模型网关》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一大模型网关 · 动态操作讲解2:51 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
18 统一业务编排
业务编排将查询、条件、转换、模型调用和业务写入组织为明确的执行图,适合重复、结构化、可回归的业务操作。
技术组成:输入输出契约、节点与变量映射、条件和数据转换、应用模型操作、调试与测试用例、发布快照、日志和回滚。
应用示例:报价转合同:读取已保存报价及明细 → 校验状态 → 转换字段和金额 → 防重创建合同草稿 → 回填来源 → 返回单据标识。
事务边界:当前实现对启用原子转换的本地模型链路提供事务、来源锁与防重处理;跨独立数据源及外部 HTTP 调用不应宣称处于同一数据库事务,应设计幂等与补偿。
集成边界:编排处理业务步骤,BPM 处理责任审批,Harness 处理目标和任务。模型输出要通过结构校验;调试 Mock 不能进入生产执行;业务日志中的成功还应与实际单据核对。
确定性步骤、发布快照与事务边界
业务编排通过输入输出契约、条件、查询、转换、写入与调用节点组织确定的业务操作。它适合报价转合同、审批后回填、主子表转换与接口联动。模型节点可以参与,但结构化结果需要按 Schema 验证后才能流入后续步骤。
当前实现资料描述了主子表读取、条件与字段白名单、转换预览、运行日志、用例、Mock、发布快照和版本回滚等能力。金额、日期、时区、布尔值、零值与显式 null 的处理应按契约验收,不能仅凭节点连线判断正确。
以 AI-CRM 报价转合同为例:读取并锁定已保存报价及明细 → 检查允许状态与防重 → 转换字段和金额 → 新建草稿合同 → 回填来源关联 → 返回目标标识。来源 ID、真实完整明细和审批状态应由服务端读取,不能信任浏览器携带的金额。
本地同事务转换可覆盖目标新增和来源回填;独立数据源和远程 HTTP 不应继承这一原子承诺。跨系统操作需要业务幂等、状态查询、补偿与人工处理。发布快照、调试草稿和生产运行应分开,Mock 仅用于允许的调试测试环境。
验收应同时检查“第一次成功”“重复请求不重复建单”“并发请求”“来源变化”“中途失败回滚”和“远程结果未知”。画布看起来完整不是交付证据,目标单据、来源回填、运行 ID 与错误记录应彼此对应。
统一业务编排:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“编排读取与校验”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一业务编排》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一业务编排 · 动态操作讲解2:55 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
19 AI 应用构建
AI 应用构建从自然语言需求出发,辅助完成需求拆解、资源规划、表单页面、流程和应用交付。AI 的生成结果应进入原生应用资源和版本体系,再经过开发者审阅及验证。
技术组成:需求分析、App Spec 任务图、原生资源创建和回读、设计预览、运行验证、应用版本与交付安装。标准与高级模式分别面向不同开发和运行需求。
当前工具链:开发包说明将面向模型的应用交付入口收敛为 delivery_app_plan → delivery_app_get → delivery_app_run → delivery_app_status。旧的蓝图工具保留内部修复或历史对账用途,不作为新项目默认教程。
应用示例:提出“建立设备维修应用,含报修、派工、维修和验收”。AI 生成资源计划,开发者检查对象与流程,再验证主子表、列表、权限、真实流程实例和目标端安装。
集成边界:生成页面、单元测试、应用发布和客户环境上线是不同验收点。高码签名导出、交付与安装还依赖 License、构建环境、签名与安装目标配置,不能承诺任意环境一键完成。
从需求到平台可维护资源
AI 应用构建将自然语言需求转换为设计与资源草案,再由设计器、验证与发布流程形成交付物。高质量输入应包含使用角色、业务对象、字段与关系、操作、状态、审批、报表和验收标准,而不是只有一句“做一个 CRM”。
需求说明 → 应用规格与资源计划 → 人工审阅 → 原生资源生成
→ 资源回读与设计器复核 → 真实运行 → 版本与交付验收
原生资源回读是关键检查点:表单是否被表单设计器识别,列表与按钮是否引用正确模型,大屏是否采用对应资源定义,菜单是否能在授权角色下打开。单张生成页面不能代表整个应用已经具备数据、权限、流程和打包能力。
标准与高级模式面向不同配置与扩展需求。应用关联、工具、知识、技能及 MCP 绑定影响智能体的可用能力;未配置依赖时应显示明确提示,而不是假设已有默认业务上下文。应用规格、生成资源和运行时之间的差异,应记录并通过回读或对账修复。
发布前还要检查模型、文件、外部服务和数据库等环境依赖。高码构建、独立应用包、插件和平台内原生资源有各自构建契约,应分别验证。AI 提高设计效率的效果应由真实场景测量,不能把演示生成速度当作所有项目的交付周期。
AI 应用构建:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“审阅应用计划”涉及的入口与资源;示例或空态以演示环境为准。
观看《AI 应用构建》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
AI 应用构建 · 动态操作讲解3:01 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
20 业务语义模块
业务语义(本体)为数据、规则和智能体提供共同的业务解释。它描述“对象是什么、字段代表什么、对象如何关联、数据从哪里来、允许做什么”,让不同应用与智能体复用同一业务口径。
业务域 → 实体 / 属性 / 关系 → 资料与数据连接 → 资源映射
│
业务规则 + 策略与受控动作 ───────────────────────────┤
▼
场景配置 → 就绪检查 → 发布版本 → 上下文绑定 → 运行 / 审批 / 回执
核心构成:业务域、概念实体、属性、关系、外部资源和映射、规则、动作、策略、场景、上下文、版本、运行任务与审计。设计端有操作指引、语义模型、资源映射、场景配置、就绪检查和运行管理等入口。
应用示例:回款风险分析。先定义客户、合同、应收和回款对象,再明确净销售额、截止日、币种和逾期规则。把真实数据字段映射到语义属性,限制敏感信息;只读分析输出依据,生成正式报告或触发办理则走受控计划与审批。
与相邻能力的关系:知识库回答文档依据,语义模块说明业务含义并关联结构化事实;业务编排执行确定的步骤;智能体在授权上下文中理解任务;流程确定审批责任。语义模型不会自动替代其中任意一项。
集成边界:创建实体不等于接通真实数据;草稿、预览、就绪检查与正式发布分别管理;发布后还需绑定到场景或智能体。界面上的启发式建议或模拟校验,不应替代服务端验证和真实数据验收。具体实施见开发手册的业务语义章节。
语义资产、事实与受控动作
| 层次 | 主要对象 | 解决的问题 |
|---|---|---|
| 概念 | 业务域、实体、属性与关系 | 客户、合同、回款分别指什么,如何关联 |
| 事实 | 外部资源、字段结构与映射 | 真实数据来自哪里,字段如何转换 |
| 规则 | 条件、缺失事实处理、回归样例 | 什么情况成立、未成立或无法判断 |
| 行为 | 动作、执行器、策略与审批 | 允许谁在什么前提下执行什么操作 |
| 场景 | 上下文、就绪、版本与绑定 | 哪些资产组合形成一个可运行场景 |
| 运行 | 计划、执行、核验与审计 | 实际做了什么,证据在哪,如何追踪 |
业务语义不是把数据库表名换成中文。它需要定义实体粒度、稳定标识、时间口径、单位、关系方向和事实来源。对于“客户风险高吗”,必须明确统计时点、币种、应收状态、逾期天数、退款抵扣与资料权限。
规则缺失事实时应保留 UNKNOWN,而不是按零值或假条件处理。动作定义要有输入 Schema、执行器、风险级别和审批策略;定义被修改后,需要重新检查其审核与发布状态。发布版本和运行绑定分开管理,回滚版本后还要重新检查权限与策略。
当前资料明确:映射推荐属于启发式辅助,部分就绪评分来自前端权重;批量映射发布不是整体事务;关系配置建议不等于真实数据校验。平台不据此承诺完整 OWL/RDFS 推理、跨库自动 JOIN、实体自动消歧或全外部系统依赖识别。这些限制决定了实施人员必须人工确认映射,并在目标系统核验实际运行结果。
统一业务语义:真实界面与操作视频

图中为已采集的真实产品界面。阅读时重点核对“接入资源并映射”涉及的入口与资源;示例或空态以演示环境为准。
观看《统一业务语义》完整动态操作课程 · 下载本模块操作讲义 · 查看真实界面原图
统一业务语义 · 动态操作讲解3:04 · 中文配音 · 同步字幕 · 展开播放
真实操作关键帧剪辑与语音同步标注,非连续录屏。查看章节、操作步骤与真实原图 →
21 应用贯穿示例
CRM:报价、合同与回款协同
- 组织与认证确定销售和审批人的身份,门户按角色提供应用入口。
- 应用构建维护客户、报价、合同与回款对象,BPM 处理报价审批,统一待办承接办理。
- 业务编排将满足条件的报价转为合同草稿,核验防重与来源回填。
- 业务语义统一净销售额、逾期应收与客户风险口径,知识库提供政策依据。
- 智能体调用授权的只读分析工具,Harness 组织任务;需要通知或写入时按要求确认及审批。
- 报表展示可核验结果,消息中心发送通知,各领域日志保留运行关联。
验收应包括:正确口径、引用依据、无权访问、重复转换、失败回滚、消息送达、审批前禁止写入、业务回执与单据一致。
设备维修:从异常到验收
设备异常记录进入维修应用,按设备、工单、人员和备件建立语义关系。知识助手引用维修手册;流程分派与验收由指定人员办理;编排同步工单状态或调用经授权的外部接口;看板呈现工单进度。IoT 或 MES 报警来源需单独接入、去重及核验,不应以演示数据代替实时采集。
22 部署、扩展与验收
平台开发包包含部署与运维工具、数据库、缓存、文件及可选服务。部署应按目标架构核对必需服务、网络、存储、模型能力、License 和组织授权。官网文档只介绍平台集成路径;具体安装参数以随交付版本提供的安装指南为准。
| 验收层面 | 应保留的证据 |
|---|---|
| 身份与数据 | 不同角色、租户与数据范围的正反例 |
| 应用资源 | 表单、页面、列表、菜单及已发布版本 |
| 业务流程 | 真实实例、审批意见、最终状态 |
| 智能能力 | 可用绑定、工具回执、知识引用、无答案与失败场景 |
| 业务语义 | 有效映射、就绪报告、发布版本、上下文与规则样例 |
| 执行与治理 | 计划、审批、运行标识、实际业务数据与审计关联 |
| 交付运维 | 构建产物、安装记录、数据备份、升级与恢复演练 |
性能、并发量、准确率与可用性应通过目标环境测试给出;本文不引用未经本次验证的历史测试数量作为交付结论。
23 文档依据与阅读路径
本白皮书核对了门户工作台与路由、Admin/Design 的接口客户端、认证及各领域控制器,并参考开发包内的模型网关指南、智能体配置、业务编排实现、Harness 场景说明、原生资源契约和业务语义功能清单。本次未执行平台业务写入、客户系统联调或生产环境验收。
- 新读者:先阅读本白皮书的平台架构与能力全景,再按应用示例选择首个场景。
- 产品使用者:进入产品学习中心,按模块观看中文配音操作图解,并下载讲义练习。
- 实施与开发人员:进入开发手册,按组织、应用、流程、知识、语义和智能执行的顺序实施。
- 文档维护人员:代码依据与章节映射保存在官网仓库
docs/cube-platform-source-map.md,更新时重新核对接口与能力边界。
24 架构决策:五条相互关联的链路
身份链与数据链
身份链依次确认用户、租户、角色、应用归属与授权资源;数据链确认来源系统、业务主键、字段含义、版本与新鲜度。两条链在每次业务读取和写入时交汇。模型、智能体、连接器或工作流被授权调用某个工具,不表示其背后的业务数据自动可见。
应用接入应回答四个问题:平台保存的是什么、来源系统负责什么、修改通过哪个边界进行、失败由谁对账。对于现有 ERP/MES,通常先保留原系统的业务权威,通过授权查询或确定接口接入;涉及双向写入时再明确主数据归属与冲突解决方式。
控制链与执行链
控制链包含设计、测试、审核、发布、绑定与撤销;执行链包含用户请求、上下文、计划、任务、工具调用和回执。发布是控制链上的一个结果,不能代替运行时再次判权。撤权、来源停用或模型不可用发生后,即使计划已生成,执行仍应按当前状态检查。
| 决策问题 | 优先使用的模块 | 与其他模块的协同 |
|---|---|---|
| 谁负责审批、能否撤回 | BPM | 待办承接办理,消息通知,审计保留意见 |
| 固定几步如何转换单据 | 业务编排 | 应用模型、字段映射、流程节点或受控动作 |
| 复杂目标如何拆解和执行 | Harness | 智能体、能力目录、人工确认、工具回执 |
| 问题需要哪些业务概念 | 业务语义 | 对象与事实映射、规则、场景、绑定 |
| 根据制度如何解释问题 | 知识与智能体 | 授权检索、引用、模型网关 |
| 业务想使用哪种模型能力 | 模型网关 | 供应商、协议、主备、健康、预算与审计 |
证据链与责任链
一次“生成合同跟进计划”的请求可能得到文字建议,也可能触发真实任务,两者证据不同。交付应定义内容成果、操作受理、业务终态与审计记录分别由谁核验。建议在验收表中分别记录原请求、计划、运行、工具回执、目标业务 ID 与核验时间。
外部服务超时后可能已经完成业务动作,不能直接推断失败。具备查询接口时先按幂等关联查结果;没有可用查询能力时,保留未知状态并转人工核验。对外部通知、订单或付款类动作,重复执行的业务影响应在上线前明确。
25 非功能设计与运行治理
可用性与容量规划
容量评估要按工作负载拆分:门户主要是聚合查询,表单是事务读写,知识解析是文件与计算任务,模型调用是外部依赖和长连接,编排与 Harness 涉及任务状态和执行器。不能用一个“在线人数”替代全部容量指标。
| 工作负载 | 建议观测指标 | 压测与异常样本 |
|---|---|---|
| 门户与列表 | 响应分位数、错误率、慢查询、缓存命中 | 多角色、分页、来源服务超时 |
| 主子表与流程 | 提交延迟、冲突、防重与事务失败 | 重复提交、并发办理、在途变更 |
| 文档解析与检索 | 队列等待、解析失败、召回、索引新鲜度 | 大文件、格式异常、重建与模型变更 |
| 智能对话 | 首段延迟、总耗时、取消、token 与费用 | 限流、流式断开、上下文超长 |
| 编排与任务 | 等待、运行耗时、失败节点、未知结果 | 超时、进程重启、外部已执行而本地无回执 |
具体并发、容量、恢复目标和服务等级应由目标环境测试确定。设计端大型前端构建与 AI 应用构建也需要单独测量内存和构建依赖,不能用运行时资源需求代替构建机资源。
安全、隐私与内容治理
安全设计应覆盖身份、租户、资源、动作、文件、外部连接和日志。凭据保存在受控服务端配置,以引用方式提供给连接器或执行器;文档、前端配置、浏览器日志和截图不应承载真实密钥。对外部地址执行应有访问范围与身份约束,不能把任意用户输入 URL 当成可信执行器。
知识资料、提示词和工具返回值可能包含不可信指令。知识检索和模型推理应服从用户目标、权限与系统规则,不把资料内容升级为执行授权。公开链接、导出、附件预览及模型提供方的数据传输也应纳入治理。
数据备份、升级与恢复
备份范围不只是数据库,还包含上传附件、License、任务或沙箱中的业务成果、DSH 配置、模型与连接器配置及发布资源。部署说明要求稳定数据目录,升级不应重建或覆盖存量业务库。备份完成必须做可恢复性验证,恢复后重新核对文档与单据关联。
资源版本回滚、数据库恢复、外部系统补偿和权限恢复是不同操作。编排回滚改变活动定义,语义版本回滚不自动恢复历史权限,供应商凭据变更也不会随应用包恢复。运维方案应说明每一类配置的责任人与恢复方法。
26 典型业务方案的详细设计
采购申请到履约跟踪
以“采购申请审批后形成待执行记录”为首期范围。应用定义申请主子表与采购执行对象;组织确定申请人、部门负责人和采购负责人;流程按金额、类别和部门路由;消息发办理通知;门户承接待办。审批结束后,业务编排读取服务端完整申请,检查状态、防重和明细,再生成待执行记录并回填来源关联。
知识库提供采购制度、附件清单和供应商要求,智能体只解释规则和整理材料;若需生成正式记录或发起办理,转受控动作。业务语义定义采购金额、交期、未履约与供应商风险,看板与智能分析引用相同口径。对接 ERP 采购单是独立集成阶段,必须确认编码、税额、单位、状态、幂等与对账。
阶段验收依次检查:表单与权限 → 审批与任务 → 转换与回填 → 消息 → 看板与知识 → AI 与外部集成。这样可以定位问题属于业务规则、应用配置还是外部依赖。
合同审查与应收风险
合同审查先确认待审附件、适用制度、合同版本与用户权限。知识检索给出条款依据,智能体标记风险和不确定性,审查人员作业务决定。只有绑定实际业务动作后,才进入审查意见提交或跟进计划执行。
应收风险则需要结构化事实:合同、应收、回款、截止日、币种、退款与争议状态。业务语义定义逾期与风险规则;Harness 组织分析与报告;需要通知责任人或创建跟进事项时,使用独立动作入口并核验单据编号。分析报告、催收消息和跟进完成不得合并成一个“成功”状态。
设备异常到维修闭环
设备、测点、报警、工单、人员和备件分别定义稳定标识。IoT/MES 报警先验证来源与去重,再形成维修申请;流程处理分派和验收,知识库提供维修指导,编排同步业务状态,看板统计响应与关闭情况。智能体不能把相似维修案例直接写成已完成维修。
关闭工单应以现场验收、设备状态和必要附件为依据。报警消失、模型建议生成、消息送达与工单完成是四种不同事实。涉及边缘设备或控制指令时,需额外的执行隔离与人工授权设计。
27 建设路线与项目交付
| 阶段 | 建设重点 | 阶段产物 | 进入下一阶段的条件 |
|---|---|---|---|
| 业务基线 | 角色、对象、状态、口径与系统边界 | 场景卡、数据字典、责任矩阵 | 业务负责人认可样例与验收结果 |
| 平台底座 | 身份、组织、门户与资源授权 | 可登录、可访问、可追踪的测试环境 | 至少两个业务角色的正反权限通过 |
| 单场景闭环 | 应用、审批、待办、消息与看板 | 可回放的真实测试单据与运行记录 | 正常、拒绝、重复与失败路径通过 |
| 知识与智能 | 知识、语义、智能体、网关与 Harness | 评测集、资产版本、动作与回执 | 有依据回答、越权拒绝、未知结果处理通过 |
| 生产交付 | 配置、构建包、备份、告警与恢复 | 发布清单、操作手册、移交记录 | 目标环境验收和恢复演练通过 |
选型时建议现场演示同一条业务链:从登录、建单、审批到查询结果,再加入知识问答或受控智能任务。仅分别展示多个模块页面,无法验证身份、数据与运行证据是否相互连通。
28 术语与常见问题
| 术语 | 本文含义 |
|---|---|
| 原生资源 | 设计器、接口和运行时都能识别并继续维护的平台资源定义 |
| 业务事实 | 由授权业务来源提供、带业务标识与时点的数据 |
| 语义上下文 | 按业务域、场景、版本与权限选择的对象、规则和事实上下文 |
| 就绪检查 | 对依赖与配置的检查结果,不代表业务已执行 |
| 发布快照 | 某次发布时被冻结的定义,运行绑定需明确使用哪一版 |
| 幂等 | 同一业务请求重复到达时,不重复产生业务副作用 |
| 结果未知 | 请求可能已执行,但目前没有足够证据判断最终结果 |
| 回执 | 执行器或业务系统返回的受理/结果标识,仍需按契约判断终态 |
是否必须先建设全部模块? 不需要。可以先完成身份、应用和审批闭环,再按实际问题接入知识、语义与智能运行。跨模块的数据与权限约定应先统一,避免后续返工。
知识库能替代业务语义吗? 知识库适合资料检索与引用;结构化指标、对象关系、数据映射与可执行业务规则需要额外定义。两者可互相提供依据。
智能体能直接替代审批流吗? 智能体可以提出建议或请求执行,但审批责任、有效身份、流程状态与写入授权仍应由业务机制控制。
模型切换后能否继续沿用原测试结果? 应根据变更影响重新测试工具调用、结构化输出、知识回答、上下文长度、预算与索引兼容性。模型名称相似不表示能力等价。
课程视频是否证明功能已在客户现场交付? 视频展示真实产品 UI 与教学路径;写入、审批、外部发送、后台恢复和集成结果仍需要目标环境业务回执与验收记录。
继续阅读详细开发手册 · 进入产品学习中心 · 返回文档中心