帮你快速理解、总结文档立即下载

Agent 固定资产

最近更新时间:2026-08-27 17:42:00
我的收藏

接口介绍

MetadataClient 提供以下 Agent 固定资产接口,用于管理 Agent 与资产之间的固定绑定关系。固定资产是 Agent 始终可访问的资源,无需每次通过 ACL 授权。
set_agent_fixed_assets:全量设置 Agent 的固定资产绑定列表(覆盖写入)。
list_agent_fixed_assets:列出 Agent 绑定的固定资产 ID。
list_agent_fixed_assets_with_detail:列出固定资产及其详细信息。
summarize_agent_fixed_assets_by_agents:按 Agent 维度汇总固定资产统计。

导入

from tencentdb_agent_memory.v3 import MetadataClient

方法签名

def set_agent_fixed_assets(
self,
agent_id: str,
bindings: List[Dict[str, Any]],
) -> Dict[str, Any]
def list_agent_fixed_assets(
self,
agent_id_or_request: Union[str, Dict[str, Any], None] = None,
*,
pagination: Optional[Dict[str, Any]] = None,
) -> Dict[str, Any]
def list_agent_fixed_assets_with_detail(self, p: Dict[str, Any]) -> Dict[str, Any]
def summarize_agent_fixed_assets_by_agents(self, p: Dict[str, Any]) -> Dict[str, Any]

使用示例

set_agent_fixed_assets

from tencentdb_agent_memory.v3 import MetadataClient

metadata = MetadataClient(
endpoint="https://memory.tdai.tencentyun.com",
api_key="sk-xxxxxxxxxxxxxxxx",
service_id="tdai-mem-xxxxxxxx",
)

resp = metadata.set_agent_fixed_assets("agt-xyz789", [
{"asset_id": "asset-123", "priority": 1},
{"asset_id": "asset-456", "priority": 2},
])
print(resp)

list_agent_fixed_assets

resp = metadata.list_agent_fixed_assets("agt-xyz789", pagination={"limit": 50})
for binding in resp["items"]:
print(binding["asset_id"], binding["priority"])

list_agent_fixed_assets_with_detail

resp = metadata.list_agent_fixed_assets_with_detail({"agent_id": "agt-xyz789"})
for item in resp["items"]:
print(item["asset_id"], item["name"], item["priority"])

summarize_agent_fixed_assets_by_agents

resp = metadata.summarize_agent_fixed_assets_by_agents({"team_id": "team-abc"})
for summary in resp["items"]:
print(summary["agent_id"], summary["asset_count"])

请求参数

set_agent_fixed_assets

参数名
类型
必填
描述说明
agent_id
str
Agent ID
bindings
List[Dict]
固定资产绑定列表,每项含 asset_idpriority

list_agent_fixed_assets

参数名
类型
必填
描述说明
agent_id
str
Agent ID
pagination
Dict
分页参数,含 limitoffset

list_agent_fixed_assets_with_detail

参数名
类型
必填
描述说明
agent_id
str
Agent ID

summarize_agent_fixed_assets_by_agents

参数名
类型
必填
描述说明
team_id
str
团队 ID,汇总该团队下所有 Agent 的固定资产

响应示例

set_agent_fixed_assets

{
"agent_id": "agt-xyz789",
"bindings": [
{"asset_id": "asset-123", "priority": 1},
{"asset_id": "asset-456", "priority": 2}
],
"updated_at_ms": 1723968000000
}

list_agent_fixed_assets

{
"items": [
{"asset_id": "asset-123", "priority": 1},
{"asset_id": "asset-456", "priority": 2}
],
"total": 2
}

list_agent_fixed_assets_with_detail

{
"items": [
{
"asset_id": "asset-123",
"name": "数据字典 v2.0",
"type": "document",
"priority": 1
},
{
"asset_id": "asset-456",
"name": "API 规范",
"type": "document",
"priority": 2
}
]
}

summarize_agent_fixed_assets_by_agents

{
"items": [
{"agent_id": "agt-xyz789", "agent_name": "sql-helper", "asset_count": 2},
{"agent_id": "agt-abc123", "agent_name": "doc-writer", "asset_count": 5}
]
}

响应参数说明

参数名
类型
参数含义
agent_id
str
Agent ID
bindings
List[Dict]
固定资产绑定列表
asset_id
str
资产 ID
priority
int
优先级,数值越小优先级越高
name
str
资产名称(含详情查询时返回)
type
str
资产类型(含详情查询时返回)
asset_count
int
Agent 绑定的固定资产数量(汇总接口)
items
List[Dict]
结果列表
total
int
总数

错误码

错误码
触发场景
处理建议
400
请求参数不合法(如 bindings 为空数组)
检查参数是否符合约束条件
401
API Key 无效或缺失
检查 Bearer Token 配置
404
指定 Agent 或资产不存在
确认 ID 是否正确
500
服务内部错误
稍后重试