用途:该技能用于让 AI 代理与 Hello Retail 数据交互。Hello Retail 是面向电商企业的 AI 个性化平台,帮助零售商提供个性化购物体验,以提升销售与客户忠诚度;电商营销与商品运营人员用它优化产品推荐、搜索结果和内容。官方文档:https://helloretail.com/help/
涉及数据对象:客户、订单、订单行、产品、促销。
使用方式:通过 Membrane CLI 与 Hello Retail 交互,Membrane 自动处理认证与凭据刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
建立连接:membrane connection ensure "https://helloretail.com/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪;READY 即可继续,CLIENT_ACTION_REQUIRED 需按 clientAction 提示操作,CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。
查找与执行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json;执行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在响应的 output 字段。
代理请求:当现有动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接调用 Hello Retail API,Membrane 自动拼接基础 URL 并注入认证头,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与注意:资料未提供具体动作清单、参数细节、收费与价格信息;建议先搜索已有动作再自行构建,并让 Membrane 管理凭据,不要向用户索取 API 密钥或令牌。