Purple Dot 是一个预售(pre-commerce)平台,让品牌在产品尚未到货时即可销售,常用于预售、缺货补货(backorder)和按需定制商品。该技能通过 Membrane CLI 与 Purple Dot 交互,Membrane 负责自动处理认证与凭证刷新。涉及的主要对象包括订单(Order)、行项目(Line Item)、产品(Product)、客户(Customer)。官方文档见 https://developers.purpledot.com/。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。然后登录:membrane login --tenant --clientName=<agentType>;无界面环境会输出授权 URL,用户在浏览器完成登录后,用 membrane login complete <code> 完成。连接 Purple Dot 用 membrane connection ensure "https://www.purpledotprice.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,结果含 id、name、description 及输入输出 schema。执行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,参数用 --input '{"key": "value"}' 传入,结果在 output 字段。
当预置动作不覆盖需求时,可通过代理直接请求 Purple Dot API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项(默认 GET)。所有命令可加 --json 获取机器可读输出。
限制与注意:不得向用户索取 API 密钥或令牌,应通过建立连接让 Membrane 在服务端管理完整认证生命周期;资料未提供具体预置动作清单、速率限制、计费方式及权限范围,需以实际查得的动作和官方文档为准。