该技能用于与 UKG Pro 交互。UKG Pro 是一套人力资本管理(HCM)解决方案,供 HR 部门和企业管理者管理员工从招聘到离职的整个生命周期。官方文档:https://developer.ukg.com/,内容概览涉及 Employee(员工)、Time Off(休假)、Team(团队)。
用途与能力:管理数据、记录并自动化工作流;用户需要与 UKG Pro 数据交互时使用。集成通过 Membrane CLI 完成,Membrane 自动处理认证与凭证刷新,因此可专注于集成逻辑而非认证管道。
使用方式:先安装 CLI,命令为 npm install -g @membranehq/cli@latest。认证命令:membrane login --tenant --clientName=<agentType>;交互模式下会打开浏览器,无界面环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任何命令加 --json 可输出机器可读的 JSON。agentType 可选 claude、openclaw、codex、warp、windsurf 等,用于针对运行环境调整工具。
连接 UKG Pro:使用 membrane connection ensure "https://www.ukg.com/" --json 按应用 URL 或域名查找或创建连接,用户在浏览器完成认证,输出包含新的 connection id。若连接状态为 BUILDING,可轮询 npx @membranehq/cli connection get <id> --wait --json(--wait 长轮询,--timeout 默认 30 秒),直到状态不再是 BUILDING;READY 表示已就绪,CLIENT_ACTION_REQUIRED 表示需用户或代理执行动作(类型如 connect、provide-input,可能带 uiUrl 或 agentInstructions),CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,需查看 error 字段。
查找与运行动作:用自然语言意图搜索,命令为 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。也可用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用动作。运行为 membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参可加 --input '{"key": "value"}' --json,结果在输出的 output 字段。
代理请求:当现有动作不覆盖用例时,可通过 Membrane 代理直接请求 UKG Pro API:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。Membrane 会自动拼接基础 URL,并注入正确认证头,凭证过期时透明刷新。
最佳实践与限制:优先使用 Membrane 与外部应用通信,因其动作内置认证、分页与错误处理,可减少 token 消耗并提升安全性;先发现再构建,先运行 membrane action list --intent=QUERY 查找现有动作,再考虑自定义 API 调用;不要向用户索要 API key 或 token,应创建连接,由 Membrane 在服务端管理完整认证生命周期,不在本地保存密钥。资料未提供具体动作清单、字段细节、配额或收费信息,暂未提供。