Agent 身份管理

本文面向需要核对用户委托授权或终止某条 Agent 访问身份的租户管理员。你可以查明客户端代表哪个用户、获得哪些授权，并在需要时撤销指定身份。

在 Agent 身份中心管理用户委托身份。本文不包含客户端接入配置，也不提供调用历史、最近活动统计或历史身份查询。

准备工作

查看列表和详情需具有 查询 Agent 身份 权限；执行撤销还需具有 撤销 Agent 身份 权限，由租户权限管理员授予。

当前租户已存在完成用户授权的 Agent 客户端。仅完成客户端注册或打开授权页不会创建用户委托身份。

撤销前确认目标 Agent ID、客户端和委托用户，并与使用该身份的人员确认影响。

Agent ID 用于区分一次有效的用户委托身份，Client ID 用于标识客户端，两者不能互相替代。同一租户、同一客户端、同一用户在身份有效期间复用同一个 Agent ID。

查询身份与授权范围

定位目标身份

进入 用户中心 → Agent 身份中心，输入 Agent 名称、Agent ID、Client ID 或用户名，点击 查询。需要缩小范围时补充创建时间或来源 IP；来源 IP 使用完整的 IPv4 或 IPv6 地址，不输入地址段。

查询组合条件按“且”处理。结果为空时先点击 重置 排除条件影响，再确认用户是否已完成授权。

核对客户端和委托用户

点击 Agent 名称或 查看详情，在 基础信息 中核对 Agent 名称、Agent ID、Client ID、委托用户、创建时间和注册来源 IP。

当前注册方式显示为 DCR（自动注册）。DCR 指动态客户端注册；注册来源 IP 表示客户端注册请求的出口地址，不等同于每次工具调用的来源地址。

查看实际授权范围

切换到 授权范围，查看当前身份实际获得的权限点及授权时间。这里显示用户已授予的权限，不应把客户端可申请的权限清单当作已获授权。

撤销指定身份

撤销会使该 Agent ID 的现有令牌和会话失效，后续工具调用应被拒绝。该身份不能恢复；需要继续使用时，应由用户重新授权并生成新的 Agent ID。

核对撤销对象并填写原因

返回列表，点击目标行的 撤销。在 撤销 Agent 身份 窗口中再次核对 Agent 名称、Agent ID、委托用户和授权范围。填写 1–200 字的撤销原因，仅输入空格不符合要求。

如果对象不符，点击 取消，不要提交。

提交撤销并检查原身份

点击 确认撤销，等待结果。提示 身份已撤销 后，原 Agent ID 应从当前列表移除。

撤销一条身份不等于删除客户端，也不应使该客户端的其他用户身份一并失效。

验证结果

记录撤销前的 Agent ID，检查它不再出现在当前列表，并让客户端使用原有授权访问其原先有权调用的工具，确认原授权已不能继续访问。涉及真实业务工具时，由相应业务负责人选择不会产生非预期写入的验证方式。

如果客户端重新连通，检查是否重新触发了认证或用户授权，并比较新旧 Agent ID。重新授权后出现新身份，与原身份继续有效是两种不同情况。

常见问题

为什么没有新增身份按钮？

身份由用户授权流程产生。请先在已配置的客户端完成用户授权，再回到身份中心查询。

为什么撤销后又出现一条身份？

客户端可能重新发起认证，用户重新授权后会生成新身份。先比较 Agent ID，不能只根据客户端名称相同判断撤销失败。

为什么没有撤销操作？

查看权限与撤销权限分开控制。请租户权限管理员核对账号是否具有 撤销 Agent 身份 权限。

停用或回滚

确认前可点击 取消。确认撤销后不支持恢复原身份；需要继续使用时重新完成用户授权。不要通过恢复旧令牌或会话来恢复访问。

准备工作#

查询身份与授权范围#

撤销指定身份#

验证结果#

常见问题#

为什么没有新增身份按钮？#

为什么撤销后又出现一条身份？#

为什么没有撤销操作？#

停用或回滚#