用途:该技能用于让 AI 代理与 Privyr 数据管理平台交互,管理其中的记录(Records)数据。Privyr 被描述为数据管理平台,Records 是其核心数据。
主要能力:对 Records 提供 create、read、update、delete、list 操作。实际可用动作需通过 Membrane 动作列表按意图搜索发现,资料未逐一列出全部动作。
必要用法:
- 安装 CLI:npm install -g @membranehq/cli@latest
- 登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,完成后执行 membrane login complete <code>。命令可加 --json 获得机器可读输出。
- 建立连接:membrane connection ensure "https://www.privyr.com/" --json,用户在浏览器完成认证,返回连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直到 READY。状态还可能为 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR、SETUP_FAILED。
- 搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。
- 运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可加 --input '{"key": "value"}' 传参。
- 代理请求:当动作不覆盖需求时,用 membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项,Membrane 自动补全基础 URL 并注入认证头。
适用场景:需要以编程方式在 Privyr 中管理客户或业务记录数据时。
限制:Membrane 负责认证与凭证刷新,不应向用户索取 API 密钥或令牌。资料未说明具体收费、价格、平台范围及所有可用动作清单,这些暂未提供。