解析智能体产物文件引用¶
将产物ID和版本解析成当前可访问的文件与挂载标识。
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-artifacts/resolve
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
请求¶
curl --request POST \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-artifacts/resolve" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"items":[{"artifact_id":"artifact-example","version":1},{"artifact_id":"artifact-unavailable","version":1}]}'
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前环境工作区ID。 |
|
请求体 |
array(引用数组) |
否 |
要解析的版本引用;省略/null/空数组不选择任何产物。 |
|
请求体 |
string |
是 |
产物ID。 |
|
请求体 |
integer |
是 |
正整数版本。 |
结果用于取得当前文件/卷/挂载标识,再调用对应文件接口;不会生成内容、重新运行任务或修复产物。HTTP200仍可能包含failed。本接口未核实与删除相同的100项限制,不能机械套用。
成功响应¶
{
"code": 0,
"data": {
"items": [
{
"artifact_id": "artifact-example",
"version": 1,
"file_id": "file-example",
"volume_id": 10,
"placement_id": 23,
"file_name": "summary.txt",
"content_type": "text/plain",
"size": 128,
"status": "completed"
}
],
"failed": [
{
"artifact_id": "artifact-unavailable",
"version": 1,
"reason": "not_found"
}
]
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0;批量动作仍需检查逐项结果。 |
|
object |
错误响应¶
错误与结果确认区分整体失败、逐项失败与来源不可见。
最后更新于