用途:该技能用于让 AI 代理与 Ably(实时数据交付平台)交互,管理数据、记录并自动化工作流,适合需要构建实时或协作类应用时对 Ably 数据与推送进行操作的场景。
主要能力:可列出应用的活动频道与频道元数据,发布消息到指定频道,获取消息历史与频道在线状态(presence)及其历史,获取应用统计与 Ably 服务时间;支持申请 Ably 认证令牌;支持推送通知相关操作,如列出推送频道及其订阅、创建/删除推送频道订阅、注册/更新/查询/删除推送设备注册、发布推送通知。
使用方式:本技能通过 Membrane CLI 调用 Ably,Membrane 自动处理认证与凭证刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://ably.com" --json,用户在浏览器完成认证;若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到 READY。搜索动作: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、--rawData、--query、--pathParam 等选项;任意命令可加 --json 获得机器可读输出。
限制:具体可用的动作字段与参数以实际输出为准;不向用户索取 API 密钥或令牌,应创建连接由 Membrane 管理凭证;官方文档见 https://ably.com/documentation,其余细节暂未提供。