用途:本技能用于与 Tapform 数据交互。Tapform 是一款移动端表单构建工具,用户可在智能手机和平板电脑上创建和发布数字表单,供现场服务团队、巡检人员与数据采集人员用数字化流程替代纸质表单。官方文档:https://tapform.com/docs/
主要能力:覆盖 Form(表单)、Submission(提交)、Workspace(工作空间)、User(用户)等对象,可通过动作名称和参数进行管理,并支持 Organizations、Pipelines、Users、Goals、Filters 的操作。底层通过 Membrane CLI 与 Tapform 交互,Membrane 自动处理认证与凭据刷新。
使用方式: 安装 CLI:npm install -g @membranehq/cli@latest 登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾。任意命令可加 --json 输出机器可读结果。 建立连接:membrane connection ensure "https://tapform.io/" --json,用户在浏览器完成认证后返回 connection id;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪。 查找动作: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 直连 Tapform API,Membrane 会自动拼接 base URL 并注入认证头、透明刷新过期凭据;支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与注意:应优先使用 Membrane 预置动作而非手写 API 调用,以复用其认证、分页和错误处理;不要向用户索要 API key 或 token,应通过创建连接由 Membrane 在服务端管理完整认证生命周期。资料未提供 Tapform 的收费、价格与具体平台细节。