接口介绍
MetadataClient 提供以下 Task-Agent 关联接口，用于管理 Task 与 Agent 之间的绑定关系。通过绑定，可以指定哪些 Agent 参与执行某个 Task，以及各 Agent 在 Task 中的角色。
link_task_agent：将 Agent 绑定到 Task，并可指定角色。
unlink_task_agent：解除 Task 与 Agent 的绑定关系。
list_task_agents：列出某个 Task 关联的全部 Agent。
导入
from tencentdb_agent_memory.v3 import MetadataClient
方法签名
def link_task_agent(self,task_id: str,agent_id: str,*,role_in_task: Optional[str] = None,) -> Dict[str, Any]
def unlink_task_agent(self, task_id: str, agent_id: str) -> Dict[str, Any]
def list_task_agents(self,task_id_or_request: Union[str, Dict[str, Any], None] = None,*,pagination: Optional[Dict[str, Any]] = None,) -> Dict[str, Any]
使用示例
link_task_agent
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.link_task_agent("task-xyz", "agt-abc", role_in_task="executor")print(resp)
list_task_agents
resp = metadata.list_task_agents("task-xyz", pagination={"limit": 50})for agent in resp["items"]:print(agent["agent_id"], agent["role_in_task"])
unlink_task_agent
resp = metadata.unlink_task_agent("task-xyz", "agt-abc")print(resp)
请求参数
link_task_agent
参数名 | 类型 | 必填 | 描述说明 |
task_id | str | 是 | Task ID |
agent_id | str | 是 | Agent ID |
role_in_task | str | 否 | Agent 在 Task 中的角色，如 executor、reviewer |
unlink_task_agent
参数名 | 类型 | 必填 | 描述说明 |
task_id | str | 是 | Task ID |
agent_id | str | 是 | Agent ID |
list_task_agents
参数名 | 类型 | 必填 | 描述说明 |
task_id | str | 是 | Task ID |
pagination | Dict | 否 | 分页参数，含 limit 和 offset |
响应示例
link_task_agent
{"task_id": "task-xyz","agent_id": "agt-abc","role_in_task": "executor","linked_at_ms": 1723968000000}
list_task_agents
{"items": [{"agent_id": "agt-abc","role_in_task": "executor","linked_at_ms": 1723900000000},{"agent_id": "agt-def","role_in_task": "reviewer","linked_at_ms": 1723800000000}],"total": 2}
响应参数说明
参数名 | 类型 | 参数含义 |
task_id | str | Task ID |
agent_id | str | Agent ID |
role_in_task | str | Agent 在 Task 中的角色 |
linked_at_ms | int | 绑定时间，Unix 时间戳，单位为毫秒 |
items | List[Dict] | 关联的 Agent 列表 |
total | int | 关联的 Agent 总数 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | 请求参数不合法 | 检查参数是否符合约束条件 |
401 | API Key 无效或缺失 | 检查 Bearer Token 配置 |
404 | 指定 Task 或 Agent 不存在 | 确认 ID 是否正确 |
409 | 绑定关系已存在 | 无需重复绑定 |
500 | 服务内部错误 | 稍后重试 |
