接口介绍
参与日志接口用于记录和管理 Agent 在 Task 中的参与记录。共2个接口：
接口 | 方法 | 功能 |
/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 | 否 | 分页偏移量 |
请求示例
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/list \\-d '{"task_id":"task-xyz"}'
响应示例
{"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 | 服务内部错误，可有限重试。 |