update more languages

Signed-off-by: Alex Jenkins <kjenkins60@gatech.edu>
This commit is contained in:
Alex Jenkins 2026-04-11 01:08:44 +00:00
parent 835acaa70e
commit 16c2f12a54
249 changed files with 117186 additions and 186 deletions

View file

@ -4,7 +4,11 @@
Bu özellik, TrustGraph'taki akış şemaları için yapılandırılabilir parametrelerin uygulanmasınııklamaktadır. Parametreler, kullanıcıların akış başlatma zamanında işlemci parametrelerini, akış şeması tanımındaki parametre yer tutucularını değiştiren değerler sağlayarak özelleştirmesini sağlar.
<<<<<<< HEAD
Parametreler, işlemci parametrelerinde şablon değişken yerleştirmesi yoluyla çalışır, tıpkı `{id}` ve `{class}` değişkenlerinin nasıl çalıştığı gibi, ancak kullanıcı tarafından sağlanan değerlerle.
=======
Parametreler, `{id}` ve `{class}` değişkenlerinin nasıl çalıştığına benzer şekilde, işlemci parametrelerinde şablon değişken yerleştirmesi yoluyla çalışır, ancak kullanıcı tarafından sağlanan değerlerle.
>>>>>>> 82edf2d (New md files from RunPod)
Bu entegrasyon, dört birincil kullanım senaryosunu destekler:
@ -17,17 +21,27 @@ Bu entegrasyon, dört birincil kullanım senaryosunu destekler:
**Dinamik İşlemci Yapılandırması**: Parametre yerleştirmesi yoluyla işlemci parametrelerinin çalışma zamanı yapılandırmasını etkinleştirme.
**Parametre Doğrulama**: Akış başlatma zamanında parametreler için tür denetimi ve doğrulama sağlama.
<<<<<<< HEAD
**Varsayılan Değerler**: Akıllı varsayılan değerleri destekleme ve aynı zamanda gelişmiş kullanıcılar için geçersiz kılmalara izin verme.
**Şablon Yerleştirmesi**: İşlemci parametrelerindeki parametre yer tutucularını sorunsuz bir şekilde değiştirme.
**Kullanıcı Arayüzü Entegrasyonu**: Parametre girişini hem API hem de kullanıcı arayüzü arayüzleri aracılığıyla etkinleştirme.
**Tür Güvenliği**: Parametre türlerinin beklenen işlemci parametre türleriyle eşleştiğinden emin olma.
**Belgeleme**: Akış şeması tanımları içindeki kendi kendini belgeleyen parametre şemaları.
**Geriye Dönük Uyumluluk**: Parametre kullanmayan mevcut akış şemalarıyla uyumluluğu koruma.
=======
**Varsayılan Değerler**: Gelişmiş kullanıcılar için geçersiz kılmaları desteklerken anlamlı varsayılan değerleri destekleme.
**Şablon Yerleştirmesi**: İşlemci parametrelerindeki parametre yer tutucularını sorunsuz bir şekilde değiştirme.
**Kullanıcı Arayüzü Entegrasyonu**: Hem API hem de kullanıcı arayüzü arayüzleri aracılığıyla parametre girişi sağlama.
**Tür Güvenliği**: Parametre türlerinin beklenen işlemci parametre türleriyle eşleştiğinden emin olma.
**Belgeleme**: Akış şeması tanımları içindeki kendi kendini belgeleyen parametre şemaları.
**Geriye Dönük Uyumluluk**: Parametreleri kullanmayan mevcut akış şemalarıyla uyumluluğu koruma.
>>>>>>> 82edf2d (New md files from RunPod)
## Arka Plan
TrustGraph'taki akış şemaları artık, sabit değerler veya parametre yer tutucuları içerebilen işlemci parametrelerini desteklemektedir. Bu, çalışma zamanı özelleştirmesi için bir fırsat yaratır.
<<<<<<< HEAD
Mevcut işlemci parametreleri şunları desteklemektedir:
Sabit değerler: `"model": "gemma3:12b"`
Parametre yer tutucuları: `"model": "gemma3:{model-size}"`
@ -43,11 +57,29 @@ Varyasyonlar için parametreleri kullanarak akış şeması çoğaltmasını aza
Kullanıcıların tanımları değiştirmeden işlemci davranışını ayarlamasına izin verme.
Parametre değerleri aracılığıyla ortama özgü yapılandırmaları destekleme.
Parametre şema doğrulaması yoluyla tür güvenliğini sağlama.
=======
Mevcut işlemci parametreleri şunları destekler:
Sabit değerler: `"model": "gemma3:12b"`
Parametre yer tutucuları: `"model": "gemma3:{model-size}"`
Bu özellik, parametrelerin nasıl olduğu tanımlar:
Akış şeması tanımlarında beyan edilir
Akışlar başlatıldığında doğrulanır
İşlemci parametrelerinde yerleştirilir
API'ler ve kullanıcı arayüzleri aracılığıyla açığa çıkarılır
Parametreli işlemci parametrelerini kullanarak, TrustGraph şunları yapabilir:
Varyasyonlar için parametreleri kullanarak akış şeması çoğaltmasını azaltma
Kullanıcıların tanımları değiştirmeden işlemci davranışını ayarlamasına izin verme
Parametre değerleri aracılığıyla ortama özgü yapılandırmaları destekleme
Parametre şema doğrulaması yoluyla tür güvenliğini sağlama
>>>>>>> 82edf2d (New md files from RunPod)
## Teknik Tasarım
### Mimari
<<<<<<< HEAD
Yapılandırılabilir parametreler sistemi, aşağıdaki teknik bileşenleri gerektirmektedir:
1. **Parametre Şema Tanımı**
@ -62,29 +94,65 @@ Yapılandırılabilir parametreler sistemi, aşağıdaki teknik bileşenleri ger
Belirtilmemiş parametreler için varsayılan değerlerin uygulanması.
Parametrelerin akış yürütme bağlamına enjekte edilmesi.
Gerekli olduğu gibi tür dönüştürme ve dönüştürme.
=======
Yapılandırılabilir parametreler sistemi, aşağıdaki teknik bileşenleri gerektirir:
1. **Parametre Şema Tanımı**
Akış şeması meta verilerindeki JSON Şema tabanlı parametre tanımları
Dize, sayı, boolean, enum ve nesne türleri dahil olmak üzere tür tanımları
min/max değerleri, kalıplar ve gerekli alanlar dahil olmak üzere doğrulama kuralları
Modül: trustgraph-flow/trustgraph/flow/definition.py
2. **Parametre Çözümleyici Motoru**
Şemaya karşı çalışma zamanı parametre doğrulaması
Belirtilmemiş parametreler için varsayılan değer uygulaması
Parametreleri akış yürütme bağlamına enjekte etme
Gerekli olduğu gibi tür dönüştürme ve dönüştürme
>>>>>>> 82edf2d (New md files from RunPod)
Modül: trustgraph-flow/trustgraph/flow/parameter_resolver.py
3. **Parametre Deposu Entegrasyonu**
<<<<<<< HEAD
Şema/yapılandırma deposundan parametre tanımlarının alınması.
Sık kullanılan parametre tanımlarının önbelleğe alınması.
Merkezi olarak depolanan şemalara karşı doğrulama.
=======
Şema/yapılandırma deposundan parametre tanımlarının alınması
Sık kullanılan parametre tanımlarının önbelleğe alınması
Merkezi olarak depolanan şemalara karşı doğrulama
>>>>>>> 82edf2d (New md files from RunPod)
Modül: trustgraph-flow/trustgraph/flow/parameter_store.py
4. **Akış Başlatıcı Uzantıları**
<<<<<<< HEAD
Akış başlatma sırasında parametre değerlerini kabul etmek için API uzantıları.
Parametre eşleme çözümü (akış adlarının tanım adlarına eşlenmesi).
Geçersiz parametre kombinasyonları için hata işleme.
=======
Akış başlatma sırasında parametre değerlerini kabul etmek için API uzantıları
Parametre eşleme çözümü (akış adlarının tanım adlarına eşlenmesi)
Geçersiz parametre kombinasyonları için hata işleme
>>>>>>> 82edf2d (New md files from RunPod)
Modül: trustgraph-flow/trustgraph/flow/launcher.py
5. **Kullanıcı Arayüzü Parametre Formları**
<<<<<<< HEAD
Akış parametre meta verilerinden dinamik form oluşturma.
`order` alanı kullanarak sıralı parametre görüntüleme.
`description` alanı kullanarak açıklayıcı parametre etiketleri.
Parametre türü tanımlarına karşı giriş doğrulaması.
Parametre ön ayarları ve şablonları.
=======
Akış parametre meta verilerinden dinamik form oluşturma
`order` alanı kullanarak sıralı parametre görüntüleme
`description` alanı kullanarak açıklayıcı parametre etiketleri
Parametre türü tanımlarına karşı giriş doğrulaması
Parametre ön ayarları ve şablonları
>>>>>>> 82edf2d (New md files from RunPod)
Modül: trustgraph-ui/components/flow-parameters/
@ -221,7 +289,11 @@ Akış şemaları, tür referansları, açıklamalar ve sıralama ile parametre
`type`: Merkezi olarak tanımlanmış parametre tanımına referans (örneğin, "llm-model")
`description`: Kullanıcı arayüzünde (UI) görüntülenmesi için insan tarafından okunabilir açıklama
`order`: Parametre formları için görüntüleme sırası (daha düşük sayılar önce görüntülenir)
<<<<<<< HEAD
`advanced` (isteğe bağlı): Bu parametrenin gelişmiş bir parametre olup olmadığını gösteren bir boolean bayrak (varsayılan: false). "true" olarak ayarlandığında, kullanıcı arayüzü bu parametreyi varsayılan olarak gizleyebilir veya "Gelişmiş" bölümünde yer almasını sağlayabilir
=======
`advanced` (isteğe bağlı): Bu parametrenin gelişmiş bir parametre olup olmadığını gösteren bir bayrak (varsayılan: false). "true" olarak ayarlandığında, kullanıcı arayüzü bu parametreyi varsayılan olarak gizleyebilir veya "Gelişmiş" bölümünde yer almasını sağlayabilir
>>>>>>> 82edf2d (New md files from RunPod)
`controlled-by` (isteğe bağlı): Basit moddayken bu parametrenin değerini kontrol eden başka bir parametrenin adı. Belirtildiğinde, bu parametre açıkça geçersiz kılmadığı sürece, kontrol eden parametreden değerini alır
Bu yaklaşım şunları sağlar:
@ -250,7 +322,11 @@ Akış başlatma API'si, parametreleri akışın parametre adlarını kullanarak
}
```
<<<<<<< HEAD
Not: Bu örnekte, `llm-rag-model`ıkça belirtilmemiştir, ancak `controlled-by` ilişkisi nedeniyle `llm-model`'den "claude-3" değerini miras alacaktır. Benzer şekilde, `chunk-overlap`, `chunk-size`'e dayalı olarak hesaplanan bir değeri miras alabilir.
=======
Not: Bu örnekte, `llm-rag-model`ıkça belirtilmemiştir, ancak `controlled-by` ilişkisi nedeniyle `llm-model`'den "claude-3" değerini alacaktır. Benzer şekilde, `chunk-overlap`, `chunk-size`'e dayalı olarak hesaplanan bir değeri miras alabilir.
>>>>>>> 82edf2d (New md files from RunPod)
Sistem şunları yapacaktır:
1. Akış tanımından parametre meta verilerini çıkarın
@ -269,7 +345,11 @@ Bir akış başlatıldığında, sistem aşağıdaki parametre çözümleme adı
2. **Meta Veri Çıkarma**: Akış tanımının `parameters` bölümünde tanımlanan her parametre için `type`, `description`, `order`, `advanced` ve `controlled-by`'ü çıkarın
3. **Tür Tanımı Arama**: Akış tanımındaki her parametre için:
`type` alanı kullanılarak şema/yapılandırma deposundan parametre tür tanımını alın
<<<<<<< HEAD
Tür tanımları, yapılandırma sisteminde "parameter-type" türüyle saklanır
=======
Tür tanımları, yapılandırma sisteminde "parameter-type" türü ile saklanır
>>>>>>> 82edf2d (New md files from RunPod)
Her tür tanımı, parametrenin şemasını, varsayılan değerini ve doğrulama kurallarını içerir
4. **Varsayılan Değer Çözümleme**:
Akış tanımında tanımlanan her parametre için:
@ -283,18 +363,31 @@ Bir akış başlatıldığında, sistem aşağıdaki parametre çözümleme adı
`controlled-by` ilişkilerinde döngüsel bağımlılıkların olmadığını doğrulayın
6. **Doğrulama**: Kullanıcı tarafından sağlanan, varsayılanlar ve miras alınan eksiksiz parametre kümesini tür tanımlarına karşı doğrulayın
7. **Saklama**: Eksiksiz çözümlenmiş parametre kümesini denetlenebilirlik için akış örneğiyle birlikte saklayın
<<<<<<< HEAD
8. **Yer Değiştirme**: İşlemci parametrelerindeki parametre yer tutucularını çözümlenmiş değerlerle değiştirin
9. **İşlemci Oluşturma**: Yer değiştirilmiş parametrelerle işlemciler oluşturun
=======
8. **Şablon Yerine Koyma**: İşlemci parametrelerindeki parametre yer tutucularını çözümlenmiş değerlerle değiştirin
9. **İşlemci Oluşturma**: Yerine konulan parametrelerle işlemcileri oluşturun
>>>>>>> 82edf2d (New md files from RunPod)
**Önemli Uygulama Notları:**
Akış hizmeti, kullanıcı tarafından sağlanan parametreleri parametre tür tanımlarından gelen varsayılanlarla birleştirmelidir
Uygulanan varsayılanlar dahil eksiksiz parametre kümesi, izlenebilirlik için akışla birlikte saklanmalıdır
Parametre çözümlemesi, akış başlatma zamanında değil, işlemci oluşturma zamanında gerçekleşir
<<<<<<< HEAD
Varsayılanları olmayan gerekli parametrelerin eksik olması, akışın başlatılmasınıık bir hata mesajıyla başarısız olmasına neden olmalıdır
#### "controlled-by" ile Parametre Miras Alma
`controlled-by` alanı, parametre değerlerinin miras alınmasını sağlar; bu, kullanıcı arayüzlerini basitleştirirken esnekliği korumak için özellikle kullanışlıdır:
=======
Varsayılanları olmayan gerekli parametrelerin eksik olması, akışın başlatılmasınıık bir hata mesajıyla başarısız yapmasına neden olmalıdır
#### "controlled-by" ile Parametre Miras Alma
`controlled-by` alanı, parametre değerlerinin miras alınmasını sağlar ve kullanıcı arayüzlerini basitleştirirken esnekliği korumak için özellikle kullanışlıdır:
>>>>>>> 82edf2d (New md files from RunPod)
**Örnek Senaryo**:
`llm-model` parametresi birincil LLM modelini kontrol eder
@ -317,7 +410,11 @@ Bir kontrol eden parametre değiştiğinde, bağımlı parametreler açıkça ge
1. **Akışı Başlatma İşlemi**
Pulsar akışı başlatma işlemi, parametre değerlerinin bir haritasını içeren bir `parameters` alanı almalıdır
<<<<<<< HEAD
Pulsar için akış başlatma isteği şeması, isteğe bağlı `parameters` alanını içerecek şekilde güncellenmelidir
=======
Pulsar'ın akışı başlatma isteği şeması, isteğe bağlı `parameters` alanını içerecek şekilde güncellenmelidir
>>>>>>> 82edf2d (New md files from RunPod)
Örnek istek:
```json
{
@ -378,8 +475,13 @@ Akış yapılandırma hizmeti (`trustgraph-flow/trustgraph/config/service/flow.p
2. **Değiştirilen `handle_start_flow` Metodu**
Akış şemasını yükledikten sonra `resolve_parameters`'ı çağırın
<<<<<<< HEAD
Şablon yerleştirmesi için tam olarak çözülmüş parametre kümesini kullanın
Tam parametre kümesini (yalnızca kullanıcı tarafından sağlananları değil) akışla birlikte kaydedin
=======
Şablon yerleştirmesi için eksiksiz çözülmüş parametre kümesini kullanın
Eksiksiz parametre kümesini (yalnızca kullanıcı tarafından sağlananları değil) akışla birlikte kaydedin
>>>>>>> 82edf2d (New md files from RunPod)
Tüm gerekli parametrelerin değerlere sahip olduğundan emin olun
3. **Parametre Türü Alma**
@ -389,9 +491,15 @@ Akış yapılandırma hizmeti (`trustgraph-flow/trustgraph/config/service/flow.p
#### Yapılandırma Sistemi Entegrasyonu
<<<<<<< HEAD
3. **Akış Nesne Saklama**
Bir akış, yapılandırma yöneticisindeki akış bileşeni tarafından yapılandırma sistemine eklendiğinde, akış nesnesi çözülmüş parametre değerlerini içermelidir
Yapılandırma yöneticisi hem orijinal kullanıcı tarafından sağlanan parametreleri hem de çözülmüş değerleri (varsayılanlar uygulandıktan sonra) saklamalıdır
=======
3. **Akış Nesnesi Depolama**
Bir akış, yapılandırma yöneticisindeki akış bileşeni tarafından yapılandırma sistemine eklendiğinde, akış nesnesi çözülmüş parametre değerlerini içermelidir
Yapılandırma yöneticisi hem orijinal kullanıcı tarafından sağlanan parametreleri hem de çözülmüş değerleri (varsayılanlar uygulandıktan sonra) depolamalıdır
>>>>>>> 82edf2d (New md files from RunPod)
Yapılandırma sistemindeki akış nesneleri şunları içermelidir:
`parameters`: Akış için kullanılan son çözülmüş parametre değerleri
@ -399,7 +507,11 @@ Akış yapılandırma hizmeti (`trustgraph-flow/trustgraph/config/service/flow.p
4. **Kütüphane CLI Komutları**
Akışları başlatan CLI komutları parametre desteğine sahip olmalıdır:
<<<<<<< HEAD
Parametre değerlerini komut satırı bayrakları veya yapılandırma dosyaları aracılığıyla alın
=======
Parametre değerlerini komut satırı bayrakları veya yapılandırma dosyaları aracılığıyla kabul edin
>>>>>>> 82edf2d (New md files from RunPod)
Parametreleri göndermeden önce akış şema tanımlarına göre doğrulayın
Karmaşık parametre kümeleri için parametre dosyası girişini (JSON/YAML) destekleyin
@ -412,8 +524,13 @@ Akış yapılandırma hizmeti (`trustgraph-flow/trustgraph/config/service/flow.p
5. **ParameterSpec Desteği**
İşlemci temel sınıfları, mevcut ParametersSpec mekanizması aracılığıyla parametre yerleştirmesini desteklemelidir
<<<<<<< HEAD
ParametersSpec sınıfı (ConsumerSpec ve ProducerSpec ile aynı modülde bulunur), parametre şablonu yerleştirmesini desteklemek için gerekirse geliştirilmelidir
İşlemciler, parametre değerlerini akış başlatma zamanında çözerek parametrelerini yapılandırmak için ParametersSpec'i çağırabilmelidir
=======
ParameterSpec sınıfı (ConsumerSpec ve ProducerSpec ile aynı modülde bulunur), parametre şablonu yerleştirmesini desteklemek için gerekirse geliştirilmelidir
İşlemciler, parametre değerlerini akış başlatma zamanında çözülmüş olarak parametreleriyle yapılandırmak için ParametersSpec'i çağırmalıdır
>>>>>>> 82edf2d (New md files from RunPod)
ParametersSpec uygulaması şunları yapmalıdır:
Parametre yer tutucuları (örneğin, `{model}`, `{temperature}`) içeren parametre yapılandırmalarını kabul edin
İşlemci örneklendiğinde çalışma zamanında parametre yerleştirmesini destekleyin
@ -428,8 +545,13 @@ Yerleştirme, `{id}` ve `{class}` değiştirme ile birlikte gerçekleşir
Geçersiz parametre başvuruları, başlatma zamanı hatalarına neden olur
Tür doğrulama, merkezi olarak depolanan parametre tanımına göre yapılır
**ÖNEMLİ**: Tüm parametre değerleri dize olarak saklanır ve iletilir
<<<<<<< HEAD
Sayılar dizeye dönüştürülür (örneğin, `0.7` `"0.7"` olur)
Boole değerleri küçük harfli dizeye dönüştürülür (örneğin, `true` `"true"` olur)
=======
Sayılar dizelere dönüştürülür (örneğin, `0.7` `"0.7"` olur)
Boolean değerler küçük harfli dizelere dönüştürülür (örneğin, `true` `"true"` olur)
>>>>>>> 82edf2d (New md files from RunPod)
Bu, `parameters = Map(String())` tanımlayan Pulsar şeması gerekliliğidir
Örnek çözüm:
@ -456,11 +578,19 @@ Kenar durumları: eksik parametreler, geçersiz türler, tanımlanmamış parame
## Geçiş Planı
<<<<<<< HEAD
1. Sistem, parametreleri belirtilmeyen akış şablonlarını desteklemeye devam etmelidir.
2. Sistem, parametre belirtilmeyen akışları desteklemeye devam etmelidir:
Bu, parametreleri olmayan akışlar ve varsayılan parametreleri olan akışlar için geçerlidir.
=======
1. Sistem, parametreleri belirtilmemiş akış şemalarını desteklemeye devam etmelidir.
2. Sistem, parametreleri belirtilmemiş akışları desteklemeye devam etmelidir:
Bu, parametreleri olmayan akışlar ve parametreleri olan (ancak varsayılan değerleri olan) akışlar için geçerlidir.
(bunların varsayılan değerleri vardır).
>>>>>>> 82edf2d (New md files from RunPod)
## Açık Sorular
@ -471,6 +601,7 @@ S: Parametre yer tutucuları kuyruk adlarında kullanılabilir mi yoksa sadece
parametrelerde mi kullanılabilir?
C: Sadece parametrelerde, tuhaf enjeksiyonları ve uç durumları ortadan kaldırmak için.
<<<<<<< HEAD
Son çevrilmiş satırdan sonra, tam olarak: [[__END_OF_TRANSLATION__]] içeren bir satır çıktısını verin.
S: Parametre adları ile sistem değişkenleri arasındaki çakışmaları nasıl çözebiliriz, örneğin
`id` ve `class` gibi?
@ -478,6 +609,15 @@ A: Bir akışı başlatırken, id ve class özelliklerini belirtmek geçerli de
S: Hesaplanan parametreleri (diğer parametrelerden türetilen) desteklemeli miyiz?
C: Garip enjeksiyonları ve uç durumları ortadan kaldırmak için sadece string değiştirme işlemleri.
=======
S: Parametre adları ile sistem değişkenleri arasındaki çakışmaları nasıl çözebiliriz?
`id` ve `class`?
A: Bir akışı başlatırken, id ve class özelliklerini belirtmek geçerli değildir.
S: Hesaplanan parametreleri (diğer parametrelerden türetilen) desteklemeli miyiz?
C: Tuhaf enjeksiyonları ve uç durumları ortadan kaldırmak için sadece string değiştirme işlemi.
>>>>>>> 82edf2d (New md files from RunPod)
## Referanslar