OoderAgent智能场景平台——知识库+LLM+安全架构深度融合

1产品定位与核心理念

1.1 场景驱动架构：重新定义智能应用

OoderAgent 是一个基于能力驱动架构的智能场景平台，其核心创新在于将"场景即技能"的理念贯彻到系统设计的每一个层面。与传统模板驱动模式不同，OoderAgent 采用场景驱动模式：

传统模式 开发时定义模板 → 用户选择模板 → 系统安装

场景驱动模式：场景即技能 → 管理员发现场景 → 配置分发 → 用户使用

这种设计使得场景成为可发现、可分发、可自驱的智能实体，而非静态的配置模板。

1.2 Scene = Agent：场景即智能体

在 OoderAgent 中，场景是特殊的智能体，具备以下核心属性：

2能力驱动架构：mainFirst 自驱机制

2.1 场景能力的本质定位

OoderAgent 的核心创新在于将"场景"重新定义为一种特殊的能力(Capability)，而非简单的容器：

传统理解：场景是容器

场景包含能力 → 外部驱动场景 → 场景调用能力

场景是被动的，等待外部创建和驱动

新理解：场景是能力

场景能力自驱 → 协调子能力 → 涌现新行为

场景是主动的，知道自己如何启动和运行

2.2 mainFirst：场景自驱入口

每个 SceneCapability 都可以通过mainFirst: true声明自己具有自驱能力：

mainFirst 自驱生命周期

Phase 1: selfCheck 自检

检查业务能力就绪检查驱动能力就绪检查协作能力可用

Phase 2: selfStart 自启

初始化驱动能力初始化业务能力绑定能力地址

Phase 3: startCollaboration 启动协作

启动协作场景建立协作链路

Phase 4: selfDrive 自驱运行

时间驱动事件驱动能力链调用

2.3 DRIVER_CAPABILITY：五大驱动能力

所有启动源头都可以抽象为内置的驱动能力：

2.4 能力类型体系

3Skills 应用体系

3.1 Skill 配置规范

每个 Skill 通过skill.yaml声明其完整配置：

skill:

id: com.ooder.skills.example

name:

zh_CN: "示例Skill"

en_US: "Example Skill"

version: 1.2.3

category: "data-processing"

tags: ["example", "demo", "data"]

dependencies:

skills:

- id: "com.ooder.skills.base"

version: "^1.0.0"

optional: false

system:

java: ">=1.8"

memory: ">=512MB"

lifecycle:

startupOrder: 50

startupTimeout: 30000

healthCheck:

enabled: true

interval: 30000

routing:

basePath: "/api/v1/skills/${skill.id}"

endpoints:

- path: "/agent-card"

method: "GET"

- path: "/tasks"

method: "POST"

capabilities:

types: ["task", "notification", "streaming"]

formats:

input: ["text", "json", "file"]

output: ["text", "json", "stream"]

3.2 Skill 生命周期管理

Skill 从创建到卸载经历完整的状态转换：

CREATED→INSTALLING→INSTALLED→STARTING→ACTIVE

ACTIVE→STOPPING→STOPPED→UNINSTALLING→UNINSTALLED

ERROR

(任意阶段可能进入错误状态)

3.3 热插拔事务模型

3.4 三层协作接口

Skill 与 Nexus 前端通过三层接口协议协作：

三层协作接口架构

Layer 1JavaScript API (Nexus UI ↔ Skill UI)

window.parent.postMessage()主题切换通知、布局调整通知、消息传递

Layer 2WebSocket (实时通信)

/ws/skills/{skillId}状态变更推送、实时数据流、双向通知

Layer 3RESTful API (HTTP请求)

/api/v1/skills/{skillId}/...配置管理、生命周期控制、数据查询

4知识库架构：从个人端到企业级的渐进式建设

4.1 三级知识库架构

OoderAgent 采用"个人端优先、企业级渐进"的知识库建设策略：

知识库分级架构

轻量级 (个人端)

本地文件系统存储BM25/TF-IDF 关键词检索无需外部数据库/向量库适用：个人PC、离线使用

标准级 (小团队)

SQLite-Vec 向量存储RAG 语义检索引擎单机部署、零依赖适用：小团队、基础RAG

企业级 (大型组织)

PostgreSQL/Milvus 分布式向量库知识库治理体系多租户隔离、高可用适用：大型企业、分布式

4.2 SQLite-Vec 集成方案

作为默认的向量存储方案，SQLite-Vec 具有以下优势：

4.3 RAG 引擎设计

OoderAgent 的 RAG 引擎支持多种检索策略：

检索策略:

语义检索:

- 向量相似度计算

- Top-K 结果返回

- 分数阈值过滤

混合检索:

- 语义权重: 0.7

- 关键词权重: 0.3

- 重排序优化

跨库检索:

- 多知识库合并

- 按分数排序合并

5LLM 集成架构：多级配置与上下文感知

5.1 多级 LLM 配置体系

OoderAgent 实现了灵活的多级 LLM 配置，支持从系统级到场景步骤级的精细控制：

5.2 LLM Provider 生态

系统通过 SPI 机制支持多厂商 LLM 接入：

5.3 上下文构建器

LLM 的智能响应依赖于丰富的上下文信息，OoderAgent 设计了完整的上下文构建体系：

LLM 上下文构建器

ContextSource (上下文源)

PAGE 页面SKILL 技能SCENE 场景USER 用户KNOWLEDGE 知识库

ContextExtractor (提取器)

提取结构化数据过滤敏感信息计算相关性

ContextMerger (合并器)

按优先级排序去重和压缩Token 限制裁剪

ContextFormatter (格式化器)

生成结构化 Prompt

6安全架构：嵌入式安全设计

6.1 安全控制模块架构

安全控制模块是 OoderAgent 的核心安全基础设施，提供四大核心能力：

6.2 密钥管理体系

支持多种密钥类型和完整的生命周期管理：

6.3 场景安全嵌入式设计

安全能力深度嵌入场景生命周期的每个阶段：

7三闭环设计：完整的业务闭环

7.1 闭环一：系统初始化

系统初始化闭环确保基础能力就绪：

系统初始化闭环

安装基础技能包

skill-scene, skill-capability, skill-health

系统自检

检查核心能力是否就绪

进入就绪状态

可以发现和安装场景技能

系统就绪，等待场景安装

7.2 闭环二：管理员场景分发

管理员通过场景驱动模式发现和分发场景：

管理员场景分发闭环

发现场景技能

GET /api/v1/capabilities/discover?type=SCENE

选择场景技能

查看场景详情、驱动条件、所需能力

配置场景安装

选择驱动条件分支 / 配置参与者 / 选择协作能力

安装场景技能

自动解析依赖、创建场景实例

场景激活，协作者可见，业务就绪

7.3 闭环三：业务流转

实际用户通过场景自驱能力完成业务目标：

业务流转闭环

用户查看待办

GET /api/v1/todos

进入场景

主导者：配置场景/分配任务/监控进度 | 协作者：查看任务/执行任务/提交结果

场景自驱执行

selfDrive 配置定时/事件触发

业务目标达成

DRAFT → ACTIVE → SUSPENDED → COMPLETED

8场景能力类型与应用场景

8.1 场景类型对比

8.2 典型场景示例：日志汇报场景能力

sceneCapabilities:

- id: scene-daily-report

name: 日志汇报场景能力

mainFirst: true

mainFirstConfig:

selfDrive:

scheduleRules:

- trigger: "0 17 * * 1-5"

action: remind-flow

capabilityChains:

remind-flow:

- capability: report-remind

input: { targetUsers: "${role.employee}" }

9技术架构总结

9.1 CAP 地址空间

OoderAgent 定义了标准化的能力地址空间：

CAP 地址空间 (256 = 00-FF)

64个系统层 (00-3F)

00-0F核心系统能力

10-1FAgent 核心能力

20-2F场景组能力

30-3FVFS 核心能力

96个通用层 (40-9F)

40-4F消息通讯能力

50-5F组织管理能力

60-6F存储能力

70-7F监控能力

80-8F安全能力

90-9F支付能力

96个扩展层 (A0-FF)

A0-AF媒体发布能力

B0-BFAI/LLM 能力

C0-FF预留扩展区

9.2 离线优先设计

所有能力必须支持离线降级实现：

10总结

OoderAgent 通过知识库+LLM+安全架构的深度融合，构建了一个真正智能化的场景驱动平台：

这种架构设计使得 OoderAgent 能够适应从个人开发者到大型企业的不同规模需求，同时保持离线优先、安全可控、能力自驱的核心特性。

OoderAgent - 智能场景驱动平台

|

© 2026 Ooder Team. All rights reserved.