SuperAPI AI 工具集

dingtalk-hrbrain

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:钉钉组织大脑(Hrbrain)技能,面向人才池、员工档案与人才搜索场景,命令前缀为 dws hrbrain。适用于用户提到人才池、储备干部池、员工档案、职业历程、绩效记录、员工标签、组织大脑或人才搜索时;与 dingtalk-contact(通讯录/组织架构)、dingtalk-attendance(考勤)区分。

主要能力:查询人才池列表、详情及池内员工;读取员工档案结构与数据、员工标签、职业历程、绩效记录;按关键词或组合条件搜索员工。

使用方式:需先阅读 dws-shared 技能了解认证、全局参数、产品路由、URL 预检、错误码与安全规则,并确保 dws 二进制在 PATH 中。人才池列表用 dws hrbrain talent-pool list;人才池详情用 dws hrbrain talent-pool detail --pool-code <POOL_CODE>;池内员工用 dws hrbrain talent-pool employees --pool-code <POOL_CODE>;档案结构用 dws hrbrain profile metadata --work-no <WORK_NO>,再执行 dws hrbrain profile query --work-no <WORK_NO> --data-queries '[...]';标签用 dws hrbrain profile labels --staff-ids <WORK_NO1,WORK_NO2>;职业历程用 dws hrbrain profile career --work-no <WORK_NO>;绩效用 dws hrbrain profile performance --work-no <WORK_NO>;简单搜人用 dws hrbrain search employees --keyword <关键词>;复杂搜人先执行 dws hrbrain search fields 获取字段,再用 dws hrbrain search employees-structured --origin-json '{...}' --fields '[...]'。

限制:该技能为试验版,multi 模式尚未达到 stable 标准,接口、命名与跨技能引用可能调整,生产或共享环境建议先用 mono 模式 dws skill setup --mode mono。命令可用性以当前 dws 二进制为准,服务发现已下线,若 dws <cmd> --help 不存在说明当前版本未暴露该命令;调用失败需按错误提示确认端点与后端工具注册,实际调用前可用 --help 或 --dry-run 验证。talent-pool list 需要单独开通人才池查看权限,返回 errorCode=2002 时应提示联系管理员开通,不要重试或更换 profile。--data-queries、--fields、--origin-json 必须是合法 JSON 字符串,--staff-ids、--labels、--order-by 为逗号分隔字符串,不是 JSON。其他细节暂未提供。