Zhipu(GLM)
TL;DR
ONGRID_ZHIPU_API_KEY=...
ONGRID_ZHIPU_MODEL=glm-4.7 # default
ONGRID_ZHIPU_BASE_URL= # optional; defaults to open.bigmodel.cnProvider id:zhipu。SDK 适配器:跑 OpenAI 兼容 Chat Completions,访问 智谱 bigmodel.cn 端点。
智谱 GLM 系列是 Ongrid 装机里中国区最常用的 provider。bigmodel.cn 端点在 wire 层 OpenAI 兼容,所以同一个 eino-openai 适配器处理。
env 变量
| 变量 | 默认 | 备注 |
|---|---|---|
ONGRID_ZHIPU_API_KEY | — | 空 = provider 掉出 |
ONGRID_ZHIPU_MODEL | glm-4.7 | 默认 model |
ONGRID_ZHIPU_BASE_URL | https://open.bigmodel.cn/api/paas/v4 | 自托管或 VPC 端点覆盖 |
ONGRID_ZHIPU_MODELS | glm-5.1,glm-5,glm-4.7,glm-4.7-flash | 目录列表 |
默认目录
开箱 picker 显示:
glm-5.1—— 前沿;做最难的 RCA。glm-5—— GLM 系列通用默认。glm-4.7—— 目录默认;平衡成本 / 质量。glm-4.7-flash—— 便宜;推荐给 Pass-2 抽取。
默认 model glm-4.7 是保守选择 —— GLM-4.7 已经被 investigator persona 打磨过;5.x 还在做 tool-use 循环的基准测试。
BaseURL —— China-based 标记
智谱是 China-based 的:默认 https://open.bigmodel.cn/api/paas/v4 端点只从能到中国大陆基础设施的网络 解析到。多数非 CN 云需要 VPC peering 或中继。
Settings UI 把 BaseURL 字段标 "China-based",让 CN 外的 admin 知道需要中继。 同样的标签也存在于 Kimi(Moonshot) —— 见 Kimi。
GLM 的自托管变体(glm-zero 开源权重)请用 Custom provider 槽 —— 智谱槽专门接 bigmodel.cn 的 API 形状。
把 Zhipu 设为默认
ONGRID_LLM_DEFAULT_PROVIDER=zhipuLLM resolver bug 备忘:default_provider 没设但多个 provider 已配置时, resolver 选字典序第一个 provider id 并用它的默认 model。一种微妙的 不匹配会跟着来:你设 ONGRID_OPENAI_MODEL=glm-4.7 以为 model 赢,路由器 仍然路由到 openai 并把 glm-4.7 发到 OpenAI 端点。修法:显式设 default_provider。
怪癖
- wire 层 OpenAI 兼容 —— tool 调用、流式、system 消息都用 OpenAI 形状。 无特殊适配。
- prompt 敏感 —— GLM 跟 user 消息里的约束比 system 消息里的约束更严格。 investigator persona 的 10 tool 调用预算专门放在 user 消息里就是因为这个; v0.7.51 - v0.7.55 里 system 消息预算被忽略了。
- locale —— GLM 默认中文响应,除非 prompt 明说别的。Ongrid 在 investigator prompt 后追加的
LANGUAGE: ...指令最初就是为 GLM 引入的。 见 [feedback_ai_output_locale]。