用途:这是一个 PeopleHR 集成技能,当用户需要与 PeopleHR 数据交互时使用。PeopleHR 是面向中小企业的人力资源管理系统,供 HR 人员和管理者管理员工数据、跟踪考勤和处理绩效评估。该技能通过 Membrane 与 PeopleHR 交互,由 Membrane 自动处理认证和凭证刷新。官方文档见 https://apidocs.peoplehr.net/。
覆盖对象:员工、缺勤、培训课程、福利、文档,以及缺勤类型、培训课程类型、福利类型。具体可用动作与参数需按需查询。
主要能力:通过 Membrane CLI 执行动作、发现动作、代理请求 PeopleHR API,并自动注入认证头、处理分页与错误。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。交互模式会打开浏览器,无头环境会打印授权链接,完成后执行 membrane login complete <code>。连接 PeopleHR:membrane connection ensure "https://www.peoplehr.com/" --json,用户在浏览器完成认证后获得连接 id;若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。当动作无法覆盖需求时,可通过代理直接请求 API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可输出机器可读结果。
最佳实践:优先使用 Membrane 而非直接调用外部 API;先发现已有动作再自行构建;不要向用户索要 API 密钥或令牌,改用连接机制,由 Membrane 在服务端管理完整认证生命周期。
限制:资料未提供具体的动作清单、参数细节、收费信息或使用配额,需在实际环境中查询确认。