帮你快速理解、总结文档立即下载
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>开发者参考>V3 版本>HTTP>Skills>从对话提取 Skill

从对话提取 Skill

最近更新时间：2026-09-23 21:01:02
我的收藏

本页目录：

接口介绍

本接口（/v3/skill/extract）用于从对话记录中异步提取并生成 Skill。功能说明如下：
异步提取：系统自动从对话中提炼可复用的知识或技巧，提交后立即返回任务信息，后台异步完成提取。
对话来源：通过 messages 参数传入对话内容。
触发原因：通过 reason 参数标记本次提取的触发原因。

Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/skill/extract

使用示例

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/extract \\
  -d '{
    "messages":[
      {"role":"user","content":"Python 中如何使用 type hints？"},
      {"role":"assistant","content":"Python 3.5+ 支持 type hints..."}
    ],
    "reason":"tool_calls"
  }'

请求参数

Body 参数

参数
是否必选
参数含义
配置方法及要求
messages
是
对话记录列表，每条含 role 和 content。
数据类型：Array of Object。
session_id
否
会话 ID。
数据类型：String。
reason
否
触发提取的原因。
数据类型：String。
取值范围：tool_calls、bytes、compressed、oversize。
options
否
额外的提取配置选项。
数据类型：Object。
space_id
否
实例 ID。不传时使用 x-tdai-service-id 头的值。
数据类型：String。
team_id
否
团队 ID，覆盖鉴权凭证中的默认值。
数据类型：String。
agent_id
否
Agent ID，覆盖鉴权凭证中的默认值。
数据类型：String。
user_id
否
用户 ID，覆盖鉴权凭证中的默认值。
数据类型：String。
task_id
否
Task ID，覆盖鉴权凭证中的默认值。
数据类型：String。

响应示例

{
  "code":0,
  "message":"ok",
  "request_id":"req-vwx234",
  "data":{
    "ok":true,
    "task_id":"task-abc123",
    "archived_at_ms":1723968000000,
    "archive_key":"archive/team-abc123/agt-xyz789/1723968000000"
  }
}

响应参数说明

参数名（一级）
参数名（二级）
参数含义
data
ok
操作是否成功。
task_id
异步任务 ID。
archived_at_ms
归档时间，Unix 时间戳，单位为毫秒。
archive_key
归档存储键值。

错误码

HTTP 状态码
错误信息
说明
400
request: Invalid input
请求参数不合法，如 messages 为空。
401
Missing or invalid Authorization header
Bearer API Key 缺失或格式不正确。
422
Schema validation failed
消息格式错误，确保每条消息含 role 和 content。
500
Internal error
服务内部错误，可有限重试。
中国站