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

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

读取已审阅候选是否保存，以及在可绑定的同工作区目标智能体中是否找到该技能。返回技能ID不等于已经保存。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/skills/confirmation
```

## 调用前准备

已有来源可信的结构化技能候选，并已审阅其指令和文件。使用候选原task_id/call_id/source_digest；目标工作区、当前主体与原运行须匹配。不能用聊天自然语言、手工拼接的display或另一任务的候选代替。来源与权限细节见[候选身份](candidate-identity.md)。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `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 | 是 | 服务端候选返回的完整摘要，原样使用；放在查询参数中。 |

:::::
::::::
:::::::

## 返回结果

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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自身不导入技能或修补绑定。

参见[保存、绑定与恢复](save-bind-recovery.md)、[实际错误与环境](errors-environments.md)和[AI Studio](../../../../../../developer/api/ai-studio/index.md)。
