用途:这是一个 Roll 集成技能,面向需要与 Roll 数据交互、管理组织的场景。用户表达与 Roll 相关的操作意图时使用。资料说明该技能通过 Membrane CLI 与 Roll 通信。
主要能力:资料列出可处理 Dice、Rolls(单次掷骰)与 Rolls(掷骰集合)等概念,并说明可按需使用动作名与参数;可搜索动作、运行动作,也可在动作不覆盖需求时通过代理直接向 Roll API 发送请求。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无交互环境会打印授权 URL,登录后用 membrane login complete <code> 完成。连接:membrane connection ensure "https://www.rollhq.com" --json,状态为 READY 即可继续;BUILDING 时用 npx @membranehq/cli@latest connection get <id> --wait --json 轮询。搜索动作: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、--query、--pathParam 等选项。任何命令可加 --json。
限制:资料未提供具体动作清单、参数细节、费率与配额;认证与凭据由 Membrane 服务端管理,不应向用户索取 API 密钥。