Officient 是一个 HR 平台,帮助公司管理员工数据、薪资和 HR 工作流,供 HR 专业人员和管理者简化 HR 流程、改善员工体验。官方文档见 https://developers.officient.io/。
用途与覆盖对象:涉及 Employee(员工)、Absence(缺勤)、Time Off(休假)、Expense(报销)、Salary(薪资)、Contract(合同)、Document(文档)、Department(部门)、Office(办公室)等记录,可按需使用相应操作名称与参数。
使用方式:本技能通过 Membrane CLI 与 Officient 交互,Membrane 自动处理认证与凭据刷新。先安装:npm install -g @membranehq/cli@latest。
登录:membrane login --tenant --clientName=<agentType>,可能打开浏览器认证或输出授权 URL;无头环境下需用户在浏览器打开 URL,完成后用 membrane login complete <code>。任意命令加 --json 可得机器可读 JSON。agentType 可填 claude、openclaw、codex、warp、windsurf 等。
建立连接:membrane connection ensure "https://www.officient.io/" --json,用户在浏览器完成认证,输出含 connection id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;CLIENT_ACTION_REQUIRED 时按 clientAction 处理(connect 表示需认证,provide-input 表示需补充输入,uiUrl 为可展示的操作界面);CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。
查找并执行操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 可按自然语言搜索操作,结果含 id、name、description、inputSchema、outputSchema。执行:membrane action run <actionId> --connectionId=CONNECTION_ID --json;传 JSON 参数用 --input '{"key": "value"}' --json,结果在 output 字段。
代理请求:当现有操作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接访问 Officient API,Membrane 自动补全基础 URL 并注入认证头。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
建议:优先使用 Membrane 预置操作,其内置认证、分页与错误处理,可减少 token 消耗并更安全;先搜索已有操作再自建 API 调用;不要让用户提供 API key 或 token,改用连接由 Membrane 服务端管理完整认证生命周期。
限制:资料未提供具体操作清单、字段细节、收费与配额信息,实际可用范围取决于 Membrane 所连 Officient 账号的授权与 API 权限,暂未提供更多说明。