用途:该技能用于让 AI 代理与 Zoho Subscriptions(订阅管理与循环计费软件)交互,管理数据、记录并自动化工作流,适用于需要读取或操作 Zoho Subscriptions 数据的场景。
主要能力:可操作的对象包括 Subscription(订阅)、Customer(客户)、Card(卡)、Addon(附加项)、Coupon(优惠券)、Invoice(发票)、Transaction(交易)、Plan(套餐)、Metered Variable(计量变量)。通过 Membrane 预置动作完成,Membrane 自动处理认证与凭证刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾。连接:membrane connection ensure "https://www.zoho.com/us/subscriptions" --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。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。动作不覆盖时可走代理:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。
限制与注意:官方 API 文档为 https://www.zoho.com/subscriptions/api/v1/。建议优先使用 Membrane 预置动作而非直接调用 API,不要向用户索取 API 密钥或令牌,由 Membrane 在服务端管理认证生命周期。资料未提供具体动作清单、参数细节、计费与平台支持范围,需以实际查询结果为准。