腾讯云数据库 AI 服务从对话提取 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	服务内部错误，可有限重试。

腾讯云数据库 AI 服务 从对话提取 Skill