pj0235-eai_agentplatform/docs/01_System_Overall/SY22_角色技能应用统一任务架构.md

SY22 — Expert / Skill / App 统一任务架构

状态：总架构扩展确认稿 日期：2026-09-16 关联文档：

• History_And_Retrospectives/系统演进旧稿/SY17_工作台界面线框稿.md
• History_And_Retrospectives/系统演进旧稿/SY20_角色卡与轻量本体架构.md
• SY21_统一角色技能动作架构.md

---

1. 这份文档要解决什么问题

在 SY21 中，平台已经正式收敛为六层架构，并明确了：

• 对外暴露 专家 / 技能 / 连接器
• 对内运行 expert / skill / action / connector / policy
• 不再继续扩张 tool 概念

但随着工作台进一步向 WorkBuddy 类产品演进，系统需要新增一种与专家、技能并列的一级对象。

这类对象就是 App。

它具备以下特征：

• 不是以对话为主交互
• 有自己长期存在的主界面
• 有结构化状态、表单、题卡、看板、画布等交互
• 启动后应成为一个长程任务实例
• 可挂载右栏 AI、可调用技能、可沉淀业务产物

因此，这份文档正式确认：

平台需要第三类一级对象：App。

---

2. 最终结论

2.1 六层总架构继续成立，但第五层升级

SY21 的六层架构继续有效：

1. 外部连接层
2. 本体与语义上下文层
3. 总线与编排层
4. 能力层
5. 对象层
6. 工作台与运行治理层

本次变化是在保留六层架构的前提下，把第五层正式升级为：

对象层（Expert / Skill / App）

2.2 App 是一级对象，承接长程任务运行壳

App 的准确定义是：

面向某类长程任务的状态化运行壳。

它与 Skill 的区别在于：

• skill 解决“做什么”
• app 解决“这类工作如何持续运行、展示、交互、留痕”

它与 Expert 的区别在于：

• expert 解决“谁在与你协作”
• app 解决“这项工作在什么界面和状态机里被推进”

2.3 任务不再等于对话

平台后续的统一定义应为：

任务 = 一个工作实例容器

这个容器里可以挂载：

• 一个主 app
• 一个右栏 expert
• 多个后台 skill
• 若干 connector

因此：

• 对话是任务中的一种交互轨迹
• 消息流是部分任务的主界面形态

2.4 长程APP是一级导航，但一级导航必须完整描述

app 升格后，不能只补一句“新增长程APP”，否则会把整个一级导航重新说乱。

一级导航不再是同质栏目，而应明确分成四类：

1. 工作入口
2. 对象目录
3. 组织知识入口
4. 治理与个人入口

推荐的一级导航全景应为：

1. 新建任务
   • 对话驱动任务的默认入口
   • 负责创建以 expert 为主对象的任务
2. 项目
   • 任务容器与聚合视图
   • 用于组织多个长程任务与对话任务
3. 专家 · 技能 · 连接器
   • 对象目录与配置浏览入口
   • 这里看的是定义，不是运行时
4. 长程APP
   • app 定义卡片入口
   • 这里展示的是可启动的长程 App，不是历史任务
5. 知识库
   • 组织级默认内建 App 的直达入口
   • 承载组织专有知识、素材、题库、结果记录等核心资产
   • 是 Expert 与 App 共同消费的知识底座
6. 后台管理
   • 工坊、系统配置、对象治理、权限治理
   • 是平台治理入口，不是业务运行入口
7. 我的
   • 个人总览、我的资料、个人偏好与个人工作视角

这里最重要的边界是：

• 专家 · 技能 · 连接器 看的是对象定义与配置
• 长程APP 看的是可运行的 app
• 项目 看的是任务集合
• 知识库 看的是组织级知识底座与其内建 App 运行面

这里需要明确一个特例：

知识库本身也是 app，并作为组织级默认必须存在的内建 App。

原因是：

• 平台服务的是单一组织而不是开放公域
• 没有组织专有知识，很多 Expert 与 App 无法稳定运行
• 知识库不仅提供资料查看，还承担沉淀、审批、引用、题库与知识资产治理

因此在产品层，知识库同时具有两种身份：

1. 在对象模型里，它属于 app.knowledge_hub
2. 在一级导航里，它拥有保留的直达入口，不必埋进“长程APP”卡片列表

点击 长程APP 里的卡片后，标准动作应为：

1. 创建任务实例
2. 挂载主 app
3. 进入该 app 的运行界面
4. 同时进入统一任务列表

当前像 AI考试 这种已经长出独立业务界面的主导航，在架构上属于过渡态专题入口。 后续收敛路径为：

• 长程APP -> app.training_exam

---

3. 三类一级对象的边界

3.1 Expert

expert 是面向用户协作的交互外壳。

核心职责：

• 理解意图
• 引导开场
• 陪伴推进
• 解释状态
• 调度技能

典型交互：

• 对话主导
• 欢迎语
• starter prompts
• 右栏 AI 助手

3.2 Skill

skill 是面向任务复用的能力包。

核心职责：

• 封装某类能力
• 编排 action
• 规范输入输出
• 生成产物

典型交互：

• 被角色调用
• 被 App 调用
• 被工作流调用

3.3 App

app 是面向场景化长程任务或组织级运行面的运行壳。

核心职责：

• 承载主界面
• 驱动状态机
• 管理结构化数据
• 组织多步骤交互
• 沉淀长程产物

典型交互：

• 菜单
• 表单
• 按钮
• 题卡
• 看板
• 画布

其中应区分两类 App：

1. 任务型 App
   • 进入后通常创建 app_task
   • 例如培训考试、审批、数据分析、流程编排
2. 底座型 App
   • 组织级长期存在，默认安装
   • 例如知识库
   • 它既提供独立运行面，也为其他任务提供知识支撑

AI 在 App 中通常位于：

• 右栏副驾驶位
• 辅助填表
• 规则解释
• 状态总结
• 自然语言触发复杂动作

---

4. 六层架构回溯后的新定义

4.1 第一层：外部连接层

这一层继续负责连接真实世界与外部系统。

包括：

• 本地文件系统
• 企业业务系统
• 工业系统
• 培训 / 考试 / OA / ERP / MES / CRM / LMS
• 模型服务
• API / Webhook / MQ

这一层回答的是：

数据从哪里来，动作往哪里去。

4.2 第二层：本体与语义上下文层

这一层需要从行业对象语义继续扩展到工作对象语义。

除了原有：

• device
• alarm
• work_order
• report

还应补充：

• task
• stage
• expert
• skill
• app
• artifact
• form
• workflow
• record

对于 app，这一层必须支持：

• App 处理的业务对象类型
• App 允许的阶段类型
• App 产物类型
• App 与 Expert / Skill 的可挂载关系

这一层回答的是：

平台到底在处理哪些业务对象、工作对象和它们之间的关系。

4.3 第三层：总线与编排层

这一层继续承担流转职责，但要正式接纳 app 作为任务主对象。

至少应包含：

1. 任务总线
2. 事件总线
3. 对象挂载总线
4. 能力编排总线

新职责包括：

• 任务创建后挂载主 app
• 根据 app 状态切换工作台界面
• 允许右栏 expert 感知当前 app 上下文
• 允许 app 调度 skill
• 允许人工接管与审批节点插入

这一层回答的是：

任务如何创建，对象如何挂载，状态如何推进，能力如何协作。

4.4 第四层：能力层

这一层继续保持：

• skill
• action
• policy

但要明确一个边界：

App 不进入能力层。

原因是：

• skill 是能力包
• action 是原子动作
• app 是运行壳

App 可以调用 Skill，但不替代 Skill。

4.5 第五层：对象层

这一层正式收敛为：

• expert
• skill
• app

并且三者都应该具备：

• 对象定义
• 版本信息
• 生命周期状态
• 权限边界
• 可挂载关系

这一层回答的是：

平台有哪些可被用户使用、可被任务挂载、可被版本化治理的一等对象。

4.6 第六层：工作台与运行治理层

这一层不再只有单一对话工作台，而应明确分成两类运行现场：

A. 对话工作台

• 以专家为主
• 适合模糊任务、探索任务、咨询任务
• 中央区域以消息流为主

B. 长程APP

• 以 App 为主
• 适合强状态、强结构、长周期任务
• 中央区域以业务界面为主
• AI 位于右栏

两者统一纳入：

• 同一任务列表
• 同一运行治理体系
• 同一审计和产物体系

---

5. 统一任务模型

5.1 任务是工作实例容器

新的任务定义应为：

task = 一次完整工作实例

它负责统一承载：

• 当前主对象
• 当前阶段
• 当前参与对象
• 当前运行状态
• 当前产物集合

5.2 一个任务可挂多个对象实例

建议使用如下运行模型：

• 主挂载：app 或 expert
• 右栏挂载：expert
• 后台挂载：skill

例如一个培训考试任务可以是：

• 主对象：app.training_exam
• 右栏对象：expert.learning_coach
• 后台能力：skill.auto_grading
• 后台能力：skill.study_plan_generation

5.3 会话只是任务的一部分

以后应避免继续把任务状态写死在消息流里。

更准确的关系是：

• task：工作容器
• task_message：对话轨迹
• app_state：App 主状态
• artifact：产物
• event：运行轨迹

---

6. 存储架构建议

6.1 对象定义层

建议继续使用统一根定义：

• object_definition
• object_version

关键字段建议：

• object_id
• object_type：expert | skill | app
• code
• key
• label
• status
• manifest
• schema_version

其中 app.manifest 至少应包含：

• object_entry_route
• layout_type
• supported_views
• default_sidebar_expert
• allowed_skills
• state_schema
• artifact_schema
• permission_model

为避免与 AI 路由和普通页面导航混同，当前项目统一采用三类命名：

• ai_route_*：AI 模型路由
• object_entry_route：专家 / 技能 / APP 这类业务对象的进入入口
• page_route：普通页面导航路径

6.2 任务与挂载层

建议新增或统一为：

• task
• task_object_instance

task 核心字段建议：

• task_id
• task_type：conversation_task | app_task
• title
• status
• source_object_type
• source_object_id
• current_stage
• started_at
• completed_at

task_object_instance 核心字段建议：

• task_object_instance_id
• task_id
• object_id
• object_version_id
• object_type
• mount_slot：main | right_sidebar | background
• instance_role：primary | assistant | worker

6.3 运行轨迹层

建议使用：

• object_run
• task_message

其中：

• object_run 记录对象执行、阶段推进、技能调用、人工确认
• task_message 仅记录对话内容和消息元数据

需要明确：

task_message 不再承担 App 主状态存储责任。

6.4 App 状态层

建议为 app 单独引入运行时状态存储：

• app_instance_state
• app_event
• app_artifact

app_instance_state 建议存：

• task_id
• task_object_instance_id
• workflow_state
• ui_state
• form_state
• selected_record_id
• snapshot_version

app_event 建议存：

• event_type
• payload
• operator
• created_at

app_artifact 建议存：

• artifact_type
• artifact_uri
• artifact_meta
• produced_by
• created_at

6.5 领域数据层

对于复杂 App，不应把所有业务数据都塞进 app_instance_state.payload_json。

必须允许按领域建模。

例如培训考试 App 可拥有独立领域表：

• training_plan
• course_module
• exam_paper
• exam_question
• exam_attempt
• exam_answer
• exam_score

因此存储应分为：

• 通用运行表：承载平台运行
• 领域业务表：承载业务事实

---

7. 前端与交互层含义

7.1 一级导航升级

前端一级导航不能只补“长程APP”这一项，而应整体升级为完整的信息架构。

建议目标态如下：

1. 新建任务
   • 默认进入对话工作台
   • 主对象通常为 expert
2. 项目
   • 承载项目列表与项目详情
   • 用于聚合任务、产物与阶段
3. 专家 · 技能 · 连接器
   • 展示 expert / skill / connector 的定义目录
   • 负责浏览、筛选、配置、安装态查看
4. 长程APP
   • 展示 app 定义卡片
   • 负责启动 app_task
5. 知识库
   • 作为默认必须存在的内建 App 直接出现在一级导航
   • 承载组织知识、素材、题库、记录与知识治理
   • 是任务运行的公共知识面
6. 后台管理
   • 承载工坊、系统配置、组织与治理能力
7. 我的
   • 承载个人总览、个人资料与个人入口

因此，一级导航里实际并存四种不同语义：

• 工作启动入口：新建任务
• 工作组织入口：项目
• 对象目录入口：专家 · 技能 · 连接器、长程APP
• 组织知识与治理入口：知识库、后台管理、我的

7.1.1 为什么必须这样写全

如果只写：

• 专家
• 技能
• 长程APP

会遗漏三件事：

1. 项目 其实是统一任务系统的重要容器，不是普通页面
2. 知识库 是组织级默认内建 App，也是 Expert 和 App 的共用知识底座，不是边角内容
3. 后台管理 / 我的 分别承担治理与个人视角，不应被误解为附属页

7.1.2 当前专题主导航的收敛原则

凡是已经长成“非对话式、强结构、强状态”的专题栏目，例如：

• 培训考试
• 审批中心
• 数据分析台
• 流程编排台

在目标架构中都应优先判断为 app，最终收敛进：

• 长程APP

而不是继续无限增长新的专题型一级导航。

唯一应保留一级直达入口的 App，是像 知识库 这种组织级默认必装底座 App。

7.2 进入 App 的标准动作是“创建任务”

点击 App 卡片后的标准动作应为：

1. 创建 task
2. 创建主 task_object_instance(app)
3. 自动挂载右栏 expert
4. 进入 app runtime

7.3 App 运行界面不再强制对话居中

App 主界面应由业务形态决定，例如：

• 培训考试：课程目录、题卡、成绩面板
• 审批：表单、节点、操作栏
• 数据分析：图表、筛选器、表格
• 流程编排：画布、节点、日志

AI 对话框在 App 中退居右栏能力区。

---

8. 样板场景：培训考试 App

8.1 对象组合

• 主对象：app.training_exam
• 右栏对象：expert.learning_coach
• 调用技能：skill.generate_study_plan
• 调用技能：skill.auto_grade_exam

8.2 任务阶段

建议阶段至少包括：

1. 待建档
2. 培训中
3. 练习中
4. 待模拟考
5. 模拟考完成
6. 待正式考试
7. 正式考试中
8. 待复盘
9. 待补训
10. 已结业

8.3 交互形态

• 培训中：课程目录 + 内容区 + 右栏 AI 教练
• 练习中：题目区 + 即时讲解
• 正式考试中：题卡 + 倒计时 + 受控作答区
• 复盘中：错题分析 + 补训计划 + 证书面板

这个样板说明：

同一个任务实例中，对话、结构化界面、技能执行、产物沉淀可以长期共存。

---

9. 迁移指导

9.1 术语迁移

对外：

• 专家
• 技能
• 长程APP

一级导航目标态：

• 新建任务
• 项目
• 专家 · 技能 · 连接器
• 长程APP
• 知识库
• 后台管理
• 我的

对内：

• expert
• skill
• app
• action
• connector
• policy

9.2 后端迁移重点

1. 从“任务 = 对话”迁移到“任务 = 工作实例”
2. 新增 app 对象定义与版本机制
3. 新增 task_object_instance
4. 新增 app_state / app_event / app_artifact
5. 把消息表从主状态中心降级为对话轨迹层

9.3 前端迁移重点

1. 把一级导航整理为“新建任务 / 项目 / 专家 · 技能 · 连接器 / 长程APP / 知识库 / 后台管理 / 我的”
2. 新增“长程APP”并以对象定义驱动 App 卡片列表与详情页
3. 将现有专题型一级导航逐步收敛为 app，避免继续平铺新的业务主栏目；知识库 作为默认必装底座 App 保留一级直达入口
4. 统一任务列表兼容 conversation_task 和 app_task
5. App Runtime 布局支持“主业务区 + 右栏 AI”

---

10. 最终定义

这次架构升级后的平台可以正式定义为：

一个以统一任务系统为核心、同时承载 Expert / Skill / App 三类一级对象的工业智能体操作平台。

其中：

• Expert 负责协作
• Skill 负责能力
• App 负责长程任务运行壳
• Task 负责统一承载工作实例

这意味着平台当前采用以下运行形态：

对话工作台与长程APP并存，但统一运行、统一治理、统一沉淀。