接口介绍
Agent 固定资产接口用于管理 Agent 绑定的固定资产资源。共4个接口：
接口 | 方法 | 功能 |
/v3/agent-fixed-asset/set | POST | 设置 Agent 固定资产 |
/v3/agent-fixed-asset/list | POST | 列出 Agent 固定资产 |
/v3/agent-fixed-asset/list-with-detail | POST | 列出 Agent 固定资产（含详情） |
/v3/agent-fixed-asset/summarize | POST | 按 Agent 汇总固定资产 |
设置 Agent 固定资产
为 Agent 设置固定资产列表。
POST /v3/agent-fixed-asset/set
请求参数
字段 | 类型 | 必选 | 说明 |
agent_id | string | 是 | Agent ID |
asset_ids | string[] | 是 | 固定资产 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/agent-fixed-asset/set \\-d '{"agent_id":"agt-xyz","asset_ids":["asset-001","asset-002"]}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"agent_id":"agt-xyz","asset_count":2}}
响应 data
字段 | 类型 | 说明 |
agent_id | string | 已设置固定资产的 Agent ID |
asset_count | int | 当前固定资产数量 |
列出 Agent 固定资产
列出指定 Agent 绑定的固定资产 ID。
POST /v3/agent-fixed-asset/list
请求参数
字段 | 类型 | 必选 | 说明 |
agent_id | string | 是 | Agent 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/agent-fixed-asset/list \\-d '{"agent_id":"agt-xyz"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"items":["asset-001","asset-002"]}}
响应 data
字段 | 类型 | 说明 |
items | array | 固定资产 ID 列表 |
列出 Agent 固定资产（含详情）
列出指定 Agent 绑定的固定资产（含详情）。
POST /v3/agent-fixed-asset/list-with-detail
请求参数
字段 | 类型 | 必选 | 说明 |
agent_id | string | 是 | Agent 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/agent-fixed-asset/list-with-detail \\-d '{"agent_id":"agt-xyz"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"items":[{"asset_id":"asset-001","name":"产品文档","type":"document","attached_at_ms":1758096000000},{"asset_id":"asset-002","name":"训练数据集","type":"dataset","attached_at_ms":1758182400000}]}}
响应 data
字段 | 类型 | 说明 |
items | array | 固定资产列表（含详情） |
items[].asset_id | string | 资产 ID |
items[].name | string | 资产名称 |
items[].type | string | 资产类型 |
items[].attached_at_ms | int | 绑定时间 |
按 Agent 汇总固定资产
按 Agent 维度汇总固定资产数量。
POST /v3/agent-fixed-asset/summarize
请求参数
字段 | 类型 | 必选 | 说明 |
agent_ids | string[] | 是 | Agent 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/agent-fixed-asset/summarize \\-d '{"agent_ids":["agt-xyz","agt-abc"]}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"items":[{"agent_id":"agt-xyz","asset_count":2},{"agent_id":"agt-abc","asset_count":5}]}}
响应 data
字段 | 类型 | 说明 |
items | array | 各 Agent 的固定资产汇总 |
items[].agent_id | string | Agent ID |
items[].asset_count | 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 | AGENT_NOT_FOUND 或 ASSET_NOT_FOUND | 指定的 Agent 或资产不存在。 |
500 | Internal error | 服务内部错误，可有限重试。 |