Skip to content

Zhipu(GLM)

TL;DR

bash
ONGRID_ZHIPU_API_KEY=...
ONGRID_ZHIPU_MODEL=glm-4.7                  # default
ONGRID_ZHIPU_BASE_URL=                      # optional; defaults to open.bigmodel.cn

Provider 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_MODELglm-4.7默认 model
ONGRID_ZHIPU_BASE_URLhttps://open.bigmodel.cn/api/paas/v4自托管或 VPC 端点覆盖
ONGRID_ZHIPU_MODELSglm-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 设为默认

bash
ONGRID_LLM_DEFAULT_PROVIDER=zhipu

LLM 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]。

另见

  • 模型概览
  • 路由 —— WithProvider("zhipu")
  • RCA —— 为什么预算指令住在 user 消息里,以及 locale 标志怎么工作。