EP-Hub-Skill/.agents/skills/dingtalk-misc/references/hrbrain.md

Hrbrain（组织大脑）

本文件为 dingtalk-misc 内组织大脑产品入口。命令前缀：dws hrbrain。Distinct from dingtalk-contact（通讯录/组织架构）、考勤（本包 attendance.md）。

产品说明

Hrbrain 是钉钉组织大脑，提供人才池管理、员工档案查询、人才搜索三大能力。

CLI 前缀: dws hrbrain

命令总览

talent-pool (人才池管理)

命令	用途	必填参数	备注
talent-pool list	查询人才池列表	-	可选 --keyword、--pool-type、--creator、--labels（逗号分隔）、--page、--page-size
talent-pool detail	获取人才池详情	--pool-code	-
talent-pool employees	查询人才池内人员列表	--pool-code	可选 --page、--page-size

profile (员工档案管理)

命令	用途	必填参数	备注
profile metadata	查询员工档案元数据结构	--work-no	用于构造 profile query 的 --data-queries
profile query	按模块批量查询员工档案数据	--work-no --data-queries	--data-queries 为 JSON 数组，每项含 modelCode、fields
profile labels	获取员工标签	--staff-ids	逗号分隔工号列表；可选 --all-label
profile career	查询员工公司内职业历程	--work-no	-
profile performance	查询员工绩效记录	--work-no	-

search (人才搜索)

命令	用途	必填参数
search employees	人才搜索（简单条件）	-
search employees-structured	高级结构化搜索	--origin-json --fields
search fields	获取高级搜索字段列表	-

意图判断

• "人才池/储备干部池" → talent-pool list/detail/employees
• "员工档案/档案数据" → profile metadata/query
• "员工标签" → profile labels
• "职业历程/内部履历" → profile career
• "绩效记录" → profile performance
• "搜人/按条件找人" → search employees（简单）或 search fields + search employees-structured（复杂）

常用命令

dws hrbrain talent-pool list --page 1 --page-size 20 --format json
dws hrbrain talent-pool detail --pool-code POOL_CODE --format json
dws hrbrain talent-pool employees --pool-code POOL_CODE --format json
dws hrbrain profile metadata --work-no WORK_NO --format json
dws hrbrain profile query --work-no WORK_NO --data-queries '[{"modelCode":"basic","fields":["name","dept"]}]' --format json
dws hrbrain profile labels --staff-ids WORK_NO1,WORK_NO2 --format json
dws hrbrain profile career --work-no WORK_NO --format json
dws hrbrain profile performance --work-no WORK_NO --format json
dws hrbrain search employees --keyword "张三" --format json
dws hrbrain search fields --format json
dws hrbrain search employees-structured --origin-json '{"rules":[{"field":"name","operator":"contains","value":"张"}],"combinator":"and"}' --fields '[{"label":"姓名","value":"name"}]' --format json

安全规则

• --data-queries、--fields、--origin-json 必须是合法 JSON；--staff-ids、--labels、--order-by 是逗号分隔字符串。
• talent-pool list 需要账号单独开通人才池查看权限（errorCode=2002 时提示用户联系管理员开通）。