腾讯云数据库 AI 服务参与日志（Metadata）

一、接口介绍

接口	方法	功能
/v3/participation-log/append	POST	追加参与日志
/v3/participation-log/list	POST	列出参与日志

二、追加参与日志

追加一条参与日志记录。

POST /v3/participation-log/append

三、请求参数

字段	类型	必选	说明
task_id	string	是	Task ID
agent_id	string	是	参与的 Agent ID
event	string	是	事件类型，如 started、completed、failed
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/participation-log/append \\ -d '{"task_id":"task-xyz","agent_id":"agt-abc","event":"completed"}'

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "log_id":"log-001", "task_id":"task-xyz", "agent_id":"agt-abc", "event":"completed", "created_at_ms":1758096000000 }}

六、响应 data

字段	类型	说明
log_id	string	日志唯一标识 ID
task_id	string	Task ID
agent_id	string	Agent ID
event	string	事件类型
created_at_ms	int	日志创建时间

七、列出参与日志

列出指定 Task 的参与日志。

POST /v3/participation-log/list

八、请求参数

字段	类型	必选	说明
task_id	string	是	Task ID
limit	int	否	每页返回数量
offset	int	否	分页偏移量

九、请求示例

十、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "log_id":"log-001", "task_id":"task-xyz", "agent_id":"agt-abc", "event":"started", "created_at_ms":1758096000000 }, { "log_id":"log-002", "task_id":"task-xyz", "agent_id":"agt-abc", "event":"completed", "created_at_ms":1758096300000 } ], "total":2 }}

十一、响应 data

字段	类型	说明
items	array	日志列表
total	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 或 AGENT_NOT_FOUND	指定的 Task 或 Agent 不存在。
500	Internal error	服务内部错误，可有限重试。

腾讯云数据库 AI 服务 参与日志（Metadata）