跳转到主要内容
Hexagon 把持久任务管理和云端进程执行分开。理解这个边界,可以判断故障应该在哪一层调查,也能避免扩展时让不同 Provider 的逻辑侵入应用接口。

责任分工

Console 消费同一控制平面 API。它配置、观察和管理工作,不是另一套独立执行后端。关闭 Console 不会关闭后台任务。

一次任务的顺序

工具可能进入授权或审批等待,云操作可能进入未知状态,因此实际流程包含暂停观察和对账分支。图示不是“每个远程请求一定收到响应”的承诺。

沿同一个项目任务理解边界

假设你的后端要求 Agent 为上传的项目添加筛选功能、运行测试并导出修改后的文件。业务请求及其与用户的关联由应用后端负责;Session 和 Run 记录由控制平面负责;工作文件与进程位于云 Sandbox;Runtime 监督 Harness,Harness 决定如何执行任务。 箭头表达职责和数据流,不代表只有一个监听端口或一条网络连接。控制平面的管理 API、受保护凭据入口、私有 Runtime 访问分别有自己的鉴权和可达性要求。Provider connector 运行在控制平面侧,不是 guest 中的 Agent 进程。 对这个任务而言,模型响应成功只是一项观察结果。Harness 仍需完成执行,worker 还要解释输出、捕获导出产物,之后才能完成 Run。当前产物实现将元数据和字节保存到 PostgreSQL。未导出的工作区文件受所选 Sandbox 的持久化行为约束。关闭 Session 会清理云资源,保留的 Run 记录和已导出产物仍可查询。

两种部署位置,相同的执行边界

本地控制平面

SDK 支持的本地发现机制用于找到本地工作区端点和客户端凭据,guest 仍在云中运行。电脑上的 loopback 管理地址不是云端可达的凭据入口:需要为选定执行路径配置独立的开发入口。停止本地控制平面会停止它的 worker 和对账流程,但不能据此证明远程进程或资源都已停止。

托管控制平面

hosted 改变控制平面和持久服务的运行位置,不会把 Harness 执行移到 API 服务器。应用后端仍需校验业务用户权限并保护控制平面 Token。两种部署都需要受支持的 Sandbox/Harness/模型组合;图示不代表目录中的每一项都通过了同样的真实云旅程。

资源与凭据分别归谁管理

模型流量经过受保护凭据通道,Harness 仍需选择兼容的模型协议。访问后端不转换协议,也不判断任务是否成功。broker 管理的 Tools 走另一条路径:Harness 经 Runtime bridge 提交请求,worker 请求控制平面 broker 完成授权/审批/派发,再经 bridge 返回结果。即使 Agent 看不到原始凭据,获准的外部写入仍可能发生。 这里描述的是 Hexagon 管理的连接和 broker 管理的 Tools。任务代码执行的原生 shell 命令和网络请求还受 Sandbox/网络配置边界约束,不能假设任意命令都会被拦截并要求人工审批。委托权限、registry 鉴权与普通变量的区别见凭据与信任边界。

用边界定位故障

应用断流:先恢复原 Run 的观察。worker 重启:观察持久 lease 和执行恢复。Runtime 不可达:不能推断进程停止。Provider 删除响应丢失:查原操作和资源 ID。模型协议失败:查 Harness 与端点兼容性,而不是更换业务 Session ID 掩盖问题。 读完后,你应能从业务请求追踪到云端执行,指出每类凭据由谁持有,并解释为什么客户端断开不等于取消。下一步:持久事件与恢复、信任边界或贡献者代码地图。 依据:实现架构、执行 worker、Runtime supervisor、访问授权、Tool broker、产物存储。