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

Model seçimi ve kurtarma

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-10-10 Sahip: ax-code runtime

AX Code tam sağlayıcı ve model seçimlerini korur. Bir sağlayıcı bağlamak onu otomatik bir kurtarma havuzuna eklemez. Yapılandırılmış bir yedek yoksa geçici başarısızlıklar seçilen hedefi mevcut yeniden deneme sınırı içinde yeniden dener, sonra durur.

Sıralı bir yedek yapılandırın

llm_routing.fallback değerini kullanıcı yapılandırmasında, AX_CODE_CONFIG ile seçilen özel bir yapılandırmada veya açık AX_CODE_CONFIG_CONTENT içinde ayarlayın. Hedefler tam çiftlerdir; model kimlikleri eğik çizgi içerebilir. Örneğin:

{
  "model": "my-gateway/openai/gpt-oss-120b",
  "llm_routing": {
    "fallback": [
      { "providerID": "my-gateway", "modelID": "my-backup-model" },
      { "providerID": "my-other-provider", "modelID": "my-approved-model" }
    ]
  }
}

Bu örnekleri yapılandırılmış sağlayıcılarınızdaki tam kimliklerle değiştirin. Liste en fazla sekiz ayrı hedefe izin verir. Boş veya yok, hedef değişikliği olmadığı anlamına gelir. Proje ve uzak yapılandırma kullanıcı bağışlarını daraltabilir ama ekleyemez veya yeniden sıralayamaz. Yönetilen kısıtlar son bir tavan sağlar. Yapılandırılmış sonraki hedef eksikse kurtarma durur; AX Code başka bir katalog girdisinin yerine koymaz.

Olağan geçici hız sınırları, tanınan aşırı yük ve sunucu hataları aynı hedef yeniden denemelerinden sonra bu listede ilerleyebilir. Kimlik doğrulama, izin, kalıcı kota ve geçersiz istek başarısızlıkları bir geçişi yetkilendirmez. Yerel sağlayıcı oturumları otomatik olarak uzaktan çıkarıma geçmez. İptal diziyi durdurur. Güncel istek çıktı yayımladıktan veya bir araç başlattıktan sonraki kurtarma da durur; etkileri yeniden oynatmak yerine kısmi ilerlemeyi korur.

İşlemci normalde ilk denemeden sonra beş aynı hedef yeniden denemesine izin verir; eşzamanlılık sınırı hatalarının sekiz yeniden deneme sınırı vardır. Sağlayıcı devre kesicileri ve dış hata sınırları daha erken durdurabilir. Başarılı araç döngüsü adımları yeni isteklerdir, önceki işin yeniden denemesi değildir. AI SDK yeniden denemeleri denetlenen doğrudan üretim yerlerinde kapalıdır. Dış CLI ve ağ geçidi iç denemeleri opak kalabilir.

Yardımcı iş ve mevcut yapılandırma

small_model olmadan başlık, özet ve sıkıştırma birincil modeli devralır. Açık bir small_model veya role özgü ajan modeli hâlâ o tam hedefi seçer. Geçersiz sabitlemeler başka bir sağlayıcıya veya modele geçmek yerine başarısız olur. İsteğe bağlı başlık ve özet işi yerel başlık ve atlama davranışını korur. Sıkıştırma başarısız olunca dökümü korur ve modelleri yalnızca yapılandırılmış kurtarma yoluyla değiştirir.

Yapılandırılmış birincil modeller, görev, ajan ve komut sabitlemeleri ile kaydedilmiş son seçimler de tam kalır. Kullanılamayan bir sabitlemeyi açıkça kaldırın veya düzeltin. Yapılandırılmış veya son seçimi olmayan başsız çalıştırmalar --model gerektirir. Görünür model seçici öneriler sunabilir, ancak bu öneriler bir kurtarma listesi olmaz.

İsteğe bağlı karmaşıklık sınıflandırıcısı açık bir yardımcı model gerektirir; biri yoksa sınıflandırma atlanır. Birincil verildiğinde istenen sağlayıcıya sabitlenir. Açık birincil seçimler ajan konu yönlendirmesinden sonra da kalır.

Etkin yapılandırmayı inceleyin

ax-code debug routing
ax-code debug routing --model my-gateway/openai/gpt-oss-120b

Bu, tam birincili, sıralı yedeği, yardımcı seçimi, ajan sabitlemelerini ve yeniden deneme sınırını yazdırır. Bir model isteği göndermez veya model kullanılabilirliğini yoklamaz. Normal yapılandırma yüklemesi yapılandırılmış uzak ayarları getirebilir. Bu bir yapılandırma açıklamasıdır, geçmiş ağ geçidi davranışının yeniden kurulması değildir.

Kullanıcı iletileri seçimin bir istekten, bir ajan sabitlemesinden, karmaşıklık veya hibrit yönlendirmeden ya da oturum ve yapılandırma varsayılanlarından gelip gelmediğini kaydeder. Bu kaynak yerel girişi anlatır; request bir API istemcisini kimin işlettiğini tasdik etmez. İstek kanıtı seçilen amacı ve hedefi kaydeder. Modelin ürettiği öz açıklamalar ve bellek veya araç örneklerindeki model adları yönlendirme kanıtı değildir. AX Trust ve dış sağlayıcılar yukarı akış yönlendirme ve yetkilendirme sorumluluğunu korur.