用途:本技能用于通过 Membrane CLI 与 FieldPulse 交互。FieldPulse 是面向 HVAC、管道、电气等行业中小企业的现场服务管理软件,覆盖调度、派工、发票和客户管理。适用于需要读取或操作 FieldPulse 数据(客户、工作、报价、发票、地点、表单、产品、服务、设备、团队成员、任务、工时、费用、付款)的场景。
主要能力:Membrane 预置动作支持列出与获取客户、工作、发票、报价、地点、资产、用户、团队;创建客户、工作、地点;更新客户等。完整 API 文档见 https://fieldpulse.com/api-docs/。Membrane 自动处理认证与凭据刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无界面环境会输出授权 URL,用户完成登录后执行 membrane login complete <code>。连接:membrane connection ensure "https://www.fieldpulse.com/" --json,状态为 BUILDING 时可用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到 READY 或按 CLIENT_ACTION_REQUIRED 提示用户操作。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。动作不足时可代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H、-d、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。
限制与注意:不应向用户索要 API 密钥或令牌,凭据由 Membrane 服务端管理。具体动作参数与返回结构以 inputSchema、outputSchema 为准;其余未在资料中说明的功能、收费、价格或效果暂未提供。