发布子任务文件产物¶
将当前受管子任务生成的文件保存到所属用户的聊天文件卷,并发布任务产物。
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 |
是 |
非空文件,单个文件最多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"
}
字段/响应项 |
类型 |
说明 |
|---|---|---|
|
string |
用于文件读取的ID。 |
|
string |
保存的文件名。 |
|
integer |
文件字节数。 |
|
string |
内容MD5。 |
|
string |
任务产物ID,与file_id分开。 |
|
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、机器码与实际诊断,不套其他文件协议错误包。