查询技能候选的保存与绑定状态

读取已审阅候选是否保存,以及在可绑定的同工作区目标智能体中是否找到该技能。返回技能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"

参数

类型

必填

说明

workspace_id

string

是

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

task_id

string

是

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

X-Workspace-ID

string

是

当前环境目标工作区。

X-API-Key

string

是

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

call_id

string

是

原Skill Creator工具调用标识,放在查询参数中。

source_digest

string

是

服务端候选返回的完整摘要,原样使用;放在查询参数中。

返回结果

{
  "code": 0,
  "data": {
    "skill_id": "skill-example",
    "workspace_id": "ws-example",
    "agent_id": "agent-example",
    "saved": false,
    "bound": false
  }
}

字段

类型

说明

code

integer

成功为0。

data.skill_id

string

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

data.workspace_id

string

技能保存所在工作区。

data.agent_id

string

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

data.saved

boolean

是否找到与该候选内容及创建者一致的已保存技能。

data.bound

boolean

当前可绑定的同工作区目标中,是否找到该技能绑定;不是全局绑定查询。

判断结果

saved=false时不要仅凭skill_id读取或使用技能;saved=true、bound=false表示在本次回查范围内已保存但未见绑定。对于跨工作区或系统来源,候选不能绑定当前目标,GET不会跨该范围证明其他智能体无绑定。GET自身不导入技能或修补绑定。

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

最后更新于