用途:面向 acomo 平台使用者(在 acomo 上使用工作流模型进行开发的开发者),指导 acomo CLI 与公开 API 的标准用法,不覆盖 acomo 本体内部实现。
主要能力:模型相关操作包括 listWorkflowModels(模型列表)、getWorkflowModel --modelId <ID>(获取模型定义)、getWorkflowModelWithLatestModelHistory(获取编辑中模型);流程相关操作包括 startWorkflowProcess、saveWorkflowProcess、submitWorkflowProcess、submitWorkflowProcessWithNodeId、approveWorkflowProcess、rejectWorkflowProcess、revertWorkflowProcess,以及查看自己的流程 listMyProcesses / listProcessWithNodeActions、getMyProcesses / getProcessWithNodeActions。
调用方式:格式为 acomo <operationId> [--option value...] [body-json]。path/query 参数用 --name value,请求体用位置参数 JSON 字符串或 stdin。CLI 输出为 JSON,参数可用 acomo <operationId> --help 查看,全部命令见 acomo --help。
认证:本地可用 acomo login 保存到 ~/.acomo/config.json;CI 与智能体环境建议使用环境变量 ACOMO_ACCESS_TOKEN、ACOMO_TENANT_ID(必填),ACOMO_BASE_URL 可选,默认 https://acomo.app。未认证时 API 命令仍存在,但会以退出码 2 和 stderr 的 AUTH_REQUIRED 失败,此时应提示用户重新登录或设置环境变量,不要反复试错。
使用注意:流程操作中,任务节点数据按 dataSchema 通过 saveWorkflowProcess 的 body 中 data 字段提交,状态变更由 submit / approve / reject / revert 触发;应遵循 policy 的 write/read 权限,只处理当前节点可编辑项。
dataSchema、policy、definition 与条件式等数据结构细节参见 reference.md。远程沙箱等环境可能不会自动继承本地 ~/.acomo/config.json 或环境变量,CI 与智能体执行时需显式配置。
限制:只面向平台使用者,不涉及 acomo 本体内部实现;其余未在资料中说明的内容暂未提供。