接口介绍
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 MetadataClientmetadata = 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_id 和 priority |
list_agent_fixed_assets
参数名 | 类型 | 必填 | 描述说明 |
agent_id | str | 是 | Agent ID |
pagination | Dict | 否 | 分页参数,含 limit 和 offset |
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 | 服务内部错误 | 稍后重试 |