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

Auto-Route yönlendirmesi

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

Auto-route, ax-code içinde iki bağımsız yönlendirme davranışını denetler:

1. Anahtar sözcük yönlendirmesi — varsayılan olarak etkindir. Bir ileti bir uzmanın anahtar sözcükleri veya kalıplarıyla eşleşince ajanı değiştirir. 1 ms altında ateşlenir ve LLM çağrısı gerektirmez. Yönlendirme açıkça kapatıldığında, kullanıcı bir ajanı açıkça adlandırdığında veya ileti geçerli ajanı koruyan sentetik bir sürdürme olduğunda atlanır.

2. Karmaşıklık yönlendirmesi — isteğe bağlıdır, auto-route anahtarıyla açılır. Hafif bir LLM çağrısı her iletiyi low, medium veya high karmaşıklığı olarak sınıflar. low karmaşıklığındaki iletiler, gecikmeyi azaltmak için açıkça yapılandırılmış small_model tarafından otomatik karşılanır.

Varsayılan olarak auto-route kapalıdır — karmaşıklık yönlendirmesi devre dışıdır. Anahtar sözcük yönlendirmesi bu anahtardan ayrıdır ve yapılandırma kapatmadıkça veya açık bir ajan seçimi atlamadıkça varsayılan olarak etkin kalır.

Hızlı başlangıç

TUI içinden değiştirin:

• İsteme /smart-llm yazın veya
• Ctrl+P tuşuna basın ve “auto-route” arayın veya
• Durum çubuğundaki Auto-route Açık/Kapalı göstergesine tıklayın

Durum çubuğu güncel durumu gösterir:

• Auto-route açık (mor metin) — karmaşıklık yönlendirmesi etkindir
• Auto-route kapalı (beyaz metin) — karmaşıklık yönlendirmesi devre dışı (varsayılan)

Ayar, oturumlar boyunca ax-code.json içinde kalır.

Nasıl çalışır

Gerçek kaynak

Bu sayfa kullanıcıya dönük davranışı özetler. Davranış değişince belgeleri şunlara karşı doğrulayın:

• packages/ax-code/src/agent/router.ts, anahtar sözcük yönlendirme kuralları ve classifyComplexity() için.
• Anahtar sözcük yönlendirmesinin ne zaman atlandığı ve karmaşıklık sınıflamasının ne zaman çalıştığı için packages/ax-code/src/session/prompt.ts.
• Varsayılan, ortam, yapılandırma ve kalıcılık davranışı için packages/ax-code/src/server/routes/smart-llm.ts.
• Yönlendirme yapılandırma alanları ve kullanımdan kaldırma notları için packages/ax-code/src/config/schema.ts.
• Eğik çizgi komut adları, takma adlar, etiketler ve durum çubuğu eylemleri için packages/ax-code/src/cli/tui/app.tsx.
• Beklenen etkinleştirme davranışı için packages/ax-code/test/agent/router.test.ts ve TUI eşitleme testleri.

Anahtar sözcük yönlendirmesini ve hızlı model karmaşıklık yönlendirmesini tek özellik olarak anlatmayın. Bilerek ayrıdırlar.

Anahtar sözcük yönlendirmesi (varsayılan etkin, <1 ms)

Kullanıcı iletileri her uzman ajan için anahtar sözcük ve düzenli ifade kalıplarıyla eşleştirilir (güvenlik, mimar, hata ayıklama, performans, devops, test). Bir eşleşme ≥ 0.4 güven puanı alırsa ajan hemen değişebilir — LLM çağrısı yapılmaz. Bu yol auto-route anahtarından bağımsızdır; ancak yönlendirme kapalıyken, kullanıcı bir ajanı açıkça adlandırdığında veya geçerli tur sentetik sürdürme için mevcut bir ajanı korurken atlanır.

Karmaşıklık yönlendirmesi (yalnızca auto-route, ~200-500 ms)

Auto-route açıkken her ileti classifyComplexity() üzerinden hızlı ve ucuz bir modele gönderilir. Bu LLM çağrısı bir karmaşıklık tahmini döndürür (low / medium / high):

• low karmaşıklığındaki iletiler açıkça yapılandırılmış small_model modelini otomatik kullanır
• medium ve high iletileri her zamanki gibi varsayılan modeli kullanır
• small_model yoksa veya kullanılamıyorsa atlanır
• 1.5 saniye zaman aşımı — LLM yavaşsa veya kullanılamıyorsa sessizce geri düşer
• Tüm hatalar sessizce yakalanır — kullanıcıyı asla engellemez

Karmaşıklık yönlendirmesi ajan yönlendirmesinden bağımsızdır. Hangi uzman ajanın kullanılacağını sınıflamaz — bunu tümüyle anahtar sözcük yönlendirmesi ele alır.

Auto-Route neye yarar

Anahtar sözcük yönlendirmesi teknik anahtar sözcükler için uzman ajan seçimini ele alır. Karmaşıklık yönlendirmesi, yanıtın ne kadar akıl yürütme gerektirdiğine göre uygun model katmanını seçer.

Sakıncalar ve değerlendirmeler

Gecikme

Karmaşıklık yönlendirmesi, sınıflama çağrısını tetikleyen iletilere 200-500 ms ekler. Anahtar sözcük yönlendirmesi (her zaman etkin) etkilenmez — <1 ms içinde döner.

Küçük bir model gerekir

Karmaşıklık yönlendirmesi açık bir small_model yapılandırması gerektirir. AX Code, model adlarından bir yardımcı çıkarmaz ve kullanılamayan bir sabitlemeyi başka bir sağlayıcıya taşımaz. Kullanılabilir bir yardımcı yoksa sınıflama atlanır ve seçilen birincil korunur. Bkz. Model kurtarma.

Belirteç kullanımı

Her sınıflama çağrısı yaklaşık 100-200 girdi belirteci ve 10-20 çıktı belirteci kullanır — ardından gelen ana LLM çağrısına göre ihmal edilebilir.

Açık seçimin yerine geçmez

Auto-route otomatik model katmanı seçimini iyileştirir ama yalnızca doğal dile bakarak uzman ajanlara yönlendiremez. Doğru uzmanın önemli olduğu kritik görevlerde ajan seçici veya @agent anılması daha güvenilirdir.

Yapılandırma

TUI içinden anahtar

/smart-llm veya komut paletini kullanın (Ctrl+P → “Auto-route aç/kapat”). Değişiklik hemen yürürlüğe girer ve projenizin ax-code.json dosyasına kaydedilir.

Yapılandırma dosyası

{
  "routing": {
    "llm": true
  }
}

Ortam değişkeni

AX_CODE_SMART_LLM=true ax-code

Ortam değişkeni yapılandırma dosyası ayarını geçersiz kılar.

Auto-Route ve diğer ayarlar

Auto-Route ne zaman açılır

Şu durumda açın:

• Basit soruların daha ucuz ve daha hızlı bir modele otomatik gitmesini istiyorsanız
• Düşük karmaşıklıktaki alışverişlerde belirteç maliyetini azaltmak istiyorsanız
• Güvenilir küçük veya flash modeli olan bir sağlayıcıyla çalışıyorsanız

Şu durumda kapalı tutun:

• Her iletide sıfır ek gecikme istiyorsanız
• Çevrimdışı veya güvenilmez bir ağla çalışıyorsanız
• Belirteç kullanımını en aza indirmek istiyorsanız
• Bir modeli her zaman açıkça sabitliyorsanız