扣子Bot本地部署中需配置智谱ChatGLM为备用模型：先获取并验证ZHIPU_API_KEY，再在.env中严格命名并重启服务，接着在Bot设置中启用自定义备用模型，填入合规的API Base URL、Model Name和变量引用密钥，最后通过模拟主模型故障测试切换逻辑是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在扣子（Coze）Bot本地部署中，当主模型服务不可用时，需要快速切换到智谱ChatGLM作为备用推理模型，避免对话中断或报错。这要求配置必须绕过默认的 fallback 逻辑，确保密钥、模型名、请求路径三者严格匹配智谱 API 规范，否则会直接返回 401 错误且无重试机会。
获取并验证智谱 API Key
访问 智谱AI开放平台，登录后进入「API Keys」页面，点击「创建新密钥」。新密钥以 sk- 开头，复制整段字符串（含前缀），不要删减空格或换行。立即用 curl 验证有效性：curl -H "Authorization: Bearer sk-xxx" https://www.php.cn/link/4002628957f70084918b0d02535b3bcaapi/paas/v4/models。若返回 JSON 列表含 glm-5 或 glm-4-plus，说明密钥可用；若返回 {"error": {"code": "invalid_api_key", ...}}，请检查是否开通对应模型权限（需手动勾选 GLM-4/5 系列）。
配置扣子本地环境变量
打开扣子项目根目录下的 .env 文件，在末尾新增一行：
ZHIPU_API_KEY=sk-xxx
注意字段名必须是 ZHIPU_API_KEY，不是 api_key、ZHIPU_KEY 或 zhipu_api_key——扣子 v3.2+ 的 LLM Adapter 层只识别该命名。保存后，必须重启整个扣子服务（docker-compose down && docker-compose up -d），否则环境变量不会被加载。不重启就等于没配。
修改 Bot 配置启用备用模型
进入 Bot 编辑页 → 「设置」→ 「模型与推理」→ 「备用模型」→ 启用「自定义模型」。
方法一：使用 OpenAI 兼容模式（推荐）
填写以下三项：
API Base URL：https://www.php.cn/link/4002628957f70084918b0d02535b3bcaapi/paas/v4/
Model Name：glm-5（不能写 zhipu/glm-5 或 glm-5-flash）
API Key：${ZHIPU_API_KEY}（必须用变量引用，不可硬编码）
方法二：直连智谱 SDK 模式（需额外依赖）
仅当扣子已安装 zhipuai>=2.1.0 时可用。在 Bot 的「插件」→ 「自定义代码」中添加 Python 脚本，调用 ZhipuAI(api_key=...).chat.completions.create(...)，并在返回前显式捕获 AuthenticationError 并抛出可重试异常。此方式绕过扣子内置适配器，但每次更新需重新部署代码。
测试备用模型触发逻辑
第一步：在 Bot 设置中将主模型（如 GPT-4o）临时设为一个无效地址，例如 https://fake.api/；
第二步：向 Bot 发送一条消息，观察日志输出；
第三步：确认日志中出现 Using fallback model: glm-5 及后续 HTTP 200 响应体；
第四步：恢复主模型地址，再次发送消息，验证是否自动切回主模型——这一步失败说明备用链路未真正接入成功。
