工作项服务

工作项服务 将系统算子或自定义算子发布为同步 HTTP 服务:调用方按算子签名提交输入和参数,并在同一请求中取得结果。它适合短时原子处理;多节点、长时间、需要作业记录的处理应使用工作流。

当前 SDK 边界

官方 Python 和 Go SDK 当前都没有以下公开方法或类型:

  • 查询 WorkItem 及输入输出签名;

  • 创建、更新、启用或停用算子 API Service;

  • 获取已发布服务的端点和架构;

  • 调用任意 WorkItem 服务。

因此本页不提供虚构的 SDK 请求体或端点。发布应在 Catalog 的算子详情页完成,或使用目标 MOI 实例明确发布的 Product API。服务 URL 与输入输出字段因算子和部署而异,必须从发布后的 API Service 详情取得。

发布与调用检查

无论使用 UI 还是受支持的 Product API,都应确认:

  1. 固定通过测试的算子版本;

  2. 非模型算子绑定可用的任务计算资源;

  3. 认证、调用频率、超时和并发限制符合生产要求;

  4. 调用方按服务生成的 schema 校验必填项和类型;

  5. 算子存在写入副作用时,用业务请求 ID 去重;

  6. 升级版本前回归输入、输出、默认值和错误处理。

API Key 或 OAuth 凭据不能写入工作流定义、模板或日志。公共访问只适用于已评估数据暴露和滥用风险的场景。

当 SDK 增加正式的 WorkItem Service 客户端后,应以其公开类型为准;不要使用 RawClient 的内部通用 HTTP 方法绕过缺失的能力。