用途:该技能用于通过 Membrane CLI 与 Square 支付及电商平台交互,管理客户、支付、订单、发票、预订、目录、门店等数据。
主要能力:提供预置动作,包括列出客户、支付、发票、预订、目录、门店,搜索客户、订单、目录,获取客户、支付、发票、预订、目录对象、订单,以及创建客户、支付、发票、预订、订单等。当预置动作不覆盖需求时,可通过代理直接向 Square API 发送请求。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会输出授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "" --json,若状态为 BUILDING 则用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。
适用场景:需要读取或创建 Square 客户、支付、订单、发票、预订、目录、门店等数据的自动化流程。
限制:认证与凭据刷新由 Membrane 处理,不应向用户索取 API 密钥或令牌;具体动作参数与返回结构需通过 action list 查询;官方文档见 https://developer.squareup.com/docs/。