整体技术架构

本页是文档站的整站地图：先看组件如何摆放、请求如何穿过系统，再按需下钻到分层细则、内核主链路与治理机制。不替代各专题页，只提供一张可导航的总图。

部署拓扑（典型私有化）

flowchart LR
  B[浏览器 / SDK] --> W[控制台或网关]
  W -->|REST / SSE| R[runtime]
  R --> PG[(Postgres 或 SQLite)]
  R --> Obj[(MinIO / S3)]
  R --> LLM[模型服务]

控制台与 runtime 通过 HTTP/SSE 交互；业务库与对象存储贴近部署环境。多副本时文件沙箱须用对象存储，禁止仅本地盘。见文件沙箱与部署验证。

逻辑五层

flowchart TB
  subgraph Client["客户端"]
    SDK["SDK / HTTP"]
    Web["Web 控制台"]
  end
  subgraph Access["接入"]
    HTTP["HTTP / SSE"]
    Auth["认证 / 身份绑定"]
    Ctx["RequestContext"]
    EE["企业许可门禁"]
  end
  subgraph Service["服务"]
    API["API 路由"]
    Plug["插件 / 事件 / govern"]
  end
  subgraph Engine["运行时引擎"]
    Sess["会话编排"]
    Tool["工具"]
    Prov["模型网关"]
    Hitl["HITL / 熔断"]
    Fs["文件沙箱"]
  end
  subgraph Data["数据"]
    Store["SQLite / Postgres"]
    RLS["RLS / 审计 / 观测"]
  end
  Client --> Access --> Service --> Engine --> Data
  Prov --> ExtLLM[模型服务]
  Fs --> ExtS3[对象存储]

层	职责
客户端	调用 REST/SSE，携带隔离与角色上下文
接入	协议终止、身份绑定、三维上下文、RBAC、许可门禁
服务	对外契约、插件、事件、跨进程 /govern
运行时	会话循环、工具、模型、沙箱、审批与熔断衔接
数据	持久化、迁移、行级安全、审计与观测

分层职责的展开见分层架构。

请求主路径

sequenceDiagram
  participant C as 客户端
  participant A as 接入
  participant S as 服务路由
  participant E as 运行时
  participant D as 数据
  participant Bus as SSE

  C->>Bus: 订阅 /event（可选但推荐）
  C->>A: POST 会话 / 触发器等
  A->>A: 身份 · 租户 · RBAC · 许可
  A->>S: 路由
  S->>E: SessionPrompt / 分发 / 治理
  E->>D: Message / Part / 审计等
  E-->>Bus: 增量与状态
  Bus-->>C: 事件流
  E-->>C: 同步响应（若走同步接口）

会话内一次 prompt 如何变成工具调用，见端到端主链路与HTTP 流式与 SSE。触发器如何开火，见触发器组件链。

治理挂在哪

治理不嵌进某一个 agent 二进制内部，而挂在可独立部署的服务面：

挂点	作用	专题
接入 RBAC / 身份	谁能调哪些 API	RBAC · 身份
工具 permission / HITL	动作是否执行、是否他人批	HITL
熔断	全局停	熔断
审计链	写入后可否重算验真	哈希链
/govern	跨进程动作预检	进程外治理
数据 RLS	租户行级隔离	多租户 RLS

开源核心与企业实现的加载边界见Open-Core seam。

存储与隔离（速查）

项	说明
引擎	默认 SQLite；配置连接串则 Postgres
隔离	Postgres 下 app.tenant_id + RLS；生产角色须 NOBYPASSRLS
三维	tenant / owner / model 进入请求上下文
沙箱	local 或 minio/s3；多副本禁止 local
审计 / 观测	流水可查；完整性验真受许可门禁

能力到运行的配置链

flowchart LR
  Cap[Skill / MCP] --> Role[Agent Role]
  Role --> Trig[触发器]
  Trig --> Run[会话或 TeamRun]

见三层抽象与团队协作。

下钻阅读

你想弄清的	去哪
每层细节	分层架构
为何必须进程外	why-cs
一次对话怎么跑	内核主链路
可靠性与部署	可靠性
选型主张	选型对比

---

相关阅读：

• 分层架构：客户端到数据
• 端到端主链路
• 架构设计总览