用途:此技能用于连接 UpKeep 维护管理平台,帮助维护团队和设施管理人员管理数据、记录并自动化工作流,适用于用户需要与 UpKeep 数据交互的场景。
主要能力:围绕 Work Order(工单)、Asset(资产)、Location(位置)、Part(零件)四类对象进行操作。Membrane 负责认证与凭据刷新,支持预构建动作、分页与错误处理,也可通过代理直接请求 UpKeep API。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会输出授权 URL,需用户在浏览器打开,完成后执行 membrane login complete <code>,任意命令加 --json 可输出机器可读结果。建立连接:membrane connection ensure "https://www.upkeep.com/" --json;若状态为 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。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。代理请求:membrane request CONNECTION_ID /path/to/endpoint,可用 -X、-H、-d、--json、--query、--pathParam 等选项。
限制:官方 API 文档为 https://upkeep.zendesk.com/hc/en-us/categories/200475778-API。资料未提供具体动作清单、可用参数、返回结构、错误码、速率限制、价格与权限要求,需以实际连接后的动作定义为准。不要让用户提供 API 密钥或令牌,由 Membrane 管理凭据。