腾讯云数据库 AI 服务 Task 管理

一、接口介绍

接口	方法	功能
/v3/task/create	POST	创建 Task
/v3/task/get	POST	获取 Task 信息
/v3/task/update	POST	更新 Task
/v3/task/delete	POST	批量删除 Task
/v3/task/list	POST	列出 Task
/v3/task/archive	POST	归档 Task

二、创建 Task

创建一个新 Task，指定名称和所属团队。

POST /v3/task/create

三、请求参数

字段	类型	必选	说明
name	string	是	Task 名称
team_id	string	是	所属团队 ID
description	string	否	Task 描述
metadata	object	否	自定义元数据

四、请求示例

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/task/create \\ -d '{"name":"Q3 数据分析","team_id":"team-abc"}'

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "task_id":"task-xyz", "name":"Q3 数据分析", "team_id":"team-abc", "created_at_ms":1758096000000 }}

六、响应 data

字段	类型	说明
task_id	string	新创建的 Task 唯一标识 ID
name	string	Task 名称
team_id	string	所属团队 ID
created_at_ms	int	创建时间

七、获取 Task 信息

按 Task ID 查询详细信息。

POST /v3/task/get

八、请求参数

字段	类型	必选	说明
task_id	string	是	Task ID

九、请求示例

十、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "task_id":"task-xyz", "name":"Q3 数据分析", "team_id":"team-abc", "status":"active", "created_at_ms":1758096000000, "updated_at_ms":1758182400000 }}

十一、响应 data

字段	类型	说明
task_id	string	Task ID
name	string	Task 名称
team_id	string	所属团队 ID
status	string	Task 状态（active/archived/completed）
created_at_ms	int	创建时间
updated_at_ms	int	最后更新时间

十二、更新 Task

更新 Task 属性。

POST /v3/task/update

十三、请求参数

字段	类型	必选	说明
task_id	string	是	待更新的 Task ID
name	string	否	更新后的名称
description	string	否	更新后的描述
status	string	否	更新后的状态

十四、请求示例

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/task/update \\ -d '{"task_id":"task-xyz","status":"completed"}'

十五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "task_id":"task-xyz", "updated_at_ms":1758268800000 }}

十六、响应 data

字段	类型	说明
task_id	string	已更新的 Task ID
updated_at_ms	int	最后更新时间

十七、批量删除 Task

批量硬删除 Task，操作不可恢复。

POST /v3/task/delete

十八、请求参数

字段	类型	必选	说明
task_ids	string[]	是	待删除的 Task ID 列表

十九、请求示例

20、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "deleted":true }}

21、响应 data

字段	类型	说明
deleted	bool	删除是否成功

22、列出 Task

按团队和状态分页查询 Task 列表。

POST /v3/task/list

23、请求参数

字段	类型	必选	说明
team_id	string	否	按团队 ID 筛选
status	string	否	按状态筛选
limit	int	否	每页返回数量
offset	int	否	分页偏移量

24、请求示例

25、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "task_id":"task-xyz", "name":"Q3 数据分析", "team_id":"team-abc", "status":"active", "created_at_ms":1758096000000 }, { "task_id":"task-abc", "name":"用户画像构建", "team_id":"team-abc", "status":"completed", "created_at_ms":1758182400000 } ], "total":2 }}

26、响应 data

字段	类型	说明
items	array	Task 列表
total	int	符合条件的 Task 总数

27、归档 Task

归档 Task（软删除，可恢复）。

POST /v3/task/archive

28、请求参数

字段	类型	必选	说明
task_id	string	是	待归档的 Task ID

29、请求示例

30、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "task_id":"task-xyz", "status":"archived", "updated_at_ms":1758268800000 }}

31、响应 data

字段	类型	说明
task_id	string	已归档的 Task ID
status	string	Task 状态，归档后为 archived
updated_at_ms	int	最后更新时间

32、错误码

HTTP 状态码	错误信息	说明
400	request: Invalid input	请求参数不合法。
401	Missing or invalid Authorization header	Bearer API Key 缺失或格式不正确。
	Missing x-tdai-service-id header	请求头中未携带 x-tdai-service-id。
404	TASK_NOT_FOUND	指定 Task 不存在。
500	Internal error	服务内部错误，可有限重试。