GLM (Z.ai)
Adapter harness Apothem untuk GLM (Z.ai) sebagai backend model yang dapat dikonfigurasi.
Vendor: Z.ai
Nama instalasi: glm
Status: GA
Konfigurasi native: <project>/.apothem/providers/glm.toml
Adapter glm mengonfigurasi GLM (Z.ai) sebagai backend model. Alat yang
menggunakan protokol yang kompatibel dengan Anthropic atau yang kompatibel
dengan OpenAI diarahkan ke GLM dengan menyetel base URL backend dan sebuah
kunci, dan Anda memilih adapter ini dengan --harness glm seperti adapter lain.
Adapter ini menulis berkas konfigurasi penyedia yang mencatat kedua permukaan
kompatibilitas tersebut sehingga alat kompatibel apa pun dapat disambungkan ke
keluarga model GLM.
Z.ai juga menyediakan alat pengodean resmi miliknya sendiri, ZCode, yang oleh dokumentasi Z.ai disebut sebagai "Agentic Development Environment". Adapter ini tidak mengonfigurasi ZCode. Apothem belum memeriksa permukaan konfigurasi ZCode sendiri, sehingga adapter tidak menulis apa pun untuknya.
Instalasi
apothem install --harness glm --project /path/to/projectAdapter menulis satu berkas penyedia berlingkup proyek yang mencatat endpoint backend GLM dan placeholder yang dapat dikonfigurasi operator.
Berkas yang ditulis: <project>/.apothem/providers/glm.toml
Pemetaan profil ke konfigurasi native
Berkas penyedia mencatat dua backend. Backend yang kompatibel dengan Anthropic
menggunakan base URL https://api.z.ai/api/anthropic; alat yang menggunakan
protokol Anthropic dirutekan ke GLM dengan menyetel ANTHROPIC_BASE_URL,
ANTHROPIC_AUTH_TOKEN, dan secara opsional API_TIMEOUT_MS. Tabel
[backends.anthropic_compatible.env] di dalam berkas mencantumkan variabel-variabel
tersebut dan juga ANTHROPIC_DEFAULT_OPUS_MODEL,
ANTHROPIC_DEFAULT_SONNET_MODEL, dan ANTHROPIC_DEFAULT_HAIKU_MODEL, yang
memetakan peran opus, sonnet, dan haiku milik alat ke model GLM. Backend yang
kompatibel dengan OpenAI menggunakan base URL
https://api.z.ai/api/coding/paas/v4. Token autentikasi adalah placeholder
yang Anda ganti dengan kunci Z.ai Anda sendiri — Apothem tidak pernah menulis
rahasia sungguhan. ID model mudah berubah antarversi, sehingga Apothem tidak
mematok satu pun; berkas tersebut membawa placeholder <GLM_MODEL_ID> yang
Anda isi dari dokumentasi Z.ai yang
terkini. Tidak ada apa pun dari profil bersama yang masuk ke berkas ini; berkas
ini adalah templat tetap.
Pemetaan peran ke model
Pernyataan Z.ai sendiri tentang pemetaan peran ke model saling bertentangan,
sehingga berkas tersebut membiarkan ketiga nilai ANTHROPIC_DEFAULT_*_MODEL
sebagai placeholder dan membawa komentar TODO(clarify) di atasnya. Anda yang
memutuskan pemetaan mana yang dipakai:
- Contoh
settings.jsonmanual dalam panduan penyiapan kompatibel-Anthropic milik vendor memetakan opus dan sonnet keglm-5.3[1m]dan haiku keglm-5.3-flash[1m], serta menyetelCLAUDE_CODE_AUTO_COMPACT_WINDOWke1000000. - Pemetaan default yang dinyatakan dalam panduan yang sama mencantumkan
GLM-5.3-Flashuntuk ketiga peran. - Alat
@z_ai/coding-helpermilik Z.ai menggunakan defaultglm-5.3-flash, menambahkan[1m]ke ketiga peran, dan menulis jendela pemadatan1048576.
Apothem tidak mematok satu pun dari nilai-nilai ini dan tidak memilih di antara keduanya.
Catatan kompatibilitas
Backend GLM tidak mengekspos permukaan untuk aturan, command, skill, atau hook,
sehingga adapter hanya menulis berkas penyedia backend dan tidak ada yang lain.
Apothem belum memeriksa apakah ZCode mengekspos permukaan semacam itu. Kunci
Z.ai Anda dan pilihan ID model Anda tetap menjadi milik operator. Konvensi permukaan vendor yang menjadi
sandaran adapter dipatok di src/apothem/harnesses/glm/STANDARD-CONVENTION-PIN.md,
yang di-snapshot terhadap dokumentasi Z.ai yang berlaku.
GLM menjalankan keluarga model GLM dari Z.ai; lihat referensi konfigurasi vendor untuk permukaan konfigurasi backend, model, dan kompatibel-Anthropic yang terkini.
Verifikasi
apothem verify --harness glm --project /path/to/projectPerintah verify memastikan bahwa:
- Konfigurasi native ada di jalur yang diharapkan.
- Berkas penyedia ada dan tidak kosong.
- Rutin verifikasi khusus adapter melaporkan keberhasilan.
Pembaruan
apothem update --harness glm --project /path/to/projectBerkas penyedia menjadi milik Anda begitu berkas itu ada. install dan update
sama-sama menulis templat hanya ketika .apothem/providers/glm.toml tidak ada,
dan keduanya tidak pernah menimpanya setelah itu, sehingga referensi kunci dan
pilihan model Anda bertahan pada setiap eksekusi ulang. Untuk mengambil templat
yang lebih baru, pindahkan berkas Anda ke tempat lain, jalankan update, lalu
salin nilai-nilai Anda ke berkas yang baru.
Pencopotan
apothem uninstall --harness glm --project /path/to/projectMenghapus berkas penyedia hanya ketika Apothem yang membuatnya dan berkas itu masih berupa templat yang belum disunting, dengan terlebih dahulu mencadangkannya di bawah akar cadangan Apothem. Berkas yang belum disunting dan ditulis oleh rilis sebelumnya ikut terhitung ketika catatan instalasi Apothem untuk proyek tersebut menunjukkan bahwa Apothem yang menulis berkas itu: manifes mencatat digest setiap templat yang pernah dikirimkan ke proyek. Tanpa catatan instalasi, hanya salinan persis dari templat saat ini yang dihapus. Berkas yang Anda buat atau sunting dibiarkan di tempatnya. YAML profil bersama dan mesin Apothem tidak terpengaruh.
Gerbang konformitas
python -m apothem.conformity.gate --all .Pemecahan masalah
| Gejala | Perbaikan |
|---|---|
| Berkas konfigurasi tidak ditemukan | Jalankan ulang apothem install --harness glm --project /path/to/project |
| Verifikasi gagal | Berkas penyedia hilang atau kosong. Jika berkas hilang, jalankan apothem update --harness glm --project /path/to/project. Jika berkas kosong, pindahkan .apothem/providers/glm.toml ke tempat lain terlebih dahulu, lalu jalankan update dan verifikasi lagi |
| Konten konfigurasi tidak terduga | Sunting .apothem/providers/glm.toml secara langsung; Apothem tidak pernah menulis ulang berkas yang sudah ada, dan profil bersama tidak menambahkan apa pun ke dalamnya. Untuk templat yang baru, pindahkan berkas ke tempat lain lalu jalankan apothem update --harness glm --project /path/to/project |
Tombol konfigurasi
| Flag | Default | Deskripsi |
|---|---|---|
--dry-run | false | Pratinjau instalasi tanpa menulis berkas. |
Lihat juga
- Semua harness — katalog lengkap alat yang didukung
- Panduan instalasi — pasang Apothem ke dalam harness ini
- Referensi
apothem harnesses— tampilkan daftar dan periksa adapter dari CLI