用途:该技能用于让 AI 代理与 Yoco 数据交互。Yoco 是面向南非小型企业的销售点与支付处理平台,提供收款、库存管理和销售跟踪工具,主要供商户和创业者简化业务运营。官方文档:https://developers.yoco.com/
主要能力:围绕支付、退款、结算和交易提供操作,包括创建支付、获取支付、列出支付;创建退款、获取退款、列出退款;获取结算、列出结算;获取交易、列出交易。具体动作名称和参数按需使用。
使用方式:通过 Membrane CLI 与 Yoco 交互,Membrane 自动处理认证和凭据刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 结束。连接 Yoco:membrane connection ensure "https://www.yoco.co.za/" --json,用户在浏览器完成认证,输出包含连接 id;若状态为 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 --json,传参用 --input '{"key": "value"}'。当动作不覆盖需求时,可通过代理直接请求 Yoco API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要查询或操作 Yoco 支付、退款、结算、交易数据,或将其接入自动化工作流的场景。
限制:资料未提供具体费率、价格、支持平台或效果数据;使用前需完成 Membrane 登录与 Yoco 连接认证,凭据由 Membrane 服务端管理,不应向用户索取 API 密钥或令牌。