用途:Talenox 是云端 HR 软件,用于简化薪资(Payrolls)、休假(Time Off)等 HR 事务,面向中小企业。本技能通过 Membrane CLI 与 Talenox 交互,适用于用户希望操作 Talenox 数据的场景,可管理人员(Persons、Employees)与公司(Companies),涉及员工档案、休假、薪资、报表等。官方文档:https://developers.talenox.com/
主要能力:Talenox 覆盖员工档案、休假、薪资、报表等模块。Membrane 提供预置动作,自动处理认证与凭据刷新,并处理分页、字段映射与错误,避免直接暴露 API 密钥。
安装与登录:安装 CLI 使用 npm install -g @membranehq/cli@latest。登录使用 membrane login --tenant --clientName=<agentType>,在无界面环境会打印授权 URL,需用户在浏览器完成登录后用 membrane login complete <code> 完成。任意命令可加 --json 输出机器可读结果。Agent Types 包括 claude、openclaw、codex、warp、windsurf 等。
连接 Talenox:使用 membrane connection ensure "https://www.talenox.com/" --json 查找或创建连接,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询直至不再为 BUILDING。READY 表示就绪;CLIENT_ACTION_REQUIRED 表示需要用户或智能体执行动作,clientAction.type 可为 connect(需认证)或 provide-input(需补充信息),clientAction.uiUrl 可展示给用户,agentInstructions 供智能体参考;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 直接请求 Talenox API,Membrane 自动拼接基础 URL 并注入认证头,支持凭据透明刷新。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
最佳实践:优先使用 Membrane 与外部应用通信,使用预置动作减少 token 消耗并提升安全性;先搜索再构建;由 Membrane 管理凭据,不要向用户索取 API 密钥或令牌。限制:资料未提供具体可用动作清单、字段细节、收费与价格信息,暂未提供。