# 确认保存技能候选

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

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

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

## 调用前准备

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

## 请求参数

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

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

:::::
:::::{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工具调用标识，放在JSON请求体中。 |
| `source_digest` | string | 是 | 服务端候选返回的完整摘要，原样使用；放在JSON请求体中。 |
| `bind_current` | boolean | 是 | false只保存，true保存后尝试绑定候选所属智能体；必须显式发送，不能省略、传null或字符串。 |

仅提交call_id/source_digest/bind_current三个body键，不发送display、目标agent_id或文件内容。替换示例两个候选占位值后调用。

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

## 返回结果

:::::::{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",
    "bound": false
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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可能在技能已经保存后发生绑定失败，错误不代表保存被回滚。包管理智能体的绑定还可能通过新版本包加载完成，不能当成只写一条绑定引用。

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