查询技能候选的保存与绑定状态¶
读取已审阅候选是否保存,以及在可绑定的同工作区目标智能体中是否找到该技能。返回技能ID不等于已经保存。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/skills/confirmation
调用前准备¶
已有来源可信的结构化技能候选,并已审阅其指令和文件。使用候选原task_id/call_id/source_digest;目标工作区、当前主体与原运行须匹配。不能用聊天自然语言、手工拼接的display或另一任务的候选代替。来源与权限细节见候选身份。
请求参数¶
curl --get "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/skills/confirmation" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--data-urlencode "call_id=$CALL_ID" --data-urlencode "source_digest=$SOURCE_DIGEST"
参数 |
类型 |
必填 |
说明 |
|---|---|---|---|
|
string |
是 |
目标工作区,与X-Workspace-ID一致。 |
|
string |
是 |
产生候选的原运行任务ID,不是自动化任务定义或技能ID。 |
|
string |
是 |
当前环境目标工作区。 |
|
string |
是 |
本页示例使用的个人访问令牌,还须通过当前工作区访问与候选归属检查。 |
|
string |
是 |
原Skill Creator工具调用标识,放在查询参数中。 |
|
string |
是 |
服务端候选返回的完整摘要,原样使用;放在查询参数中。 |
返回结果¶
{
"code": 0,
"data": {
"skill_id": "skill-example",
"workspace_id": "ws-example",
"agent_id": "agent-example",
"saved": false,
"bound": false
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0。 |
|
string |
该候选对应的技能标识。GET在未保存时也会返回预留ID。 |
|
string |
技能保存所在工作区。 |
|
string |
原候选所属的目标智能体,不是操作者。 |
|
boolean |
是否找到与该候选内容及创建者一致的已保存技能。 |
|
boolean |
当前可绑定的同工作区目标中,是否找到该技能绑定;不是全局绑定查询。 |
判断结果¶
saved=false时不要仅凭skill_id读取或使用技能;saved=true、bound=false表示在本次回查范围内已保存但未见绑定。对于跨工作区或系统来源,候选不能绑定当前目标,GET不会跨该范围证明其他智能体无绑定。GET自身不导入技能或修补绑定。