回填历史智能体产物¶
从符合来源条件的已有文件补建缺失的智能体产物记录。
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-artifacts/backfill
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
请求¶
curl --request POST \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-artifacts/backfill" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"dry_run":true,"limit":200}'
确认写入后的执行示例:
curl --request POST \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-artifacts/backfill" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"dry_run":false,"limit":200}'
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前环境工作区ID。 |
|
请求体 |
boolean |
否 |
默认false,会执行写入;true只统计候选。 |
|
请求体 |
integer |
否 |
默认200;0也按200,允许最大1000,负数或超过1000拒绝。 |
先运行dry_run=true检查候选。只有确认要写入时才运行false示例;空对象、JSON null、无请求体或Content-Length为0时使用false;长度未知的空请求体可在绑定时被拒绝。dry-run的skipped等于扫描候选数,不能解释为全部记录本来就存在。回填不重新执行智能体或恢复已丢失文件。
成功响应¶
{
"code": 0,
"data": {
"scanned": 1,
"inserted": 0,
"skipped": 1,
"failed": 0,
"dry_run": true
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0;批量动作仍需检查逐项结果。 |
|
object |
错误响应¶
错误与结果确认区分整体失败、逐项失败与来源不可见。
最后更新于