Model Switch Notify

模型切换通知。当agent使用的模型发生变化时,第一时间通知当前会话用户。触发条件:agent首次回复、模型切换后首次对话、用户询问当前模型。所有agent可使用的公共skill。

安装

概览

什么是Model Switch Notify

模型切换通知(Model Switch Notify)是一个专为智能代理(Agent)设计的公共技能工具,旨在解决多模型环境下用户无法及时获知模型变更的问题。该工具通过自动检测 Agent 当前使用的语言模型变化,并在关键节点主动向用户推送通知,确保沟通的透明性和连续性。无论是首次启动、模型切换后的首次对话,还是用户主动询问当前模型,系统都能第一时间响应并告知最新状态。其核心设计基于轻量级 SQLite 数据库存储,支持跨会话持久化记录,同时具备消息中断恢复机制,极大提升了用户体验的稳定性与可预期性。

该工具采用心跳检测机制,在每次会话回复时自动比对当前模型与历史记录,一旦发现变更即触发通知流程。若因网络或接口问题导致通知发送失败,系统会将待发消息暂存于数据库中,待下次会话开始时优先处理,避免信息丢失。整个流程无需复杂配置,仅需集成一段调用脚本即可无缝嵌入现有 Agent 工作流,适用于多种通信渠道如 QQ 机器人、企业微信等。

作为一款通用型 Skill,模型切换通知不依赖特定平台或框架,仅通过标准命令行交互实现功能扩展。开发者可在 Agent 回复前执行检查命令,根据返回结果决定是否附加通知内容。同时,工具提供完整的状态查询、重置及列表管理接口,便于运维监控和调试。从技术架构上看,它摒弃了早期版本中的 JSON 文件存储方式,全面转向 SQLite,增强了数据一致性与并发处理能力,为大规模部署提供了坚实基础。

核心功能特点

  1. 自动检测模型切换并在关键节点推送通知
  2. 基于 SQLite 数据库实现跨会话状态持久化
  3. 内置心跳检测机制,每次会话回复时自动校验模型变更
  4. 支持消息中断恢复,未送达通知会在下次会话优先发送
  5. 提供命令行工具链,包括检查、更新心跳、设置中断通知等功能
  6. 兼容多种通信渠道,易于集成到各类 Agent 系统中

适用场景

模型切换通知最典型的应用场景是面向用户的智能客服或编程助手类 Agent。例如,在一个支持多种推理模型的代码生成机器人中,当团队将默认模型从 ollama/glm-5:cloud 切换至更擅长编码的 ollama/qwen3.5-code 后,所有正在进行的会话会立即收到‘老板,模型已切换’的提示,避免用户因不知情而产生错误答案。这种即时反馈机制尤其适用于需要频繁调整模型参数的研发团队,确保每位成员始终使用最新最优能力。

另一个重要使用场景是企业内部知识库问答系统。假设某部门部署了一个能调用不同领域大模型的智能助手,当法律咨询模块临时启用高精度合规模型而暂停通用回答时,系统会自动向当前提问者发送中断通知,防止误用导致风险。此外,若因服务器维护造成通知延迟,工具也能在服务恢复后补发遗漏信息,保障业务连续性。对于需要审计日志的场景,SQLite 存储还支持按时间戳追溯每次模型变更事件,满足合规要求。

该工具还特别适合多租户环境下的 SaaS 产品。不同客户可能订阅不同等级的模型服务,当管理员为其分配新模型时,无需手动逐一提醒用户,只需触发一次切换动作,所有活跃会话将自动同步更新认知。尤其在教育或培训场景中,教师更换教学模型后,学生端立即可见变更说明,提升课程连贯性。整体而言,任何涉及动态模型调度且直接面向终端用户的 AI 应用,均可借助此工具显著增强交互体验与信任感。