Sage Hr — Sage HR

Sage HR Sage HR 是一款面向中小企业的云端人力资源管理系统，帮助 HR 专业人士和企业主简化 HR 流程、管理员工数据并提升员工体验。 官方文档：https://developers.sage.com/hr/

Sage HR 概览 Time Off Time Off Request Report Employee Company Absence Type Absence Type Team Location

使用 Sage HR 本技能通过 Membrane CLI 与 Sage HR 交互。Membrane 自动处理身份验证与凭证刷新，让你专注集成逻辑，无需关心认证细节。

安装 CLI 全局安装 Membrane CLI，以便在终端运行 membrane： npm install -g @membranehq/cli@latest

身份验证 membrane login --tenant --clientName= 根据是否支持交互模式，命令会打开浏览器或打印授权 URL。 无头环境：命令打印授权 URL，提示用户在浏览器打开；完成后出现验证码，执行： membrane login complete 任意命令追加 --json 可输出机器可读 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于根据你的 harness 优化工具。

连接到 Sage HR 使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接： membrane connection ensure "https://sage.hr/" --json 用户在浏览器完成认证，输出包含新连接 id。 URL 会被规范化为域名并与已知应用匹配；未找到则自动创建并构建连接器。 若返回状态为 "READY"，直接跳到步骤 2。

1b. 等待连接就绪 若状态为 BUILDING，轮询直至就绪： npx @membranehq/cli connection get --wait --json --wait 最长 --timeout 秒（默认 30）长轮询，直到状态变化。 结果状态说明： READY — 连接完成，跳到步骤 2。 CLIENT_ACTION_REQUIRED — 需用户或 agent 操作，clientAction 对象描述所需动作： clientAction.type — 动作类型："connect"（需认证）、"provide-input"（需补充信息）。 clientAction.description — 人类可读说明。 clientAction.uiUrl（可选）— 预构建 UI 地址，可展示给用户。 clientAction.agentInstructions（可选）— 给 AI agent 的编程指引。 用户完成动作后，再次执行 membrane connection get --json 检查状态是否变为 READY。 CONFIGURATION_ERROR 或 SETUP_FAILED — 出错，查看 error 字段。

搜索动作 用自然语言描述需求并搜索： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 务必在特定连接上下文中搜索。结果包含 id、name、description、inputSchema、outputSchema。

常用动作 Name | Key | Description List Employees | list-employees | 获取员工列表，支持过滤、排序、分页。 List Active Employees | list-active-employees | 获取所有在职员工列表，可选历史参数。 List Absences | list-absences | 获取缺勤记录列表，支持过滤与分页。 List Jobs | list-jobs | 获取任职记录列表，支持过滤、排序、分页。 List Recruitment Positions | list-recruitment-positions | 获取开放招聘岗位列表。 List Time Off Requests | list-time-off-requests | 获取指定日期范围内的请假申请列表。 Get Employee | get-employee | 根据 ID 获取指定在职员工详情。 Get Absence | get-absence | 根据 ID 获取单条缺勤记录。 Get Job | get-job | 根据 ID 获取单条任职记录。 Get Recruitment Position | get-recruitment-position | 获取指定招聘岗位详情。 Create Employee | create-employee | 在 Sage HR 创建新员工。 Create Absence | create-absence | 为员工创建缺勤记录。 Create Job | create-job | 为员工创建任职记录。 Create Applicant | create-applicant | 为招聘岗位创建应聘者。 Create Time Off Request | create-time-off-request | 为员工创建请假申请。 Update Emp