Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Upaya model (penalaran / varian)

Status: Aktif
Cakupan: keadaan saat ini
Terakhir ditinjau: 2026-07-18
Pemilik: ax-code runtime

AX Code memakai upaya (juga disebut tingkat penalaran) untuk mengatur seberapa keras model aktif bernalar. Upaya bukan mode kerja dan bukan mode penempatan.

Sumbu	Pertanyaan	Contoh
Model	Model yang mana?	Sonnet, Opus, GPT, Qwen lokal
Upaya	Seberapa keras ia harus berpikir?	Auto, Fast, Balanced, Deep, Max
Mode kerja	Bagaimana pekerjaan disusun?	Agent, Council, Arena
Penempatan	Di mana inferensi berjalan?	lokal, cloud, hibrida

Lihat Mode eksekusi untuk mode kerja dan penempatan.

Format kawat

Runtime tetap menyimpan dan mengirim kunci varian yang kompatibel dengan OpenCode dari katalog penyedia (misalnya low, medium, high, xhigh, max). Label UI hanya lapisan presentasi:

Label UI	Kunci kawat yang umum
Auto	(tidak ada — bawaan model / kebijakan)
Off	`none`
Minimal	`minimal`
Fast	`low`
Balanced	`medium`
Deep	`high`
Max	`xhigh`, `max`

Kunci yang tersedia bersifat per model. Model tanpa varian menyembunyikan kontrol upaya.

Dukungan penyedia

Tingkat upaya dibuat otomatis untuk model yang didukung pada penyedia ini:

Penyedia	Mekanisme	Tingkat
Anthropic (Claude)	`effort` pada model saat ini; anggaran penalaran pada model lama	Fast, Balanced, Deep, Max (bergantung model)
OpenAI (GPT-5.x)	`reasoningEffort`	Fast, Balanced, Deep
Google (Gemini 3.x)	`thinkingConfig.thinkingLevel`	Fast, Deep (3.1 menambah Balanced)
Titik akhir kompatibel OpenAI	`reasoningEffort`	Fast, Balanced, Deep
Venice	`reasoningEffort`	Fast, Balanced, Deep
Claude Code CLI	`--effort`	Fast, Balanced, Deep, Max
Codex CLI	`model_reasoning_effort`	Minimal, Fast, Balanced, Deep, Max
Grok Build CLI	`--reasoning-effort`	Fast, Balanced, Deep

Penyedia yang API upayanya belum terverifikasi atau tidak kompatibel (API terhosting Groq, OpenRouter, keluarga DeepSeek/Alibaba/MiniMax/GLM/Mistral, penyedia CLI yang tidak didukung, dan gateway pihak ketiga) tidak mengekspos tingkat bawaan; /effort menjelaskan hal ini alih-alih gagal diam-diam. Tetapkan tingkat khusus di bawah provider.<id>.models.<model>.variants pada ax-code.json ketika penyedia mendokumentasikan bentuk opsi yang didukung.

Cara mengatur upaya

TUI

Siklus: ctrl+t (ikatan tombol variant_cycle) — berjalan Auto → setiap tingkat yang tersedia → Auto
Pemilih: /effort (alias /variant, /thinking); pada model tanpa tingkat, ini membuka dialog penjelasan
Status: kaki prompt menampilkan penanda upaya saat ini jika model mendukung tingkat; pesan yang terkirim menampilkan label upaya pada baris metadata
CLI: ax-code run --variant high

Desktop

Kontrol penalaran di samping pemilih model
Siklus papan ketik (jalur ikatan tombol yang sama dengan siklus varian model)
Label memakai pemetaan ramah yang sama dengan TUI

Bawaan dan perilaku otomatis

Auto berarti tidak ada penimpaan pengguna yang eksplisit untuk model itu.
Saat Auto aktif, ReasoningPolicy menerapkan garis dasar seimbang (medium / varian penyedia default) agar model benar-benar mengaktifkan penalaran atau mengirim bendera upaya, bukan menghilangkannya.
Ini berlaku baik untuk model dengan reasoning: true maupun penyedia yang hanya mengekspos upaya sebagai varian (misalnya CLI Claude Code / Codex / Grok Build, yang melaporkan reasoning: false karena keluaran tidak tembus pandang bagi AI SDK).
Kebijakan masih dapat menaikkan kedalaman ke Deep untuk mode rencana, mode otonom, atau prompt berisiko tinggi (dan untuk kegagalan berulang, ketidakpastian tinggi, atau radius dampak tinggi ketika sinyal itu tersedia).
Ketika pengguna memilih upaya eksplisit, penimpaan itu menang untuk giliran berikutnya (kebijakan tidak melawannya). Konfigurasi atau opsi agen yang sudah mengatur penalaran/effort/thinking juga dibiarkan.
Upaya diingat per model pada preferensi model lokal (model.json di direktori keadaan TUI).

Konfigurasi

Sematkan bawaan pada suatu agen:

{
  "agent": {
    "plan": {
      "variant": "high"
    }
  }
}

Tetapkan atau nonaktifkan varian penyedia di bawah provider.<id>.models.<model>.variants pada ax-code.json (bentuk yang sama dengan OpenCode).

Praktik terbaik

Utamakan Auto atau Balanced/Deep untuk kerja harian; simpan Max untuk penelusuran bug yang sulit atau arsitektur.
Jangan menciptakan mode global keempat “lite / xfast / max” yang bersaing dengan Agent/Council/Arena.
Pertahankan model, upaya, dan mode kerja sebagai kontrol terpisah pada salinan UI.
Saat berganti model, upaya tersimpan yang tidak valid kembali ke Auto untuk model itu.

Mode eksekusi — Agent / Council / Arena dan penempatan hibrida
Penyedia yang didukung — penyedia mana yang mengekspos model
Varian model OpenCode: https://opencode.ai/docs/models/