Skip to content

OpenAgentCore Web

Web 是单个 OpenAgentCore 部署的管理员控制台。管理员用它查看健康状态、容量、用量和失败情况,检查各 Project 的资源与执行历史,并管理 Project、密钥、节点和部署设置。应用不使用 Web;它们通过自己的 Project API 密钥调用 Core 的 Agents API(/v1)。

OpenAgentCore Web 概览

登录 ​

使用部署的 Core 密钥登录;控制台没有用户账号。浏览器只保留会话 cookie,控制台服务器代它向 Core 发送 Core 密钥;登录说明会话有效期。

登录后打开 Overview。仍有未完成步骤时,Getting started 清单引导完成四步,顺序不限:沙箱就绪、默认模型提供商、具有活动密钥的 Project、首个 Session。可从清单启动可选的控制台导览。

控制台页面 ​

分组页面用途
MonitorOverview服务状态、运行中的 Session、沙箱槽位和待处理工作;24 小时 Session 活动;以拓扑展示 Core 与节点,各自提供弹出概览;需要关注的 Session;按 Project 统计的用量
MonitorCore metricsCore 进程:CPU 与常驻内存及其限制、执行槽位与 Turn 队列、已连接守护进程、数据库延迟与连接池、后台任务
MonitorAgent metrics1 小时、6 小时、24 小时或 7 天的请求、错误、耗时、token、模型、工具、Agent 和 API 密钥
MonitorSandbox metrics节点容量及各 Project 的托管 Runtime CPU 与内存
MonitorSession log全部 Session;各 Session 的只读对话、跟踪、Turn 和失败分类原因;自托管 Session 页面还管理执行器凭据并提供主机连接命令
ResourcesAgents、Environment templates、Skills、Files、Vaults检查和允许的删除操作,显示各资源所属 Project 及创建密钥
PlatformProjects and keys创建、重命名和归档 Project;签发与撤销密钥;各 Project 的用量、写入历史和 API 调用方法
PlatformNodes添加、编辑和移除 Docker 或 microsandbox 节点;各节点的就绪状态、容量和分配
PlatformSystem安装的公开地址、API 基础 URL、ID 和源码提交;各 Harness 默认模型;Sandbox configuration;Core 加载的启动设置,只读

缺失数据展示为缺失(—),不会当作零。控制台 API 使用列出各页面读取内容及统计边界。

管理员在此执行的任务 ​

任务位置
为安装设置 HTTPS 地址设置 OAC_PUBLIC_URL,并把反向代理指向 Web;参阅使 Core 可访问
选择沙箱后端(Docker、microsandbox 或 E2B)、规格和 Runtime,或重置后端System → Sandbox configuration;参阅修改沙箱配置
添加或移除执行节点Nodes;参阅节点指南
设置 Harness 默认模型System → Default model configuration;参阅默认模型
创建 Project 并签发 API 密钥Projects and keys;参阅 Project 和 API 密钥
签发、轮换或撤销自托管执行器凭据,或复制安装命令Session log 中的 Session 页面;参阅自托管执行器
删除资源,例如泄露的 Credential资源列表行或资源页面;Files 从 Files 列表删除。适用公开删除规则

安装不创建 Project 或密钥。打开控制台不分配计算资源,也不调用模型,安装可以没有节点。Web 不启动 Session,也不发送输入。归档托管 Session 会请求取消和回收;管理员权限说明管理员能执行与不能执行的操作。

部署的沙箱后端服务托管 Session。应用的 self_hosted Runtime(包括它自己 E2B 账号中的 Runtime)是独立路径,修改沙箱配置不会影响它。

回环公开地址(local_only)使节点和远程应用无法访问 Core。控制台仍可通过自己的地址访问,并展示警告。

更多 ​

OpenAgentCore Web 使用 MIT 许可证。

基于 MIT 许可证发布。