用途:该技能用于与 PrivyID 身份验证平台交互,管理数据、记录并自动化工作流,适用于需要处理 PrivyID 用户、凭据、模板等数据的场景,例如 KYC/AML 合规与欺诈防范。官方文档:https://developers.privy.id/
主要能力:通过 Membrane CLI 调用 PrivyID,涵盖 User、Credential、Template 等对象的操作。Membrane 自动处理认证与凭据刷新,减少认证层工作量。支持搜索动作、运行动作,以及通过代理直接调用 PrivyID API(自动附加基础 URL 并注入认证头,凭据过期可透明刷新)。
安装:
npm install -g @membranehq/cli@latest
认证:
membrane login --tenant --clientName=<agentType>
无交互环境会打印授权 URL,登录后执行 membrane login complete <code>。任意命令加 --json 可得机器可读输出。
连接 PrivyID:
membrane connection ensure "https://privy.id/" --json
用户在浏览器完成认证。若返回 state 为 BUILDING,可轮询:
npx @membranehq/cli connection get <id> --wait --json
状态为 READY 即可继续;CLIENT_ACTION_REQUIRED 表示需用户或代理执行操作。
搜索动作:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
运行动作:
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
代理请求:
membrane request CONNECTION_ID /path/to/endpoint
支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与建议:优先使用 Membrane 预构建动作而非手写 API 调用;先搜索已有动作再开发;不要向用户索取 API 密钥或令牌,应创建连接由 Membrane 服务端管理认证。具体可用动作与字段以实际查询结果为准,其余细节暂未提供。