Skip to content

架构

OpenAgentCore 是 Agent 运行平台,通过可替换的协议实现统一组织 Harness、模型、工具、Session 和执行环境。它将编排、计算资源和原生执行分开。Core 负责 API 和持久状态。沙箱提供商管理计算资源。独立工作区文件系统 adapter 通过单独的协议管理 Environment 持久存储。Runtime daemon 准备 Environment 并运行选定的 Harness;Harness 的原生 SDK 或协议负责模型与工具循环。

沙箱后端页面对比各部署选项。计算和文件系统 adapter 声明其支持的组合;部署选择不会引入独立的 Agent 执行流程。沙箱提供商协议和工作区文件系统协议定义其契约和支持的能力。

flowchart TB
    App["Application"] -->|"Application–Core"| Core
    Web["Web"] -->|"Web–Core"| Core
    Core[("Core + PostgreSQL")]
    Core -->|"Core–Sandbox Provider"| SP["Sandbox Provider"]
    Core -->|"Workspace filesystem"| FS["Workspace storage"]
    SP -->|"Provider–Runtime"| Env
    Core <-->|"Core–Runtime"| Env["Environment:<br/>Runtime + Harness"]
    Env -->|"Harness–Model provider"| Model["Model provider"]

Runtime daemon 主动向 Core 发起经过认证的 WebSocket 连接。API 命名空间和凭据 说明应用、运维和机器命名空间;协议边界 列出各协议的代码和所属文档。

组件职责 ​

组件职责参考
Core认证调用方,解析并冻结配置,调度 Turn,处理取消和待处理交互,将资源与执行事实持久化到 PostgreSQLCore 服务
沙箱提供商创建、观察、续期和回收计算资源;提供 Runtime 启动输入沙箱提供商协议、Runtime 引导
Workspace filesystem adapter创建、观察和删除 Environment 持久存储;验证并解析计算资源所需的挂载工作区文件系统协议
Sandbox node运行 microsandbox 主机,协调分配给它的 generation 与 allocationSandbox node 协议
Runtime准备工作区和能力,管理 Session Executor,执行 Turn 并报告事件与回执Core–Runtime 协议
Harness adapter验证原生配置,调用上游 SDK 或协议,转换事件并确认原生清理完成Harness 协议
模型提供商提供 Harness 选定的模型协议模型执行
Web让管理员通过服务端 Core API 连接配置与观察安装实例控制台服务端

Harness 负责原生 Agent loop 和上下文管理。应用负责业务工作流、Reviewer 策略和质量评估;这些能力不会成为 Core 执行路径。

仓库地图 标出这些组件的位置。概念 解释项目边界、管理员权限和工具隔离。

Session 的完整流程 ​

应用通过 Agents API 创建 Session,Core 解析其配置与执行位置。托管 Session 通过选定的沙箱提供商获取计算资源。自托管 Session 等待用户运行安装命令,由该命令代替步骤 2 和 3 启动 Runtime。environment: none 的 Session 使用已连接的执行设备,不提供工作区。应用指南 说明这些选项。

%%{init: {"sequence": {"actorMargin": 16, "width": 100}}}%%
sequenceDiagram
    autonumber
    participant App as Application
    participant Core
    participant P as Sandbox Provider
    participant R as Runtime
    participant H as Harness
    App->>Core: Create Session
    Core->>P: Create(Bootstrap)
    P->>R: Start Runtime
    R->>Core: Connect, heartbeat
    Core->>R: runtime_prepare
    R-->>Core: prepare result
    App->>Core: Send input
    Core->>R: execution_prepare
    R-->>Core: status ready
    Core->>R: execution_start
    R->>H: Run the Turn
    H-->>R: Native events
    R-->>Core: delta, tool_call, done
    Core-->>App: Stream events

daemon 连接后,Core 检查可用 Harness 和请求的能力。Runtime 准备工作区 Environment 及其能力快照,然后准备或复用 Session Executor。Core 持久化输出、工具交互和回执,供应用读取和接收事件。完成或取消使 Turn 结算;健康的 Executor 可以在同一 Environment 中执行下一个 Turn。

检查点生命周期负责空闲准入、唤醒与保留规则,检查点转移定义共享存储和兼容性要求。

工作区文件系统契约 负责持久存储保留及显式删除规则;计算快照到期不授权回收工作区存储。Environment 契约 负责准备规则,Core–Runtime 协议 负责顺序、回执和故障处理。

基于 MIT 许可证发布。© 2026 MiniMax-AI