用途:这是一个与 Reviews.io 平台交互的集成技能。Reviews.io 是收集和展示客户评论及用户生成内容的平台,电商企业用它建立信任、改善在线声誉并通过社交证明提升销售。当用户希望与 Reviews.io 数据交互时使用本技能。
覆盖范围:评论、评论请求、产品、邀请、用户、公司档案、账户、账单、集成。官方文档:https://developers.reviews.io/
使用方式:通过 Membrane CLI 与 Reviews.io 交互,Membrane 自动处理认证和凭证刷新。先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。若为无头环境,命令会打印授权 URL,用户完成登录后执行 membrane login complete <code>。所有命令可加 --json 获取机器可读输出。
建立连接:membrane connection ensure "https://reviews.io/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到状态不再是 BUILDING。READY 表示连接就绪;CLIENT_ACTION_REQUIRED 表示用户或代理需采取行动,clientAction 描述所需操作;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,查看 error 字段。
发现与执行操作:用自然语言描述意图搜索,如 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参数用 --input '{"key": "value"}'。
代理请求:当现有操作不覆盖需求时,可通过 Membrane 代理直接请求 Reviews.io API:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
限制与说明:建议优先使用 Membrane 与外部应用通信,利用预置操作的内置认证、分页和错误处理;先发现再构建,先搜索现有操作再写自定义 API 调用;凭证由 Membrane 管理,不要向用户索要 API 密钥或令牌。资料未提供具体收费、价格、平台限制等细节。