用途:该技能用于让 AI 代理与 Novu(开源通知基础设施)交互,管理数据、记录和自动化通知工作流。Novu 面向产品工程师,提供构建通知体验所需的模块,支持跨邮件、短信、推送和应用内等多渠道通知。官方文档:https://docs.novu.co/。
主要能力:资料涉及 Novu 的通知模板、步骤、订阅者、布局、集成、环境、主题、消息、推送流、事件和租户等对象,可通过动作名称与参数进行操作。Membrane 会处理认证与凭证自动刷新,代理只需关注集成逻辑。
使用方式:先全局安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无界面环境会打印授权 URL,用户登录后执行 membrane login complete <code>。连接 Novu:membrane connection ensure "https://novu.co/" --json,用户完成浏览器认证后获得连接 id;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传入参数用 --input '{"key": "value"}'。可用代理请求直接访问 Novu API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可输出机器可读 JSON。
适用场景:需要在代理中自动发现并执行 Novu 相关操作,或通过代理调用 Novu API 完成通知模板、订阅者、消息等管理时使用。
限制:具体可用动作和字段以实际 action list 结果为准;认证由 Membrane 管理,不应向用户索取 API 密钥或令牌;连接出现 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED 时需按状态处理或排查。