chore(mcp): agent.user.list.query 工具描述定位为员工查询(代理人员查询)

This commit is contained in:
my_local_kimi_dev2
2026-10-13 13:51:18 +08:00
parent 14f2cd3ea9
commit b7308c836a
3 changed files with 3 additions and 3 deletions
@@ -1057,7 +1057,7 @@
## 44. agent.user.list.query
代理角色用户分页查询(m0 `user`,强制 `enterprise_type=1` + `soft_delete=0`),对应老 `/user/listByPage` 的代理用户子集。
员工查询(代理人员查询):代理角色用户分页查询(m0 `user`,强制 `enterprise_type=1` + `soft_delete=0`),对应老 `/user/listByPage` 的代理用户子集。
- 分类:agent | 类型:读
- 入参(全部可选):`agentId`(精确,必须在当前身份可见范围内)、`name`/`mobile`/`no`(模糊)、
@@ -33,7 +33,7 @@
## 3. 工具契约
**`agent.user.list.query`**(category=`agent`,kind=read)——分页查询代理角色用户(`enterprise_type=1`)列表,返回所属权限组、部门岗位明细。(v3 拍板:不返回位置信息)
**`agent.user.list.query`**(category=`agent`,kind=read)——员工查询(代理人员查询):分页查询代理角色用户(`enterprise_type=1`)列表,返回所属权限组、部门岗位明细。(v3 拍板:不返回位置信息;v4 拍板:工具描述定位为"员工查询/代理人员查询")
### 入参
@@ -64,7 +64,7 @@ public class AgentUserTools implements ToolObject {
* agentName/authorityName/districtName/deptList 按页批量 IN 富化,无 N+1。
*/
@XqTool(category = "agent", kind = "read")
@Tool(name = "agent.user.list.query", description = "分页查询代理角色用户(user.enterprise_type=1)列表,返回所属权限组、部门岗位明细。"
@Tool(name = "agent.user.list.query", description = "员工查询(代理人员查询):分页查询代理角色用户(user.enterprise_type=1)列表,返回所属权限组、部门岗位明细。"
+ "行级权限:总部身份(权限组 isagent=0)可看全部,可传任意 agentId;代理商身份(isagent=1)只能看自己+直属下级+授权代管代理商范围内的用户,"
+ "传 agentId 时必须在可见范围内,否则拒绝。"
+ "enterpriseType 含义:1=代理 2=物业(本工具恒为 1);approle 含义:1=运维 2=保洁 3=富士康 4=老化 5=物业 6=代理;"