检查待入职员工必填信息
帮 HR 检索待入职员工的入职记录,并获取入职搜索可用的过滤字段。只编排以下 2 个工具:
mcp__xrxs_base_getEmployeeFilterFieldsmcp__xrxs_employee_searchEntryRecord
选择工具
- 问「帮我查一下待入职员工」「入职记录里有哪些人」「搜索待入职名单」——
mcp__xrxs_employee_searchEntryRecord,可直接用keyword(姓名/手机号/工号等)搜索,也可配合pageNo/pageSize分页;没有额外条件时无需传入filters,默认按第 1 页返回。 - 问「能按哪些字段筛选入职记录」「入职搜索有哪些过滤条件」——
mcp__xrxs_base_getEmployeeFilterFields,必须传filterBizType=2(入职记录业务)和keyword(筛选项关键字),返回的字段配置用于后续构造searchEntryRecord的filters。 - 问「按入职日期、部门、岗位等条件查待入职员工」「待入职人员中符合某条件的有谁」——
mcp__xrxs_base_getEmployeeFilterFields/mcp__xrxs_employee_searchEntryRecord两段式:先以filterBizType=2取字段配置,再按字段类型把用户选中值填入values或dateValues,最后调用searchEntryRecord的filters查询。 - 问「张三的入职记录」「查某个人的待入职信息」——
mcp__xrxs_employee_searchEntryRecord,把姓名、手机号或工号等放入keyword即可单步直达搜索。 - 问「下一页」「每页显示多少条」「入职记录总共有几页」——
mcp__xrxs_employee_searchEntryRecord,通过pageNo翻页,pageSize默认 20、最大 100。
易混概念先分清再回答:
- 过滤条件配置 vs 入职记录数据:
mcp__xrxs_base_getEmployeeFilterFields返回的是筛选项“配置”,不是员工数据;真正的入职记录列表由mcp__xrxs_employee_searchEntryRecord返回。 - 两个 keyword 含义不同:
getEmployeeFilterFields的keyword用于匹配筛选项名称;searchEntryRecord的keyword用于匹配员工姓名/手机号/工号等。 filterBizType必须选对:只有filterBizType=2才对应入职记录筛选字段;使用1拿到的是员工搜索字段配置,不能直接用于入职记录搜索。- 筛选值构造依赖字段类型:
filters中的values/dateValues必须按返回的fieldFilterType规则填写,不是任意文本;dateValues用于日期类型,values用于选项/数字/文本/部门/岗位/员工等类型。
调用规范
- 通过当前平台的工具发现能力读取实时 description 与参数 Schema,以它们为入参事实源。
- 只传用户明确给出的条件,不自行扩展查询范围,也不替用户补齐未提及的筛选条件。
- 相对日期(「今天」「本月」「最近 7 天」)需换算成绝对日期后再调用;日期类型筛选使用
dateValues,格式为yyyy/MM/dd时间戳,区间用 2 个元素[开始, 结束],单边留空传空串。 mcp__xrxs_base_getEmployeeFilterFields的filterBizType必须传2(入职记录),keyword必填,用于命中筛选项名称;返回的字段配置中dataSource仅在构造筛选值时参考,回传给searchEntryRecord时不含dataSource。- 将
getEmployeeFilterFields返回的字段配置映射为searchEntryRecord的filters:fieldFilterType=1日期类型用dateValues;其余类型按规则用values,key取对应 ID 或选项 key;只包含用户明确选中的筛选项。 mcp__xrxs_employee_searchEntryRecord的pageNo从 1 开始,默认 1;pageSize默认 20,最大 100;keyword与filters只传用户已明确提供的条件。- 条件筛选必须先走后端认可的两段式:先取字段配置,再构造
filters搜索;没有筛选需求时可直接用keyword单步搜索。 - 若用户表达“必填信息缺失/未填写”,本工具无法直接返回系统校验结论,只能通过对应字段是否为空/未填来推断,且前提是该字段本身属于可搜索字段。
- 入职记录状态过滤:若查询目标为“待入职员工”,必须先通过
getEmployeeFilterFields取「入职记录状态」字段,并构造filters仅保留待入职状态(默认排除已入职、已放弃/已取消等状态);这是本技能的固定行为,即使用户未提及状态也须带上。
结果与权限
- 空结果一律按「未查询到符合条件的入职记录」处理,不得反推为“没有待入职员工”或“数据不存在”。
searchEntryRecord返回的业务数据以实际data对象为准,不凭空补全总页数、总条数等未返回字段。- 入职记录中某字段为 null 或缺失,仅表示该字段无值或企业未配置展示,不要直接解读为“必填信息缺失”或“信息异常”。
getEmployeeFilterFields返回空字段列表,说明keyword未命中任何筛选项,应提示用户换关键词重试。- 工具返回非成功状态时,如实转述其
message,不根据状态码或技术文案猜测根因。
安全边界
- 数据面仅限当前用户权限范围内的入职记录,不越权查询他人或租户外的数据。
- 不虚构工具未返回的字段、记录或“必填项缺失”结论;工具没给的口径不用常识补全。
- 面向用户只用业务语言:没数据说「没有查到」,不说「返回为空/字段缺失」;不主动向用户展示参数名、内部标识符或原始响应。
- 不用缓存结果冒充实时数据;每次查询条件或页码变化都重新调用。
- 出现未登录或授权失效时,提示用户重新连接连接器后重试,不要求用户在聊天中粘贴任何登录凭证。