Only the Chinese version of this page is provided currently. The English version will be provided soon.
Help & Documentation>腾讯云数据库 AI 服务>Memory 应用指南>开发者参考>V3 版本>HTTP>Metadata>Task 管理

Task 管理

Last updated: 2026-09-23 21:01:01

On this page:

接口介绍

Metadata Task 管理接口用于创建、查询、更新、删除、列出和归档 Task 资源。Task 代表 Agent 需要执行的具体任务。共6个接口：
接口
方法
功能
/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

请求示例

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/get \\
  -d '{"task_id":"task-xyz"}'

响应示例

{
  "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 列表

请求示例

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/delete \\
  -d '{"task_ids":["task-xyz"]}'

响应示例

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

响应 data

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

列出 Task

按团队和状态分页查询 Task 列表。
POST /v3/task/list

请求参数

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

请求示例

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/list \\
  -d '{"team_id":"team-abc"}'

响应示例

{
  "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
  }
}

响应 data

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

归档 Task

归档 Task（软删除，可恢复）。
POST /v3/task/archive

请求参数

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

请求示例

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/archive \\
  -d '{"task_id":"task-xyz"}'

响应示例

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

响应 data

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

错误码

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
服务内部错误，可有限重试。
中国站 - English