接口介绍
本接口（
/v3/skill/conversation_add）用于提交对话记录并触发 Skill 的异步自动提取。功能说明如下：异步处理：接口立即返回，后台自动分析对话并提取可复用的 Skill。
自动学习：系统智能判断对话中是否包含可提取的 Skill，无需手动指定。
批量提交：一次可提交多轮对话。
注意：
本接口的
team_id、user_id、agent_id 为服务端必填字段，不可省略。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/conversation_add
使用示例
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/conversation_add \\-d '{"team_id":"team-abc123","agent_id":"agt-xyz789","user_id":"usr-456","messages":[{"role":"user","content":"怎样在 Docker 中配置多阶段构建？"},{"role":"assistant","content":"多阶段构建可以减少镜像体积..."}]}'
请求参数
Body 参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
messages | 是 | 对话记录列表，每条含 role 和 content。 | 数据类型：Array of Object。 |
team_id | 是 | 团队 ID。 | 数据类型：String。 |
agent_id | 是 | Agent ID。 | 数据类型：String。 |
user_id | 是 | 用户 ID。 | 数据类型：String。 |
space_id | 否 | 实例 ID。不传时使用 x-tdai-service-id 头的值。 | 数据类型：String。 |
task_id | 否 | 任务 ID。 | 数据类型：String。 |
响应示例
{"code":0,"message":"ok","request_id":"req-yza567","data":{"status":"accepted"}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | status | 提交状态， accepted 表示已接收并进入后台处理队列。 |
错误码
HTTP 状态码 | 错误信息 | 说明 |
400 | request: Invalid input | 请求参数不合法，如 messages 为空。 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
422 | Schema validation failed | 消息格式错误，确保每条消息含 role 和 content。 |
500 | Internal error | 服务内部错误，可有限重试。 |
