用途:该技能用于与 Elastic Path 商务平台交互,管理数据、记录并自动化工作流。Elastic Path 是面向企业的商务平台,提供灵活 API,用于构建订阅、B2B 商务或无头电商等定制化购物体验。官方文档见 https://documentation.elasticpath.com/。
主要能力:可操作目录、品类、产品、客户、订单、促销等资源,通过动作或代理请求完成数据管理与集成逻辑。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest,然后执行 membrane login --tenant --clientName=<agentType> 登录;无界面环境会打印授权 URL,完成登录后用 membrane login complete <code> 收尾。添加 --json 可获得机器可读输出。
连接 Elastic Path:使用 membrane connection ensure "https://elasticpath.com" --json 查找或创建连接,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。
查找与运行动作:用 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索动作,结果包含 id、name、description、inputSchema、outputSchema;用 membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 运行,结果在 output 字段。
代理请求:当现有动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接请求 Elastic Path API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 自动补齐基础 URL 并注入认证头,支持凭据过期时透明刷新。
最佳实践:优先使用 Membrane 与外部应用通信,以复用内置认证、分页和错误处理;先发现动作再自建调用;不要让用户提供 API 密钥或令牌,改由连接管理凭据,Membrane 在服务端管理完整认证生命周期。
限制:资料未提供具体动作清单、配额、定价或平台支持范围等细节。