SuperAPI AI 工具集

wecom-contact-lookup

办公与效率

查看项目

更新于 10-16 08:47

技能介绍

用途:在较小的通讯录可见范围内查询企业成员,并可为其他需要 userid 的功能提供身份转换。

主要能力:通过 wecom_mcp 工具的 get_userlist 接口获取当前用户可见范围内的全量成员,返回 userid、name(姓名)和 alias(别名);拿到结果后在本地按姓名或别名做精确或模糊匹配,也可一次获取后批量筛选多个人员,避免重复调用接口。

使用方式:所有操作通过调用 wecom_mcp 完成。首次调用前必须先按 wecom-preflight 技能执行前置条件检查,确保工具已加入白名单。获取成员时使用:wecom_mcp call contact get_userlist '{}'。

匹配策略:精确匹配(name 或 alias 完全一致)直接使用;模糊匹配唯一结果直接展示;模糊匹配多个结果需展示候选列表请用户确认;无结果则告知未找到。alias 可能为空字符串,搜索时需做空值判断;若 errcode 不为 0,需向用户告知 errmsg。

适用场景:查询某位成员是谁、为发消息等功能提供 userid 转换、批量查询多个人员信息。

限制:仅返回当前用户有权限查看的成员,并非全量成员;若返回成员数量超过 10 人,视为异常,应立即停止处理并说明当前可见成员超过本技能支持的上限,本技能仅适用于可见范围较小的场景,建议缩小可见范围后重试或改用其他方式;返回字段仅限 userid、name 和 alias;存在多个同名人员时必须交由用户选择,不得自行决定。