发布子任务文件产物

将当前受管子任务生成的文件保存到所属用户的聊天文件卷,并发布任务产物。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{id}/runtime-artifacts

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

在受管子环境使用MOI_ENDPOINT、MOI_API_KEY、MOI_RUNTIME_AUTHORIZATION和MOI_WORKSPACE_ID同一连接组。BASE_URL取MOI_ENDPOINT、WORKSPACE_ID取MOI_WORKSPACE_ID;MOI_RUNTIME_AUTHORIZATION已经包含Bearer前缀。普通PAT不能代替子任务身份。

请求参数

curl --fail-with-body -sS -X POST "$BASE_URL/workspaces/$WORKSPACE_ID/runtime-artifacts" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -F "file=@$ARTIFACT_FILE"

字段

类型

是否必填

说明

file

file

是

非空文件,单个文件最多32MiB;文件名为不带路径的名称,最多255字节。

只使用当前子环境的一组技术API key、运行证明与工作区,且证明必须允许产物发布。没有该能力的图像分析证明不能代用。先检查agent.use及卷写入权限,再读取上传体;保存时重复写入授权。

成功响应

{
  "file_id": "file-example",
  "original_name": "report.txt",
  "size": 7,
  "md5": "a9346fbaf920e99acc512e8dcc57fa3c",
  "artifact_id": "artifact-example",
  "sha256": "sha256:331d26d6d8f862e46ba900811be8a7a1e4dbaa229b14c99becfd5e5151490d95"
}

字段/响应项

类型

说明

file_id

string

用于文件读取的ID。

original_name

string

保存的文件名。

size

integer

文件字节数。

md5

string

内容MD5。

artifact_id

string

任务产物ID,与file_id分开。

sha256

string

带sha256:前缀的内容摘要。

成功响应没有统一code/data外层;临时文件和图片流直接返回字节。

错误响应

{
  "error_code": "runtime_artifact_upload_denied"
}

HTTP

code/形式

条件

400

数值2/message

路径与唯一工作区请求头不一致。

400

runtime_artifact_file_required

没有可用非空file部分。

400

runtime_artifact_upload_denied

文件名、产物输入或任务不符合发布条件。

403

runtime_artifact_upload_denied

产物能力或授权拒绝。

413

runtime_artifact_upload_denied

超过文件或请求上限。

404

runtime_artifact_upload_denied

必要文件或业务对象不存在。

503

runtime_artifact_upload_unavailable

依赖或发布不可用。

外层身份/任务证明的拒绝还可能先于此handler;保持原始HTTP、机器码与实际诊断,不套其他文件协议错误包。

最后更新于