工作项服务¶
工作项服务 将系统算子或自定义算子发布为同步 HTTP 服务:调用方按算子签名提交输入和参数,并在同一请求中取得结果。它适合短时原子处理;多节点、长时间、需要作业记录的处理应使用工作流。
当前 SDK 边界¶
官方 Python 和 Go SDK 当前都没有以下公开方法或类型:
查询 WorkItem 及输入输出签名;
创建、更新、启用或停用算子 API Service;
获取已发布服务的端点和架构;
调用任意 WorkItem 服务。
因此本页不提供虚构的 SDK 请求体或端点。发布应在 Catalog 的算子详情页完成,或使用目标 MOI 实例明确发布的 Product API。服务 URL 与输入输出字段因算子和部署而异,必须从发布后的 API Service 详情取得。
发布与调用检查¶
无论使用 UI 还是受支持的 Product API,都应确认:
固定通过测试的算子版本;
非模型算子绑定可用的任务计算资源;
认证、调用频率、超时和并发限制符合生产要求;
调用方按服务生成的 schema 校验必填项和类型;
算子存在写入副作用时,用业务请求 ID 去重;
升级版本前回归输入、输出、默认值和错误处理。
API Key 或 OAuth 凭据不能写入工作流定义、模板或日志。公共访问只适用于已评估数据暴露和滥用风险的场景。
当 SDK 增加正式的 WorkItem Service 客户端后,应以其公开类型为准;不要使用 RawClient 的内部通用 HTTP 方法绕过缺失的能力。