Files
orbit/docs/api/workflows.md

1.5 KiB
Raw Blame History

流程接口规划

状态:计划 P4–P5,尚未实现。研发通过 Go SDK 描述流程并显式发布,服务端保存不可变定义版本。

操作 候选接口 完成要求
发布版本 POST /v1/workflow-definitions/{definition_id}/versions 图结构、类型、预算校验;同版本同内容幂等,不同内容冲突
启动实例 POST /v1/workflows 固定版本并幂等启动,首批任务与实例原子创建
查询实例 GET /v1/workflows/{workflow_id} 状态、暂停标记、版本、等待原因、预算摘要
查询步骤 GET /v1/workflows/{workflow_id}/steps 步骤、激活、查询轮次、输入/结果引用与任务关联
提交信号 POST /v1/workflows/{workflow_id}/signals 幂等、授权、业务操作匹配;受理与消费分别可查
暂停/继续 POST /v1/workflows/{workflow_id}:pause、:resume 控制版本与门控原子变化,保留进度、预算与审计
取消 POST /v1/workflows/{workflow_id}:cancel 停止后续工作,收集在途结果,不伪装业务撤销
核查恢复 具体接口待实现阶段冻结 权限、证据、预期版本与稳定操作身份;保留旧激活历史

配套场景:并行生成结果、等待审核信号、外部作业有界查询、暂停与核查恢复。正式示例将在对应 API 和 SDK 通过端到端验证后提供。节点与状态设计见 Weave 功能与设计。