开发文档 · API 与协议参考

Control Protocol

基于对象期望态进行幂等协调和例外处理的 Proposed 设计。

成熟度:Proposed

Control Protocol 的目标是读取 Object 与外部世界,将当前态收束到期望态,并记录需要人工处理的例外。统一控制协议尚未实施,不提供生产 API、控制器 SDK 或部署步骤。

设计职责

未来协调循环应先读取 Object:目标已满足则安静退出;存在固定 runbook 时优先执行;必要时才请求 Runtime 启动 Run,或经 Host 授权调用宿主能力。重复事件和重试不得产生重复副作用。

信任边界

Control 不能自行提升权限、创建沙箱或绕过 Host Consent。它只能使用 Object、Runtime 和 Host 的公开契约,并受 Management 策略约束。异常、缺权限和不可恢复失败应进入显式例外路径,而不是靠隐藏聊天消解。

版本边界

Control 与 Object、Runtime 分别版本化。reconcile 输入、决策、动作、退避、幂等和例外 Schema 在实现及 conformance 完成前均未冻结;本文不定义任何可调用端点。

当前可用与过渡

Trigger、Flow / Case、Schedules 或局部自动化可提供部分机制,但不等于统一 Control Protocol。当前开发者应使用各功能已有文档和接口,不把私有状态当作 Control 真相。

相关文档