确认保存技能候选

将服务端保存的技能候选导入当前工作区,并按显式选择尝试添加到候选所属智能体。保存与绑定不在同一个事务阶段。

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}'

参数

类型

必填

说明

workspace_id

string

是

目标工作区,与X-Workspace-ID一致。

task_id

string

是

产生候选的原运行任务ID,不是自动化任务定义或技能ID。

X-Workspace-ID

string

是

当前环境目标工作区。

X-API-Key

string

是

本页示例使用的个人访问令牌,还须通过当前工作区访问与候选归属检查。

call_id

string

是

原Skill Creator工具调用标识,放在JSON请求体中。

source_digest

string

是

服务端候选返回的完整摘要,原样使用;放在JSON请求体中。

bind_current

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
  }
}

字段

类型

说明

code

integer

成功为0。

data.skill_id

string

该候选对应的技能标识。GET在未保存时也会返回预留ID。

data.workspace_id

string

技能保存所在工作区。

data.agent_id

string

原候选所属的目标智能体,不是操作者。

data.bound

boolean

本次是否完成了请求的绑定步骤。bind_current=false时返回false,不表示已有绑定被解除;当前状态用GET回查。

判断结果

bind_current=false不会解绑已有技能;需要当前绑定事实时回查GET。bind_current=true可能在技能已经保存后发生绑定失败,错误不代表保存被回滚。包管理智能体的绑定还可能通过新版本包加载完成,不能当成只写一条绑定引用。

参见保存、绑定与恢复、实际错误与环境和AI Studio。

最后更新于