3. 门户与应用层
定位：承接统一工作台、应用目录、会话入口和 BFF / API 编排边界。
当前承载组件：
AgentifUI、门户 /BFF/ API 层。
相关文档：
一、本层定义
门户与应用层是用户真正“看见”和“操作”平台的工作台层。
这一层负责应用目录、应用入口、会话承接、前端交互和 BFF 适配，但不应把底层知识检索、模型路由和授权引擎逻辑直接塞进界面层。
二、本层功能
- 提供企业统一 AI 工作台和应用目录。
- 提供聊天、任务发起、结果查看、反馈回收等交互界面。
- 通过
BFF或 API 层聚合下游能力，向前端暴露稳定接口。 - 承载应用级导航、用户上下文、会话入口和最小必要状态。
三、当前承载组件
- AgentifUI
- 门户 /
BFF/ API 层
当前方案在门户层保持收敛，只明确 AgentifUI 作为统一前台，不再额外引入新的正式门户组件。
四、上下游关系
上游层级：
下游层级：
推荐链路为：
门户 / BFF -> Agent 编排 -> 知识 / 模型 / 治理能力
五、边界
本层不负责以下能力：
- 不持有主工作流编排和多 Agent 协作状态。
- 不直接维护向量索引、检索策略和知识治理规则。
- 不承担模型统一接入、推理调度和配额控制。
- 不替代细粒度授权引擎。
六、关键链路
1. 应用分发链路
- 用户经网关进入统一门户。
- 门户展示应用目录、入口和当前权限可见范围。
- 前端通过
BFF调用对应的应用或编排服务。
2. 会话交互链路
- 用户发起对话或任务。
- 门户把会话上下文和用户上下文传给编排层。
- 编排层返回结果后，由门户统一展示、引用和反馈。
七、治理要求
- 门户看到的应用目录应与身份和权限范围一致。
- 前端不应硬编码绕过网关和编排层的后端入口。
- 会话、反馈和人工升级动作要能追溯到具体用户和应用。
- 对外 API 契约需要稳定，避免前端和编排实现强耦合。
八、部署与发布要求
- 门户前端和
BFF应分离部署，保持前端轻量和后端职责清晰。 - 新应用接入优先走目录注册和统一入口，不创建散落入口。
- 门户发布可快于编排层发布，但接口契约必须先稳定。
- 高并发场景下，门户层应保持无状态或尽量弱状态，核心状态下沉到专门服务。
九、风险与取舍
- 如果把太多编排逻辑塞进
BFF，应用层会膨胀成不可维护的控制面。 - 如果每个应用自带独立前门，平台统一工作台会失去意义。
- 如果门户层直接依赖底层检索或模型接口，后续切换编排路线会非常困难。