Files
OmniRoute/docs/i18n/tr/docs/features/context-relay.md
ismail çelik af90cb7f9b docs(i18n): improve and complete Turkish documentation translations (#11237)
Validated on the combined 12-PR batch board: check:docs-all passes (docs-sync, doc-links over 855 links, fabricated-docs strict). 26-file Turkish documentation suite at full parity with consistent terminology. Thank you @ismailcelik-tr!
2026-08-23 14:25:09 -03:00

6.9 KiB
Raw Blame History

Context Relay (Türkçe)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr


context-relay, konuşma tamamlanmadan önce aktif hesap değiştiğinde (rotasyon) oturum sürekliliğini koruyan bir kombo stratejisidir.

Mevcut çalışma zamanı model seçimi için öncelikli (priority) yönlendirme gibi davranır, ardından üzerine bir devir (handoff) katmanı ekler:

  • Aktif hesap tükenmeden önce OmniRoute kompakt ve yapılandırılmış bir özet üretir
  • Kimlik doğrulama aynı oturum için farklı bir hesap seçtikten sonra, OmniRoute bu özeti sonraki isteğe bir sistem mesajı olarak enjekte eder
  • Devir başarıyla tüketildiğinde depodan silinir

Ne Zaman Kullanılmalı

Aşağıdakilerin tümü doğru olduğunda context-relay kullanın:

  • Kombonun aynı sağlayıcının birden çok hesabı arasında geçiş yapması bekleniyorsa
  • Kısa vadeli konuşma sürekliliğini kaybetmek görev kalitesine zarar verecekse
  • Sağlayıcı yaklaşan bir hesap sınırını tahmin etmek için yeterli kota bilgisi sunuyorsa

Bu özellik, tek bir hesap penceresinden daha uzun sürebilecek uzun kodlama veya araştırma oturumları için son derece kullanışlıdır.

Çalışma Zamanı Akışı

Mevcut davranış kasıtlı olarak iki çalışma zamanı katmanına ayrılmıştır.

%0 ila %84 Kota Kullanımı

Hiçbir devir özeti üretilmez. İstekler normal öncelik yönlendirmesi gibi davranır.

%85 ila %94 Kota Kullanımı

Aktif sağlayıcı handoffProviders içinde etkinleştirilmişse, OmniRoute hesap tamamen tükenmeden önce arka planda yapılandırılmış bir devir özeti üretir.

Önemli detaylar:

  • Varsayılan uyarı eşiği 0.85'tir
  • Üretim için kesin durma noktası 0.95'tir
  • sessionId + comboName başına yalnızca bir devam eden devir üretimine izin verilir
  • Bu oturum/kombo için zaten etkin bir devir varsa, mükerrer özet üretilmez

%95 veya Daha Fazla Kota Kullanımı

Yeni bir devir üretilmez. Bu noktada sistem zaten tükenme sınırındadır veya tükenmiştir; çalışma zamanı başka bir özet isteği zamanlamaktan kaçınır.

Hesap Rotasyonundan Sonra

Aynı oturum için bir sonraki istek farklı bir kimliği doğrulanmış hesaba çözümlendiğinde, OmniRoute saklanan devir özetini bir sistem mesajı olarak başa ekler. Enjeksiyon yalnızca gerçek hesap değişikliği bilindikten sonra gerçekleşir.

Devir Yükü (Handoff Payload)

Kalıcı devir yükü context_handoffs tablosunda saklanır ve şunları içerir:

  • sessionId
  • comboName
  • fromAccount
  • summary
  • keyDecisions
  • taskProgress
  • activeEntities
  • messageCount
  • model
  • warningThresholdPct
  • generatedAt
  • expiresAt

Özet modeline şu yapıda bir JSON nesnesi döndürmesi talimatı verilir:

{
  "summary": "Süreklilik için önemli olan konuların yoğun özeti",
  "keyDecisions": ["Karar 1", "Karar 2"],
  "taskProgress": "Ne yapıldı, ne bekliyor ve bir sonraki adım",
  "activeEntities": ["dosyaA.ts", "özellik X", "sağlayıcı Y"]
}

Enjeksiyon anında OmniRoute bu yükü bir <context_handoff> sistem mesajına dönüştürür; böylece sonraki hesap doğru yerel bağlamla devam edebilir.

Yapılandırma

context-relay şu yapılandırma alanlarını destekler:

  • handoffThreshold: Özet üretimi için uyarı eşiği, varsayılan 0.85
  • handoffModel: Yalnızca özet üretimi için kullanılan isteğe bağlı model geçersiz kılma
  • handoffProviders: Devir üretimini tetiklemesine izin verilen sağlayıcıların izin listesi

Genel varsayılanlar Ayarlar sayfasında yapılandırılabilir ve kombo bazlı değerler bunları Kombolar sayfasında geçersiz kılabilir.

Mimari Not

Mevcut uygulama bağımsız bir handleContextRelayCombo işleyicisi kullanmaz.

Bunun yerine:

  • open-sse/services/combo.ts başarılı bir turun devir üretip üretmeyeceğine karar verir
  • src/sse/handlers/chat.ts devir özetini yalnızca kimlik doğrulama istek için kullanılan gerçek hesabı belirledikten sonra enjekte eder

Sınırlamalar

  • Etkili çalışma zamanı desteği şu anda codex kota rotasyonu üzerinde yoğunlaşmıştır.
  • handoffProviders bir yapılandırma yüzeyi olarak modellenmiştir ancak gerçek devir üretimi hala sağlayıcıya özel kota altyapısına bağlıdır.
  • Özet kasıtlı olarak kompakt ve yakın geçmişe dayalıdır; tam bir konuşma geçmişi tekrar oynatma mekanizması değildir.
  • Devirler sessionId + comboName ile kapsama alınır ve otomatik olarak sona erer.
  • Oturum hesap değiştirmezse, saklanan devir enjekte edilmez.

Önerilen Kullanım Modeli

  • Aynı sağlayıcıdan birden fazla hesap kullanın
  • Oturum boyunca kararlı sessionId değerleri koruyun
  • Arka plan özet isteğine yer bırakmak için handoffThreshold değerini yeterince erken bir seviyeye ayarlayın
  • Bu özelliği kalıcı belleğin yerine geçen bir mekanizma olarak değil, bir süreklilik desteği olarak değerlendirin