接口介绍
本接口（
/v3/skill/patch）用于对 Skill 内容执行文本查找替换操作。功能说明如下：字符串替换：通过
old_string 和 new_string 精确定位并替换 Skill 内容中的指定文本片段。乐观锁：需要传入
expected_version（当前版本号），若版本不匹配则操作失败。全量替换：设置
replace_all=true 时可替换所有匹配项，默认仅替换第一个匹配项。版本递增：替换成功后版本号自动递增。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/patch
使用示例
curl -i -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\https://memory.tdai.tencentyun.com/v3/skill/patch \\-d '{"skill_id":"skill-abc123","expected_version":4,"old_string":"# Old Title","new_string":"# New Title"}'
请求参数
Body 参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
skill_id | 是 | Skill ID。 | 数据类型：String。 |
expected_version | 是 | 期望的当前版本号，用于乐观锁校验。 | 数据类型：Integer。 |
old_string | 是 | 要查找的原始文本。 | 数据类型：String。 |
new_string | 是 | 替换后的新文本。 | 数据类型：String。 |
replace_all | 否 | 是否替换所有匹配项。 | 数据类型：Boolean。默认 false，仅替换第一个匹配项。 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
task_id | 否 | 任务 ID。 | 数据类型：String。 |
响应示例
{"code":0,"message":"ok","request_id":"req-efg123","data":{"skill_id":"skill-abc123","version":5}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | skill_id | Skill ID。 |
| version | 更新后的版本号。 |
错误码
HTTP 状态码 | 错误信息 | 说明 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
404 | SKILL_NOT_FOUND | Skill 不存在或 old_string 未匹配到内容。 |
409 | VERSION_CONFLICT | 版本冲突， expected_version 与当前版本不匹配。 |
500 | Internal error | 服务内部错误，可有限重试。 |
