用途:FileStack 是文件处理服务,面向网页与移动应用,提供文件上传、转换与交付能力,帮助开发者简化文件管理,例如图片缩放、格式转换与存储集成。本技能用于在 FileStack 中管理数据、记录并自动化工作流,适用于需要与 FileStack 数据交互的场景。
主要能力与数据对象:涉及的文件相关对象包括文件、文件内容、文件元数据、文件夹以及共享链接。官方文档见 https://www.filestack.com/docs/ ,可按需使用相应操作名称与参数。
使用方式:该技能通过 Membrane CLI 与 FileStack 交互,Membrane 自动处理认证与凭据刷新。安装命令:npm install -g @membranehq/cli@latest 。登录命令:membrane login --tenant --clientName=<agentType> ;无界面环境会打印授权 URL,用户登录后获得代码,再执行 membrane login complete <code> 完成。
连接 FileStack:执行 membrane connection ensure "https://www.filestack.com/" --json ,用户在浏览器完成认证,输出中包含连接 id。若状态为 BUILDING,可轮询 membrane connection get <id> --wait --json ,直至状态不再是 BUILDING。状态为 READY 表示就绪;CLIENT_ACTION_REQUIRED 表示需要用户或代理执行操作;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错。
查找与执行操作:执行 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索操作,结果包含 id、name、description、inputSchema、outputSchema。执行操作命令:membrane action run <actionId> --connectionId=CONNECTION_ID --json ,传参可用 --input '{"key": "value"}' ,结果在响应的 output 字段。
代理请求:当现有操作无法覆盖需求时,可通过 Membrane 代理直接请求 FileStack API,命令为 membrane request CONNECTION_ID /path/to/endpoint ,Membrane 会自动拼接基础 URL 并注入认证头、透明刷新凭据。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
建议:优先使用 Membrane 与外部应用通信,以复用预置操作的内置认证、分页与错误处理;先发现再构建,先运行操作搜索再编写自定义 API 调用;凭据交由 Membrane 管理,不要向用户索取 API 密钥或令牌,而是创建连接。
限制:现有资料未提供具体收费、价格、平台与效果信息,暂未提供。使用前需确保具备可用的 Membrane 环境与完成 FileStack 认证。