Timetastic 是一款基于网页的休假管理系统,帮助企业管理员工休假,包括假期、病假和其他缺勤,通常供中小企业的人力资源部门、经理和员工使用。官方文档位于 https://developers.timetastic.com/。该技能通过 Membrane CLI 与 Timetastic 交互,覆盖用户、缺勤类型、缺勤和休假额度等数据对象,可用于管理数据、记录并自动化工作流。
使用前需全局安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录使用 membrane login --tenant --clientName=<agentType>,交互模式会打开浏览器,无头环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。所有命令可加 --json 获得机器可读输出。
建立连接可使用 membrane connection ensure "https://timetastic.co.uk/" --json,用户在浏览器完成认证,返回连接 id。若连接处于 BUILDING 状态,用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到状态变为 READY;若为 CLIENT_ACTION_REQUIRED,需按 clientAction 说明让用户完成认证或补充输入。
查找操作使用 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"}' 传入,结果位于 output 字段。当现有操作无法覆盖需求时,可通过代理直接请求 Timetastic API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 会自动附加基础 URL 并注入认证头。
建议优先使用 Membrane 预构建操作,其内置认证、分页和错误处理;先发现再构建;不要向用户索取 API 密钥或令牌,由 Membrane 在服务端管理完整认证生命周期。具体可用操作列表及参数以实际查询结果为准,资料中未提供完整清单。