sprites,资源是 Sprite,不使用 Machines 的 App、机器镜像和网络配置。当前 Sprites 连接器不声明 OCI 或网络 allowlist。
配置与验证
准备有目标 Sprite 账户访问权限的 Token,通过连接 credential 提交。Token 只保留在控制平面。下面使用本地管理客户端;hosted 初始化见自托管。SPRITES_TOKEN 是本例读取的私有环境变量名,不是给 Agent 注入的变量。
配置采用 cpus,不是其他 Provider 的 cpu;额外字段不接受。实际账户配额需另行确认。
首次任务与私有访问
使用返回的 connection.id 作为首个 Session的 sandbox_connection_id,搭配兼容模型与 Harness,完成任务、文件产物和关闭流程。Python 与 TypeScript 独立验证,不从一个客户端成功推断另一个。 Sprite 创建时使用auth: sprite。Hexagon 的私有传输通过已鉴权的执行通道连接远程端口,Provider Token 不交给用户浏览器。预览通过平台授权入口访问;如果资源的 URL 配置不再私有,连接器会拒绝。不要把供应商裸 URL 当成稳定的应用分享地址。
预览打不开时分别检查用户服务端口、Sprite 私有配置、传输和 Runtime 健康。普通应用进程退出不会通过创建另一个 Sprite 自动修好。
持久工作区与 standby
当前受管理根目录为/home/sprite/.hexagon,Runtime 和 Harness 的工作区与恢复数据由平台管理。持久文件不等于任意进程或连接永久存活;不要对工作区外的临时路径作同样保留假设。
Provider 的 standby 可能早于平台 idle_timeout。下一次提交仍使用原 Session,平台在尚未开始的新调用前准备 Runtime。已持久化的活动调用不能因为唤醒而重新执行;等待授权或审批也不属于可以安全重放的任务。
后台命令使用有期限的独立执行,不注册成唤醒时自动重放的服务。你的预览服务可能需要明确重启;先确认旧实例状态,避免重复启动产生副作用。Provider 自动 standby 不等于平台确认暂停,等待一段时间也不是计算或账单状态的证据。
单独验证下一轮
先让第一轮在工作区写入一个已知文件并记录对话中的测试值。等待目标空闲条件后,向同一 Session 提交第二轮,要求读取文件并引用先前测试值,同时检查实际工具输出、Run 终态和会话继续。需要预览的应用还要重新检查服务。 必须记录等待条件、Harness 版本、模型协议和两套 SDK 的独立结果。文件仍在并不能证明对话继续;第二轮成功也不能证明 Provider 曾进入计费意义上的待机状态。参考空闲与唤醒。到期、关闭与对账
当前期限由控制平面持久生命周期处理,Sprite 睡眠不是删除。控制平面停机会影响及时到期清理;仅结束本地服务不释放云资源。关闭 Session 后确认对应 Sprite 不存在,同时确认历史产物仍可读取。 创建名称由持久 operation ID 派生,丢失创建响应时按原名字查找。连接器只把 Provider 404 当作不存在;网络故障或鉴权失败必须保留不确定结果。删除请求之后仍能查询到资源时,清理未确认,不应报告成功。 常见问题:401/403 检查 Token 权限;创建失败检查资源规格与额度;非零命令退出检查原执行输出;后台启动未知检查启动标记与 Runtime 健康;删除不确认保留原资源 ID 并对账。 本页核对了配置与实现,未新增实云验证。历史单轮与完整旅程见扩展矩阵,恢复范围见Harness serverless 矩阵,不能将旧文档中的未验证状态或成功状态无限外推。 依据:Sprites 连接器、私有传输。下一步:Sandbox 对比、持久化边界。分开判断单轮、接续与待机证据
扩展记录中的早期可用性和传输探针发生在完整连接器旅程之前。其限制是历史发现,不能据此抹去后续限定范围的通过结果,也不能把所有传输扩展标成支持。内部私有执行通道与公开预览契约同样不同:内部通道能传 HTTP,不会增加浏览器 WebSocket 支持。
如果新一轮能读取项目而预览失败,先检查服务进程,不直接替换 Session。Runtime 存在中断 invocation 时,启动其他进程前先调查。文件持久化或资源睡眠都不构成安全重放外部副作用的授权。
依据:Serverless 契约。下一步:空闲与唤醒、独立的 Fly Machines 集成、资源对账。