better-i18n ile Human-in-the-Loop AI Çeviri: Çeviri Kalitesi için 23 Agent Tool

better-i18n'de AI Destekli Çeviri Agent

better-i18n, basit bir AI çevirisinin çok ötesine geçer. Dashboard, Google Gemini tarafından desteklenen tam bir konuşma bazlı AI agent içerir — proje bağlamınızı anlayan ve çeviri görevlerini doğal dil aracılığıyla yürüten bir yapı. Bir namespace çevirmesini, tutarsızlıkları incelemeyi veya yeni bir dil eklemeyi isteyin; agent her adımda onayınızla iş akışını uçtan uca yönetir.

Bu bir "üret ve umarız ki doğrudur" yaklaşımı değil. Agent, 23 özel tool, her yazma işlemi için human-in-the-loop onayı ve gerçek verinizde sabit kalan 30 saniyelik proje bağlamı önbelleği ile çalışır.

AI Agent Mimarisi

AI chat sistemi, basit bir prompt-response arayüzü değil, tool kullanan bir agent olarak kurulmuştur. Bir istek yazdığınızda agent:

1. Proje bağlamınızı okur — diller, keyler, çeviriler, sync durumu, content modeller
2. İşlemi planlar — hangi toollerin hangi sırayla çağrılacağını belirler
3. Onay alarak çalışır — okuma işlemleri otomatik gerçekleşir; yazma işlemleri açık onayınızı gerektirir
4. Sonuçları aşamalı olarak stream'ler — sonuçlar gelirken çeviri tabloları gerçek zamanlı render edilir

Agent, büyük işlemlerde token taşmasını önleyen context stripping (slimToolResults) ile konuşma başına 50 adıma kadar destek verir.

23 Özel Tool

Agent, okuma toolla ve yazma toolla olarak iki gruba ayrılmış 23 amaca özel toola sahiptir.

Okuma Toolla (Otomatik Çalışır)

Bu toollar onay gerektirmeden çalışır ve agente projenizde tam görünürlük sağlar:

• getTranslations — belirli keyler, namespace'ler veya diller için çevirileri getirir
• getKeyDetails — bireysel key meta verilerini, bağlam notlarını ve çeviri durumunu inceler
• getLanguages — yapılandırılmış tüm dilleri ve tamamlanma yüzdelerini listeler
• getProjectStats — proje genelinde çeviri kapsamı, key sayıları ve dil istatistikleri
• getDoctorReport — eksik çevirileri, kullanılmayan keyleri ve tutarsızlıkları belirleyen tanısal rapor
• getSyncs — yapılandırılmış tüm sync entegrasyonlarını listeler (GitHub, GitLab vb.)
• getSyncDetails — belirli bir sync'in yapılandırmasını ve son aktivitesini inceler
• getContentModels — content modelleri ve alan yapılarını listeler
• getContentEntries — modeller genelinde content entry'lere göz atar
• createPlan — karmaşık çok adımlı işlemler için bir execution plan oluşturur

Yazma Toolla (Human-in-the-Loop Onayı Gerektirir)

Her yazma tool, çalışmadan önce açık onayınızı gerektirir. Agent değişiklikleri önerir, siz incelersiniz ve ancak o zaman etkili olurlar:

• proposeTranslations — eksik dil çiftleri için yeni çeviriler üretir
• proposeTranslationEdits — mevcut çevirilere iyileştirme önerir
• translateBatch — tek işlemde birden fazla dilde keyleri toplu çevirir
• proposeKeys — kod tabanı kalıplarınıza göre yeni çeviri keyleri önerir
• proposeDeleteKeys — kullanılmayan veya tekrar eden keyleri belirler ve kaldırılmasını önerir
• proposeLanguages — kullanıcı demografinize göre eklenecek yeni diller önerir
• proposeLanguageEdits — dil yapılandırmasını değiştirir (görünen adlar, fallback'lar)
• publishChanges — onaylanan çevirileri CDN'e canlı olarak publish eder
• proposeContentEntries — CMS content entry'leri oluşturur veya günceller
• proposeContentModel — content model şeması değişikliklerini önerir
• proposePublishEntries — content entry'leri publish için sıraya alır

Human-in-the-Loop: Temel Farklılaştırıcı

Çoğu AI çeviri aracı "üret ve gönder" modeliyle çalışır. better-i18n, human-in-the-loop (HITL) onayı ile temelden farklı bir yaklaşım benimser.

HITL pratikte nasıl işler:

1. Agente sorarsınız: "settings namespace'indeki tüm eksik keyleri Almanca ve Fransızcaya çevir"
2. Agent projenizi okur, 47 eksik çeviriyi belirler ve bunları üretir
3. Chat'te yapılandırılmış bir öneri görünür — her kaynak string, AI çevirisi ve uygulanan glossary terimleri gösterilir
4. Öneriyi incelersiniz: hepsini onaylayın, seçerek onaylayın veya değişiklik isteyin
5. Yalnızca onaylanan çeviriler projenize yazılır

Bu iş akışı, AI çeviri kalitesinin üretime ulaşmadan önce standartlarınızı karşılamasını sağlar. Agent, onayınız olmadan asla veri yazmaz.

Bu neden önemlidir:

• Sessiz hatalar yok — her AI tarafından oluşturulan çeviri canlıya geçmeden önce incelenir
• Glossary uyumu — AI terminoloji tanımlarınıza uyar ve siz bunu doğrularsınız
• Audit trail — her onay, kimin onayladığı ve ne zaman onaylandığıyla birlikte kaydedilir
• Geri alınabilirlik — her değişikliği onayladığınız için üretimde bilinmeyen kalitede bir batch bulunmaz

Progressive Rendering

Agent çeviriler ürettiğinde, sonuçlar gerçek zamanlı olarak chat arayüzüne stream edilir. Çeviri tablosu aşamalı olarak render edilir — tüm batch'in tamamlanmasını beklemek yerine AI çıktı ürettikçe her dil sütununun dolduğunu görürsünüz.

Bu, özellikle büyük işlemler için değerlidir. 8 dilde 200 key çevirirken, agent geri kalanını üretirken ilk sonuçları incelemeye başlayabilirsiniz.

Chat Geçmişi ve Kalıcılık

Agent, çift depolama sistemiyle konuşma geçmişini korur:

• IndexedDB (local) — sıfır gecikmeyle son konuşmalara anında erişim sağlar
• Postgres (sunucu) — tüm agent etkileşimlerinin kalıcı bir audit trail'ini tutar

Bu, dashboard'a döndüğünüzde konuşmalarınızın anında yüklenmesi anlamına gelir; aynı zamanda ekip denetimi ve uyumluluk amaçları için de erişilebilir olur.

Pratik Örnekler

Yeni Dil Ekleme

Siz: "Projeye Japonca ekle ve tüm mevcut keyleri çevir"

Agent, mevcut yapılandırmayı kontrol etmek için getLanguages'i, Japonca eklemek için proposeLanguages'i, ardından tüm mevcut keyler için çeviri üretmek üzere translateBatch'i çağırır. Her adım size ne olduğunu gösterir ve yazma işlemleri onayınızı bekler.

Çeviri Sorunlarını Bulma

Siz: "Fransızca çevirilerde tutarsızlık var mı?"

Agent getDoctorReport ve getTranslations'ı çağırır, ardından terminoloji tutarsızlıkları, eksik çoğul formlar veya çevrilmemiş keyler için sonuçları analiz eder. Dikkat gerektiren belirli keylerle birlikte bir özet sunar.

Toplu Çeviri İncelemesi

Siz: "Checkout namespace'indeki İspanyolca için çevrilmemiş tüm keyleri göster"

Agent uygun filtrelerle getTranslations'ı çağırır ve eksik çevirilerin bir tablosunu sunar. Ardından hepsinin çevirisini üretmesini, önerileri incelemenizi ve toplu onaylamanızı isteyebilirsiniz.

Model ve Context Yönetimi

Agent, güçlü çok dilli yetenekleri ve context window boyutu nedeniyle Google Gemini'yi temel model olarak kullanır. Temel teknik detaylar:

• Konuşma başına 50 adım — karmaşık çok adımlı işlemler için yeterli
• Context stripping — slimToolResults sistemi, büyük API yanıtlarını temel verilere kısaltarak token kullanımını otomatik olarak azaltır
• 30 saniyelik proje önbelleği — proje bağlamı 30 saniye önbelleğe alınır; çok adımlı işlemlerde gereksiz API çağrılarını engeller

AI Agent ile Başlarken

1. better-i18n dashboard'unu açın ve AI chat simgesine tıklayın
2. Bir okuma işlemiyle başlayın: "Bu proje için çeviri durumunu göster"
3. Bir çeviri görevi deneyin: "common namespace'indeki tüm eksik keyleri İspanyolcaya çevir"
4. Agentin önerilerini inceleyin ve onaylayın ya da düzenleyin
5. Çevirileri canlıya almaya hazır olduğunuzda "Publish changes" kullanın

AI agent tüm planlarda kullanılabilir. Projenizle denemek için hesabınızı oluşturun.