腾讯云数据库 AI 服务 Agent 固定资产（Metadata）

一、接口介绍

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

九、请求示例

十、响应示例

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

十四、请求示例

十五、响应示例

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

20、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "agent_id":"agt-xyz", "asset_count":2 }, { "agent_id":"agt-abc", "asset_count":5 } ] }}

21、响应 data

字段	类型	说明
items	array	各 Agent 的固定资产汇总
items[].agent_id	string	Agent ID
items[].asset_count	int	固定资产数量

22、错误码

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