Pool ile LLMTR: üç ortam değişkeni ve Laguna kimlikleri

Kod değişikliği yok: yapılandırma tamamen ortam değişkeni

pool, Poolside’ın kodlama ajanıdır ve birden fazla modda çalışabilir. LLMTR’ye bağlamak için ajanın içinde bir sağlayıcı sınıfı yazmanız, bir eklenti kurmanız ya da bir yapılandırma dosyası açmanız gerekmiyor. knowhycodata/pool deposundaki docs/add-llmtr-provider dalı yalnızca belgelendirme değişikliği taşır: README’nin içindekiler listesine bir başlık ve o başlığın altına bir bölüm eklenir, kaynak kodda tek satır değişmez.

Bunun nedeni, pool’un bağımsız çalışma modunun uç noktayı, anahtarı ve model adını üç ortam değişkeninden okumasıdır. Değişkenleri komutun önüne yazarsınız ve ajan o oturumda LLMTR’ye konuşur. Bir sonraki oturumda değişkenleri değiştirirseniz hedef de değişir; ajan tarafında saklanan bir durum kalmaz.

Belgede ayrıca etkileşimsiz çalıştırma için pool exec adlı bir mod anılıyor. Bu rehber o modun ayrıntılarını doğrulamadı; burada anlatılan üç değişken README’nin LLMTR bölümünde yazılı olan yapılandırmadır.

Üç değişken ve her birinin kararı

Değişken adlarının üçü de Poolside’ın kendi ad alanında. Yani LLMTR’ye özgü yeni bir isim öğrenmiyorsunuz; ajanın zaten tanıdığı bağımsız mod değişkenlerine LLMTR değerlerini koyuyorsunuz. Ayırt edici olan tek şey model adının biçimidir: pool’un kendi listelerinde kısa model adları geçerken, ağ geçidinde kimlik iki parçalıdır ve sağlayıcı ön eki taşır.

Anahtarı komut satırının önüne yazmak kısa denemeler için pratiktir ama kabuk geçmişine düşer. Kalıcı kurulumda anahtarı kabuk geçmişine yazılmayan bir yerden okutmak daha uygun olur.

pool ajanını LLMTR üzerinden bugün canlı olan Laguna kimliğiyle başlatma

POOLSIDE_STANDALONE_BASE_URL="https://llmtr.com/v1" \
POOLSIDE_API_KEY="llmtr-your_key" \
POOLSIDE_STANDALONE_MODEL="poolside/laguna-xs-2.1" \
pool

README’deki Laguna listesi bugünkü katalogla ayrışıyor

Dalın eklediği bölüm, LLMTR üzerinden erişilebilen Poolside modelleri olarak iki kimlik sayıyor ve örnek komutta bunlardan büyüğünü kullanıyor. Bu rehberi hazırlarken listeyi bugünkü katalogla karşılaştırdık ve ayrıştığını gördük: sayılan iki kimlikten yalnızca biri, poolside/laguna-xs-2.1, bugün canlı.

Büyük kardeş 29 Temmuz 2026’da emekliye ayrıldı. Nedeni LLMTR tarafında bir karar değil, yukarı akıştaki bir kaldırma: Poolside kendi çıkarım listesinden o rotayı çıkardı ve kimliğe giden her istek karşı taraftan anlamsız bir bulunamadı yanıtı olarak dönmeye başladı. Aynı ailenin daha eski bir kimliği de, Laguna XS 2.1 yayımlandıktan kısa süre sonra kaldırıldığı için katalogda emekli görünüyor.

Yani ham belge yanlış yazılmış değil, eskimiş. Bir entegrasyon belgesindeki model listesi yazıldığı günün fotoğrafıdır; kullanmadan önce katalogla karşılaştırmak, örnek komutu olduğu gibi kopyalamaktan daha güvenlidir. Örnek komutlarınızda bugün canlı olan kimliği kullanın.

Emeklilik nasıl görünür: 410, sessiz ikame yok

Emekli bir modelin katalogdan silinmemesi bilinçli bir tercih. Satır genel katalogda kalır, emekli olarak işaretlenir ve öne çıkarılan alandan çıkarılır; sayfası bir referans kaydı olarak durmaya devam eder. Böylece kimliği bir yerde gören kişi, kimliğin ne olduğunu ve neden çalışmadığını öğrenebilir.

İstek tarafında ise ağ geçidi bu kimliği yukarı akışa hiç göndermez. Çağrı HTTP 410 ile ve model_retired hata koduyla reddedilir. Buradaki fark önemli: karşı taraftan gelen anlamsız bir bulunamadı yanıtı yerine, ne olduğunu söyleyen yapısal bir hata alırsınız.

Bir ayrıntı bu ailede özellikle dikkat çekici. Emekli olan büyük kimlik, hâlâ canlı olan küçük kimliğe sessizce yönlendirilmiyor. Gerekçesi katalogda yazılı: küçük model farklı davranan ayrı bir modeldir ve büyük model istenen bir çağrıyı onunla yanıtlamak, çıktıyı hangi modelin ürettiği konusunda yanlış bilgi vermek olurdu. Buna karşılık aynı ailenin eski kimliği için durum farklı; orada halef aynı sınıfın yeni sürümü olduğu için istek halefe iletiliyor ve çağrıya bir yönlendirme bildirimi eşlik ediyor.

Aşağıdaki tablo üç kimliğin bugünkü durumunu bir arada veriyor.

Bir kimliğin bugün sürülebilir olup olmadığını yalnızca durum koduna bakarak kontrol etme

check() {
  curl -s -o /dev/null -w "$1 -> %{http_code}\n" \
    https://llmtr.com/v1/chat/completions \
    -H "Authorization: Bearer llmtr-your_key" \
    -H "Content-Type: application/json" \
    -d "{\"model\":\"$1\",\"max_tokens\":4,\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"
}

check poolside/laguna-xs-2.1
# 410 gorurseniz kimlik emeklidir; katalog sayfasi neyin degistigini soyler

Laguna dışına çıkmak: değişken herhangi bir kanonik kimlik alır

Model değişkeni Poolside kimlikleriyle sınırlı değil. Ağ geçidinin kataloğundaki iki parçalı herhangi bir kimliği yazabilirsiniz; ajan tarafında değişen bir şey olmaz, çünkü ajan zaten sohbet tamamlama çağrısı yapıyor.

Bir kimliği yazmadan önce iki şeye bakmak yeterli. Birincisi kimliğin bugün canlı olması. İkincisi, kimliğin sohbet tamamlama çağrısıyla sürülebilmesi. Ağ geçidinde köprü yönü asimetriktir: bir sohbet tamamlama isteği, modelin sohbet ya da responses bağlantısı varsa çalışır, ama bir responses isteği yalnızca responses bağlantısı olan modellerde çalışır. pool sohbet ucundan konuştuğu için bu asimetri sizin lehinize işler.

Genel katalog anahtarsız okunabildiği için kimlik doğrulamasını denemeye girmeden yapabilirsiniz.

Model değişkenini başka bir kanonik kimliğe çevirmek ve kataloğu anahtarsız okumak

# Poolside disinda bir modelle ayni ajani surmek
POOLSIDE_STANDALONE_BASE_URL="https://llmtr.com/v1" \
POOLSIDE_API_KEY="llmtr-your_key" \
POOLSIDE_STANDALONE_MODEL="anthropic/claude-opus-4.8" \
pool

# Kimligin bugun katalogda olup olmadigini anahtarsiz kontrol edin
curl -s https://llmtr.com/v1/models | jq -r '.data[].id' | grep poolside

Başlamadan önce kısa kontrol

Bu entegrasyonda hata yapılabilecek yer az, çünkü değiştirilen tek şey üç değişken. Yine de en sık iki hata belirli: eski bir belgeden kopyalanan model kimliği ve kısa model adının kanonik kimlik yerine yazılması.

Aşağıdaki kontrolleri sırayla geçerseniz ilk oturum genellikle sorunsuz açılır. Bir sorun çıkarsa hata durum kodu size hangi kategoride olduğunuzu söyler: 410 kimliğin emekli olduğunu, kimlik doğrulama hataları anahtarın okunmadığını gösterir.

• Model kimliğini iki parçalı yazın: sağlayıcı ön eki olmadan yazılan kısa ad katalogla eşleşmez
• Kimliğin bugün canlı olduğunu katalogdan doğrulayın; belgedeki liste yazıldığı güne aittir
• Anahtarın llmtr ön ekiyle başladığını ve kabuğa doğru aktarıldığını kontrol edin
• Kalıcı kurulumda anahtarı komut satırının önüne değil, kabuk geçmişine düşmeyen bir kaynağa koyun
• Maliyeti token kullanımı ve kredi bakiyesi üzerinden izleyin; platform marjı yalnızca kredi yüklemede uygulanır ve yüzde sekizdir

Sık sorulan sorular

pool tarafında LLMTR için kod yazmam gerekiyor mu?

Hayır. knowhycodata/pool deposundaki docs/add-llmtr-provider dalı yalnızca README’ye bir bölüm ekler; kaynak kodda değişiklik yoktur. Bağımsız mod uç noktayı, anahtarı ve model adını üç ortam değişkeninden okur, dolayısıyla yapılandırma bu üç değişkenden ibarettir.

README’de sayılan Poolside modellerinin ikisini de kullanabilir miyim?

Bugün hayır. Sayılan iki kimlikten yalnızca poolside/laguna-xs-2.1 canlı. Diğeri 29 Temmuz 2026’da, Poolside kendi çıkarım listesinden rotayı kaldırdığı için emekliye ayrıldı. Örnek komutlarınızda canlı kimliği kullanın.

Emekli bir kimliğe istek gönderirsem ne olur?

Ağ geçidi isteği yukarı akışa göndermez ve çağrıyı HTTP 410 ile, model_retired hata koduyla reddeder. Karşı taraftan gelen anlamsız bir bulunamadı yanıtı yerine ne olduğunu söyleyen yapısal bir hata alırsınız; kimliğin katalog sayfası da referans olarak yerinde kalır.

Emekli olan büyük model neden otomatik olarak küçüğüne yönlendirilmiyor?

Küçük model farklı davranan ayrı bir modeldir. Büyük model istenen bir çağrıyı onunla yanıtlamak, çıktıyı hangi modelin ürettiği konusunda yanlış bilgi vermek olurdu. Bu yüzden o kimlik bilerek yönlendirilmiyor. Halefin aynı sınıfın yeni sürümü olduğu durumda ise yönlendirme yapılır ve çağrıya bir bildirim eşlik eder.

İlgili yazılar

• LLMTR entegre geliştirici araçları: 21 aracın bağlanma biçimi
• OpenCompany iş akışlarında LLMTR sağlayıcısı kurulumu
• Trae Agent ile LLMTR: Python yapılandırması ve çalışma kaydı

• Model katalogu
• Chat Completions rehberi
• API anahtarlari
• Fiyatlandirma