SuperAPI AI 工具集

ukg-pro-hcm

办公与效率

查看项目

更新于 10-15 09:12

技能介绍

UKG Pro HCM 是一款人力资本管理(HCM)平台,帮助企业管理人员队伍,提供人力资源、薪酬、人才管理和劳动力管理等工具。各种规模的公司都可以使用 UKG Pro HCM 来简化 HR 流程并提升员工参与度。官方文档地址:https://community.ukg.com/s/

用途 本技能用于与 UKG Pro HCM 数据交互,管理人员(Persons)、组织(Organizations)、职位(Jobs)、福利(Benefits)、薪酬(Payrolls)、休假(TimeOffs)等。当用户需要与 UKG Pro HCM 数据交互时使用。

主要能力 该技能通过 Membrane CLI 与 UKG Pro HCM 交互,Membrane 自动处理认证和凭据刷新,用户可专注于集成逻辑而非认证管道。可用的操作包括:列出员工人口统计详情、列出用户详情、列出员工扣款、列出 PTO 计划、列出职位、列出公司详情、列出员工变更、列出员工联系人、列出员工工作历史、列出薪酬详情、列出雇佣详情、列出人员详情,以及按员工 ID、职位代码、联系人 ID、系统 ID 等获取特定记录。

使用方式

  1. 安装 CLI:npm install -g @membranehq/cli@latest
  2. 认证:membrane login --tenant --clientName=<agentType>。该命令会打开浏览器进行认证,或在控制台打印授权 URL。无头环境下会打印授权 URL,用户完成登录后看到代码,执行 membrane login complete <code> 完成。任意命令加 --json 可获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等。
  3. 连接 UKG Pro HCM:使用 membrane connection ensure 按应用 URL 或域名查找或创建连接:membrane connection ensure "https://www.ukg.com/solutions/human-capital-management" --json。用户在浏览器中完成认证,输出包含新的连接 id。若返回的连接状态为 READY,可跳到下一步。若处于 BUILDING 状态,轮询直到就绪:npx @membranehq/cli connection get <id> --wait --json。状态为 READY 表示连接已完全建立;CLIENT_ACTION_REQUIRED 表示用户或 agent 需要执行操作,clientAction.type 为 "connect" 表示需要认证,"provide-input" 表示需要更多信息;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,检查 error 字段。
  4. 搜索操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。每个结果包含 id、name、description、inputSchema、outputSchema。
  5. 运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json。传 JSON 参数:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果在响应的 output 字段中。
  6. 代理请求:当可用操作不覆盖用例时,可通过 Membrane 代理直接向 UKG Pro HCM API 发送请求:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。

适用场景 适用于需要通过 AI agent 或命令行与 UKG Pro HCM 中的人力资源、薪酬、福利、休假、职位、员工信息等数据进行查询和管理的场景。

限制 资料未提供该技能的具体收费、价格、平台限制或效果信息。使用前需完成 Membrane CLI 安装与认证,并建立与 UKG Pro HCM 的连接。