SuperAPI AI 工具集

wecomcli-contact

办公与效率

查看项目

更新于 10-16 09:27

技能介绍

用途:通过 wecom-cli 在企业微信通讯录中按关键词搜索人员,适合查找联系人、区分同名人员、获取 userid、列举全部同名人员等场景。

前置条件:执行任何 wecom-cli 命令前,必须先读取并完成 wecomcli-shared 技能的公共前置检查。

命令:wecom-cli contact users search --json '<JSON 参数>'

参数:keywords(字符串数组,必填)为搜索关键词列表,可按姓名(用户名)、姓名拼音、英文名、别名匹配,最多 10 个,多个关键词之间为 OR 关系;search_mode(字符串,选填)默认不传,用于常规按名称查单个人员,仅当用户明确要完整名单(如“所有叫李四的人”“列出全部同名人员”)时才显式传 "list",此时返回全量命中列表,不受展示上限约束。

返回字段:users 为命中用户数组,元素含 userid、name(中文姓名)、alias(英文名/别名,可能为空)、email(可能为空)、position(管理职务,非职位,可能为空)、matched_keywords(命中的请求关键词)、departments(部门路径列表,从大到小,主部门靠前);另有 hint(结果限制提示,可能为空)与 users_count。

使用规则:同一关键词候选超过 5 位时只展示前 5 位并附区分信息,告知用户可要求“查看更多”,仅在用户明确要求时展开下一批;必须严格按返回 users 数组原始顺序展示,不得重排;hint 非空时须告知用户当前仅返回部分结果。

限制:必填参数缺失且上下文无法推断时,应以自然语言追问,不得猜测默认值。