gongzhiyong
d5e95fa97b
- §5.0.1：部署、SK 快照、Git/制品只读、刷新与禁止项 - 术语：子 agent 为 Agnet 平台内；README/M3 引用更新 Made-with: Cursor
1.8 KiB
1.8 KiB
M3 · Agnet 编排桥接（执行单元生命周期）
目标
Agnet 平台按约定 API 向 Heicode 暴露：编队部署、执行单元状态、任务回写 能力；Heicode Manager / 客户端可将编排动作纳入同一身份与审计链路。
完成定义（DoD）
- Agnet 侧实现集成文档中 编排控制面 最小集（部署/伸缩/停止编队或等价操作）；与 Heicode Manager 一键部署 Agnet 团队 能力对齐（§5.0：成员、成员模型、子 Agnet 绑定
sk_file_refs）。 - SK 边界：子 Agnet 仅按绑定 只读 SK；SK 正文编辑 仅 经 Heicode，Manager/Agnet 无写入口（集成文档 §5.0、§3.2）。
- 回调/Webhook：执行单元状态变更可推送到 Heicode 可订阅地址（或 Manager 注册 webhook URL）。
- 幂等与关联 ID：每次部署生成全局唯一的
deployment_id，与 Heicode 侧correlation_id可互查。 - 失败语义：超时、部分就绪、不可调度等状态码与可重试策略文档化。
- 联调环境：至少一套非生产 Agnet 与 Heicode 对打成功（见集成文档验收用例）。
依赖
- M1
- M2（可用 Mock 缩短并行时间，但上线前需真实联调）
- 阅读
../integration/agnet-platform-api-design.md第 3～6 节（含 §5.0）
与 Agnet 的衔接
- 本里程碑直接消费 部署类 API、Agent 实例 CRUD 语义、事件订阅（见集成文档）。
验收建议
- 表格化测试用例：部署成功、部署失败回滚、并发部署隔离（与 M4 交叉验证）。
风险
- Agnet 若尚未稳定 deployment_id → 实例列表 映射，会导致 Heicode 客户端「状态面板」空洞（转入 M5）。