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 어댑터: Zhipu 의 bigmodel.cn 엔드포인트에 대한 OpenAI 호환 Chat Completions.
Zhipu 의 GLM 패밀리는 Ongrid 설치에 가장 많이 사용되는 중국 지역 provider 입니다. bigmodel.cn 엔드포인트는 와이어 레벨에서 OpenAI 호환이므로 같은 eino-openai 어댑터가 처리합니다.
환경 변수
| Var | Default | Notes |
|---|---|---|
ONGRID_ZHIPU_API_KEY | — | 비어 있음 = provider 제거 |
ONGRID_ZHIPU_MODEL | glm-4.7 | 기본 모델 |
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— frontier; 가장 어려운 RCA pass 에 사용.glm-5— GLM 패밀리의 일반 기본.glm-4.7— 카탈로그 기본; 균형 잡힌 비용/품질.glm-4.7-flash— 저렴; Pass-2 추출에 권장.
기본 모델 glm-4.7 은 보수적 선택 — GLM-4.7 은 investigator persona 에 대해 battle-tested; 5.x 는 여전히 도구 사용 루프에 대해 벤치마킹 중.
BaseURL — 중국 기반 마커
Zhipu 는 중국 기반: 기본 https://open.bigmodel.cn/api/paas/v4 엔드포인트는 중국 본토 인프라에 도달 가능한 네트워크에서만 해석. 대부분의 비 CN 클라우드는 VPC 피어링 또는 relay 가 필요.
Settings UI 는 BaseURL 필드를 "중국 기반" 으로 태그하여 CN 외부의 관리자가 relay 가 필요함을 알 수 있게 함. 같은 태그가 Kimi (Moonshot) 에도 존재 — Kimi 참고.
GLM 의 셀프 호스트 변종 (glm-zero 오픈 가중치) 은 Custom provider 슬롯 사용 — Zhipu 의 슬롯은 특히 bigmodel.cn 의 API 형태에 배선.
Zhipu 를 기본으로 만들기
ONGRID_LLM_DEFAULT_PROVIDER=zhipuLLM resolver 버그 메모: default_provider 가 설정되지 않았는데 다중 provider 가 구성됐을 때, resolver 가 첫 정렬 provider id 를 고르고 그 기본 모델을 사용. 미묘한 불일치 발생: 모델이 이긴다고 생각하고 ONGRID_OPENAI_MODEL=glm-4.7 을 설정하면 라우터가 여전히 openai 로 라우팅하고 OpenAI 엔드포인트에 glm-4.7 을 보냄. 수정: default_provider 명시적 설정.
특이점
- 와이어에서 OpenAI 호환 — tool call, streaming, system 메시지 모두 OpenAI 형태 사용. 특별한 어댑터 없음.
- Prompt 민감성 — GLM 은 system 메시지 제약보다 user 메시지 제약을 더 엄격히 따름. Investigator persona 의 10 도구 호출 예산이 이 때문에 특별히 user 메시지에 있음; system 메시지 예산은 v0.7.51 - v0.7.55 에서 무시되었습니다.
- 로케일 — GLM 은 prompt 가 명시적으로 말하지 않는 한 중국어 응답 기본. Ongrid 가 investigator prompt 에 append 하는
LANGUAGE: ...지시는 원래 GLM 용으로 도입되었습니다. [feedback_ai_output_locale] 참고.