Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Çok modelli yönlendirme için iyi uygulamalar

Durum: Etkin Kapsam: genel, güncel durum Son inceleme: 2026-09-13 Sahip: ax-code runtime

Bu rehber, ax-code’u birinci sınıf bir akıl yürütme modeli ve aynı sağlayıcının daha ucuz yardımcı modelleriyle çalıştırmanın önerilen yolunu yakalar.

Temel ilke

Pahalı modeli akıl yürütme yoğun iş için, ucuz modelleri mekanik veya salt okunur iş için kullanın. Asıl tasarruf bağlam süzmesinden gelir: birinci sınıf model yalnızca daha ucuz modellerin veya alt ajanların hazırladığı damıtılmış bağlamı görür.

Önerilen katman ayrımı

Bağlı olan provider/model kimliklerini sabitleyin. Devre dışı birinci taraf plan kimlikleri (alibaba-token-plan, deepseek, zai-coding-plan, minimax-coding-plan) SKU ile hâlâ çözülür, ancak her çağrı önce devre dışı sağlayıcıyı dener ve uyarır. Qwen 3.8 Max geçerli açık bir seçimdir, ürün veya örnek varsayılanı değildir; config.model olmadan örtük varsayılan, bağlı kataloglarda şu sırayla yürür: deepseek-flash, glm-5.3-flash, qwen3.8-flash, MiniMax-M3, grok-4.6, claude-sonnet-5, gpt-6, gemini-3.8-flash, qwen3.8-27b.

Yapılandırma şablonu

Akıl yürütme ajanlarında Pro ile somut bir DeepSeek Flash varsayılanı için depo kökündeki ax-code.json.example dosyasına bakın.

Codex CLI yardımcı modelleri

Codex model kullanılabilirliği, kataloğun metin veya araç yeteneklerine değil, hesabın oturum açma yöntemine ve istemciye bağlıdır. Bu yüzden AX Code adlardan veya aile üst verisinden bir codex-cli küçük modeli çıkarmaz. Açık bir small_model veya sıkıştırma ajanı modeli olmadan sıkıştırma oturum modelini kullanır.

Bir yardımcı model yapılandırırsanız aynı Codex oturum açmasıyla çalıştığını doğrulayın. Bir modelin ChatGPT hesabıyla desteklenmediğine dair açık bir Codex reddi, sıkıştırmanın diğer küçük modelleri atlayarak oturum modelini bir kez denemesine izin verir. Reddedilen deneme oturum geçmişinde kalır. Diğer kimlik doğrulama, faturalama, doğrulama, iptal ve bağlam taşması başarısızlıkları mevcut işlemlerini korur; yerel sağlayıcı gizlilik koruması hâlâ uygulanır.

Etkilenen daha eski bir kurulumda uyumsuz bir small_model veya agent.compaction.model geçersiz kılmasını kaldırın ve agent.compaction.model değerini o Codex hesabıyla hâlihazırda doğrulanmış bir modele açıkça sabitleyin. Yalnızca görünür oturum modelini değiştirmek, ayrı sabitlenmiş bir sıkıştırma modelini geçersiz kılmaz.

Görev türü otomatik yönlendirme kuralları

Düşük değerli tüm görevleri ucuz bir modele otomatik yönlendirmeyin. Onları başarısızlık maliyetine göre ayırın:

• Otomatik yönlendirmek güvenli (salt okunur veya insan tarafından incelenebilir):
  • depo keşfi, grep veya arama önceliklendirme, dosya sınıflandırması
  • kod özetleme, günlük özetleme, kod açıklama
  • birinci sınıf model için bağlam hazırlama
  • belgeler
• Yalnızca isteğe bağlı (mekanik olarak doğrulanabilir ama davranış değişikliklerini gizleyebilir):
  • kalıp kod, lint düzeltmeleri
• Varsayılan olarak asla otomatik yönlendirme (sessiz hatalar pahalıdır):
  • birim testleri
  • yeniden adlandırma veya yeniden düzenleme
  • basit SQL
  • API sarmalayıcı
  • basit CRUD

Son grup, kullanıcı daha ucuz bir modeli açıkça sabitlemedikçe oturum modelinde kalmalıdır.

İşletim kılavuzu

1. Önemsiz olmayan görevlere plan modunda başlayın; böylece danışman, işçi kod yazmadan önce tasarımı doğrular.
2. İşçi döngüye girerse veya doğrulamada iki kez başarısız olursa başarısız sinyalle debug moduna geçin.
3. İki düzeltme akla yakın olduğunda görevi bitirmek için değil, bağımsız tanı için council kullanın.
4. Elle model değiştirmeyi seyrek, akıl yürütme ağırlıklı turlara ayırın; ardından geri dönün.

Bilinen ax-code sınırlamaları

• Provider.getSmallModel(), undefined döndürür; bu, kataloğu katman taşıyan bir family etiketlemeyen ve sabit kodlanmış öncelik listeleriyle eşleşmeyen sağlayıcılar içindir. Yardımcı çağrılar o zaman oturum modeline düşer («sağlayıcı için küçük model yok» olarak günlüğe yazılır).
• Takılı bir işçiden daha güçlü bir modele çalıştırma ortasında yükseltme yoktur.