确认保存技能候选¶
将服务端保存的技能候选导入当前工作区,并按显式选择尝试添加到候选所属智能体。保存与绑定不在同一个事务阶段。
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/skills/confirm
调用前准备¶
已有来源可信的结构化技能候选,并已审阅其指令和文件。使用候选原task_id/call_id/source_digest;目标工作区、当前主体与原运行须匹配。不能用聊天自然语言、手工拼接的display或另一任务的候选代替。来源与权限细节见候选身份。
请求参数¶
curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/skills/confirm" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
--data '{"call_id":"<candidate-call-id>","source_digest":"<candidate-source-digest>","bind_current":false}'
参数 |
类型 |
必填 |
说明 |
|---|---|---|---|
|
string |
是 |
目标工作区,与X-Workspace-ID一致。 |
|
string |
是 |
产生候选的原运行任务ID,不是自动化任务定义或技能ID。 |
|
string |
是 |
当前环境目标工作区。 |
|
string |
是 |
本页示例使用的个人访问令牌,还须通过当前工作区访问与候选归属检查。 |
|
string |
是 |
原Skill Creator工具调用标识,放在JSON请求体中。 |
|
string |
是 |
服务端候选返回的完整摘要,原样使用;放在JSON请求体中。 |
|
boolean |
是 |
false只保存,true保存后尝试绑定候选所属智能体;必须显式发送,不能省略、传null或字符串。 |
仅提交call_id/source_digest/bind_current三个body键,不发送display、目标agent_id或文件内容。替换示例两个候选占位值后调用。
返回结果¶
{
"code": 0,
"data": {
"skill_id": "skill-example",
"workspace_id": "ws-example",
"agent_id": "agent-example",
"bound": false
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0。 |
|
string |
该候选对应的技能标识。GET在未保存时也会返回预留ID。 |
|
string |
技能保存所在工作区。 |
|
string |
原候选所属的目标智能体,不是操作者。 |
|
boolean |
本次是否完成了请求的绑定步骤。bind_current=false时返回false,不表示已有绑定被解除;当前状态用GET回查。 |
判断结果¶
bind_current=false不会解绑已有技能;需要当前绑定事实时回查GET。bind_current=true可能在技能已经保存后发生绑定失败,错误不代表保存被回滚。包管理智能体的绑定还可能通过新版本包加载完成,不能当成只写一条绑定引用。