2026-04-10 23:20:41 -04:00
---
layout: default
title: "Akı ş Şeması Yapı landı rı labilir Parametreler Teknik Özellikleri"
parent: "Turkish (Beta)"
---
2026-04-10 12:22:20 -04:00
# Akı ş Şeması Yapı landı rı labilir Parametreler Teknik Özellikleri
2026-04-10 23:20:41 -04:00
> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
2026-04-10 12:22:20 -04:00
## Genel Bakı ş
Bu özellik, TrustGraph'taki akı ş şemaları için yapı landı rı labilir parametrelerin uygulanması nı açı 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.
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Bu entegrasyon, dört birincil kullanı m senaryosunu destekler:
1. **Model Seçimi** : Kullanı cı ları n farklı LLM modellerini (örneğin, `gemma3:8b` , `gpt-4` , `claude-3` ) işlemciler için seçmesine izin verme.
2. **Kaynak Yapı landı rması ** : Parça boyutları , toplu boyutlar ve eşzamanlı lı k limitleri gibi işlemci parametrelerini ayarlama.
3. **Davranı ş Ayarı ** : Sı caklı k, maksimum-token veya alma eşikleri gibi parametreler aracı lı ğı yla işlemci davranı şı nı değiştirme.
4. **Ortama Özgü Parametreler** : Dağı tı m başı na uç noktaları , API anahtarları nı veya bölgeye özgü URL'leri yapı landı rma.
## Hedefler
**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.
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
**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.
2026-04-11 01:08:44 +00:00
=======
**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)
2026-04-10 12:22:20 -04:00
## 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.
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Mevcut işlemci parametreleri şunları desteklemektedir:
Sabit değerler: `"model": "gemma3:12b"`
Parametre yer tutucuları : `"model": "gemma3:{model-size}"`
Bu özellik, parametrelerin nası l olduğu tanı mlamaktadı r:
Akı ş şeması tanı mları nda beyan edilmesi
Akı şları n başlatı ldı ğı zaman doğrulanması
İşlemci parametrelerinde yerleştirilmesi
API'ler ve kullanı cı arayüzü aracı lı ğı yla açı ğa çı karı lması
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.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
## Teknik Tasarı m
### Mimari
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Yapı landı rı labilir parametreler sistemi, aşağı daki teknik bileşenleri gerektirmektedir:
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ümleme Motoru**
Şemaya karşı çalı şma zamanı parametre doğrulaması .
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.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Modül: trustgraph-flow/trustgraph/flow/parameter_resolver.py
3. **Parametre Deposu Entegrasyonu**
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Ş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.
2026-04-11 01:08:44 +00:00
=======
Ş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)
2026-04-10 12:22:20 -04:00
Modül: trustgraph-flow/trustgraph/flow/parameter_store.py
4. **Akı ş Başlatı cı Uzantı ları **
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Modül: trustgraph-flow/trustgraph/flow/launcher.py
5. **Kullanı cı Arayüzü Parametre Formları **
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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ı .
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Modül: trustgraph-ui/components/flow-parameters/
### Veri Modelleri
#### Parametre Tanı mları (Şema/Yapı landı rmada Saklanı r)
Parametre tanı mları , "parameter-type" türüyle şema ve yapı landı rma sisteminde merkezi olarak saklanı r:
```json
{
"llm-model": {
"type": "string",
"description": "LLM model to use",
"default": "gpt-4",
"enum": [
{
"id": "gpt-4",
"description": "OpenAI GPT-4 (Most Capable)"
},
{
"id": "gpt-3.5-turbo",
"description": "OpenAI GPT-3.5 Turbo (Fast & Efficient)"
},
{
"id": "claude-3",
"description": "Anthropic Claude 3 (Thoughtful & Safe)"
},
{
"id": "gemma3:8b",
"description": "Google Gemma 3 8B (Open Source)"
}
],
"required": false
},
"model-size": {
"type": "string",
"description": "Model size variant",
"default": "8b",
"enum": ["2b", "8b", "12b", "70b"],
"required": false
},
"temperature": {
"type": "number",
"description": "Model temperature for generation",
"default": 0.7,
"minimum": 0.0,
"maximum": 2.0,
"required": false
},
"chunk-size": {
"type": "integer",
"description": "Document chunk size",
"default": 512,
"minimum": 128,
"maximum": 2048,
"required": false
}
}
```
#### Parametre Referansları yla Akı ş Şeması
Akı ş şemaları , tür referansları , açı klamalar ve sı ralama ile parametre meta verilerini tanı mlar:
```json
{
"flow_class": "document-analysis",
"parameters": {
"llm-model": {
"type": "llm-model",
"description": "Primary LLM model for text completion",
"order": 1
},
"llm-rag-model": {
"type": "llm-model",
"description": "LLM model for RAG operations",
"order": 2,
"advanced": true,
"controlled-by": "llm-model"
},
"llm-temperature": {
"type": "temperature",
"description": "Generation temperature for creativity control",
"order": 3,
"advanced": true
},
"chunk-size": {
"type": "chunk-size",
"description": "Document chunk size for processing",
"order": 4,
"advanced": true
},
"chunk-overlap": {
"type": "integer",
"description": "Overlap between document chunks",
"order": 5,
"advanced": true,
"controlled-by": "chunk-size"
}
},
"class": {
"text-completion:{class}": {
"request": "non-persistent://tg/request/text-completion:{class}",
"response": "non-persistent://tg/response/text-completion:{class}",
"parameters": {
"model": "{llm-model}",
"temperature": "{llm-temperature}"
}
},
"rag-completion:{class}": {
"request": "non-persistent://tg/request/rag-completion:{class}",
"response": "non-persistent://tg/response/rag-completion:{class}",
"parameters": {
"model": "{llm-rag-model}",
"temperature": "{llm-temperature}"
}
}
},
"flow": {
"chunker:{id}": {
"input": "persistent://tg/flow/chunk:{id}",
"output": "persistent://tg/flow/chunk-load:{id}",
"parameters": {
"chunk_size": "{chunk-size}",
"chunk_overlap": "{chunk-overlap}"
}
}
}
}
```
`parameters` bölümü, akı şa özgü parametre adları nı (anahtarları ), parametre meta veri nesnelerine eşler ve bu nesneler şunları içerir:
`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)
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
`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
2026-04-11 01:08:44 +00:00
=======
`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)
2026-04-10 12:22:20 -04:00
`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:
Birden çok akı ş şablonu arası nda yeniden kullanı labilir parametre türü tanı mları
Merkezi parametre türü yönetimi ve doğrulaması
Akı şa özgü parametre açı klamaları ve sı ralaması
Açı klayı cı parametre formları yla geliştirilmiş kullanı cı arayüzü deneyimi
Akı şlar genelinde tutarlı parametre doğrulaması
Yeni standart parametre türlerinin kolayca eklenmesi
Temel/gelişmiş mod ayrı mı yla basitleştirilmiş kullanı cı arayüzü
İlgili ayarlar için parametre değeri devralı mı
#### Akı ş Başlatma İsteği
Akı ş başlatma API'si, parametreleri akı şı n parametre adları nı kullanarak alı r:
```json
{
"flow_class": "document-analysis",
"flow_id": "customer-A-flow",
"parameters": {
"llm-model": "claude-3",
"llm-temperature": 0.5,
"chunk-size": 1024
}
}
```
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Not: Bu örnekte, `llm-rag-model` açı 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.
2026-04-11 01:08:44 +00:00
=======
Not: Bu örnekte, `llm-rag-model` açı 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)
2026-04-10 12:22:20 -04:00
Sistem şunları yapacaktı r:
1. Akı ş tanı mı ndan parametre meta verilerini çı karı n
2. Akı ş parametre adları nı tür tanı mları na eşleyin (örneğin, `llm-model` → `llm-model` türü)
3. "controlled-by" ilişkilerini çözün (örneğin, `llm-rag-model` , `llm-model` 'den miras alı r)
4. Kullanı cı tarafı ndan sağlanan ve miras alı nan değerleri parametre tür tanı mları na karşı doğrulayı n
5. Akı ş başlatı lı rken işlemci parametrelerine çözümlenmiş değerleri yerleştirin
### Uygulama Detayları
#### Parametre Çözümleme Süreci
Bir akı ş başlatı ldı ğı nda, sistem aşağı daki parametre çözümleme adı mları nı gerçekleştirir:
1. **Akı ş Tanı m Yükleme** : Akı ş tanı mı nı yükleyin ve parametre meta verilerini çı karı n
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
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Tür tanı mları , yapı landı rma sisteminde "parameter-type" türüyle saklanı r
2026-04-11 01:08:44 +00:00
=======
Tür tanı mları , yapı landı rma sisteminde "parameter-type" türü ile saklanı r
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
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:
Kullanı cı nı n bu parametre için bir değer sağlayı p sağlamadı ğı nı kontrol edin
Kullanı cı tarafı ndan bir değer sağlanmazsa, parametre tür tanı mı ndan `default` değerini kullanı n
Hem kullanı cı tarafı ndan sağlanan hem de varsayı lan değerleri içeren eksiksiz bir parametre haritası oluşturun
5. **Parametre Miras Alma Çözümleme** ("controlled-by" ilişkileri):
`controlled-by` alanı olan parametreler için, bir değerin açı kça sağlandı ğı nı kontrol edin
Açı k bir değer sağlanmazsa, kontrol eden parametrenin değerini miras alı n
Kontrol eden parametrenin de bir değeri yoksa, tür tanı mı ndan varsayı lanı kullanı n
`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
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
**Ö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
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Varsayı lanları olmayan gerekli parametrelerin eksik olması , akı şı n başlatı lması nı açı 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:
2026-04-11 01:08:44 +00:00
=======
Varsayı lanları olmayan gerekli parametrelerin eksik olması , akı şı n başlatı lması nı açı 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)
2026-04-10 12:22:20 -04:00
**Örnek Senaryo**:
`llm-model` parametresi birincil LLM modelini kontrol eder
`llm-rag-model` parametresi `"controlled-by": "llm-model"` 'e sahiptir
Basit modda, `llm-model` 'ı "gpt-4" olarak ayarlamak, otomatik olarak `llm-rag-model` 'i de "gpt-4" olarak ayarlar
Gelişmiş modda, kullanı cı lar `llm-rag-model` 'ı farklı bir değerle geçersiz kı labilir
**Çözüm Kuralları **:
1. Bir parametrenin açı kça sağlanan bir değeri varsa, o değeri kullanı n
2. Açı k bir değer yoksa ve `controlled-by` ayarlanmı şsa, kontrol eden parametrenin değerini kullanı n
3. Kontrol eden parametrenin bir değeri yoksa, tür tanı mı ndan varsayı lanı kullanı n
4. `controlled-by` ilişkilerinde döngüsel bağı mlı lı klar, bir doğrulama hatası na neden olur
**Kullanı cı Arayüzü Davranı şı **:
Temel/basit modda: `controlled-by` 'a sahip parametreler gizlenebilir veya miras alı nan değerle birlikte yalnı zca okunabilir olarak gösterilebilir
Gelişmiş modda: Tüm parametreler gösterilir ve ayrı ayrı yapı landı rı labilir
Bir kontrol eden parametre değiştiğinde, bağı mlı parametreler açı kça geçersiz kı lmadı kça otomatik olarak güncellenir
#### Pulsar Entegrasyonu
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
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Pulsar için akı ş başlatma isteği şeması , isteğe bağlı `parameters` alanı nı içerecek şekilde güncellenmelidir
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Örnek istek:
```json
{
"flow_class": "document-analysis",
"flow_id": "customer-A-flow",
"parameters": {
"model": "claude-3",
"size": "12b",
"temp": 0.5,
"chunk": 1024
}
}
```
2. **Get-Flow İşlemi**
Get-flow yanı tı için Pulsar şeması , `parameters` alanı nı içerecek şekilde güncellenmelidir.
Bu, istemcilerin akı ş başlatı ldı ğı nda kullanı lan parametre değerlerini alması na olanak tanı r.
Örnek yanı t:
```json
{
"flow_id": "customer-A-flow",
"flow_class": "document-analysis",
"status": "running",
"parameters": {
"model": "claude-3",
"size": "12b",
"temp": 0.5,
"chunk": 1024
}
}
```
#### Akı ş Hizmeti Uygulaması
Akı ş yapı landı rma hizmeti (`trustgraph-flow/trustgraph/config/service/flow.py` ), aşağı daki geliştirmeleri gerektirmektedir:
1. **Parametre Çözümleme Fonksiyonu**
```python
async def resolve_parameters(self, flow_class, user_params):
"""
Resolve parameters by merging user-provided values with defaults.
Args:
flow_class: The flow blueprint definition dict
user_params: User-provided parameters dict
Returns:
Complete parameter dict with user values and defaults merged
"""
```
Bu fonksiyonun yapması gerekenler:
Akı ş şeması nı n `parameters` bölümünden parametre meta verilerini çı karı n
Her parametre için, yapı landı rma deposundan tür tanı mı nı alı n
Kullanı cı tarafı ndan sağlanmayan parametreler için varsayı lan değerleri uygulayı n
`controlled-by` miras ilişkilerini işleyin
Tam parametre kümesini döndürün
2. **Değiştirilen `handle_start_flow` Metodu**
Akı ş şeması nı yükledikten sonra `resolve_parameters` 'ı çağı rı n
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Ş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
2026-04-11 01:08:44 +00:00
=======
Ş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)
2026-04-10 12:22:20 -04:00
Tüm gerekli parametrelerin değerlere sahip olduğundan emin olun
3. **Parametre Türü Alma**
Parametre tür tanı mları , "parameter-type" türüyle yapı landı rmada saklanı r
Her tür tanı mı , şema, varsayı lan değer ve doğrulama kuralları nı içerir
Sı k kullanı lan parametre türlerini önbelleğe alı n, böylece yapı landı rma aramaları azalı r
#### Yapı landı rma Sistemi Entegrasyonu
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Yapı landı rma sistemindeki akı ş nesneleri şunları içermelidir:
`parameters` : Akı ş için kullanı lan son çözülmüş parametre değerleri
#### CLI Entegrasyonu
4. **Kütüphane CLI Komutları **
Akı şları başlatan CLI komutları parametre desteğine sahip olmalı dı r:
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Parametre değerlerini komut satı rı bayrakları veya yapı landı rma dosyaları aracı lı ğı yla alı n
2026-04-11 01:08:44 +00:00
=======
Parametre değerlerini komut satı rı bayrakları veya yapı landı rma dosyaları aracı lı ğı yla kabul edin
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
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
Akı şları gösteren CLI komutları parametre bilgilerini görüntülemelidir:
Akı ş başlatı ldı ğı nda kullanı lan parametre değerlerini gösterin
Bir akı ş şeması için mevcut parametreleri görüntüleyin
Parametre doğrulama şemaları nı ve varsayı lanları gösterin
#### İşlemci Temel Sı nı f Entegrasyonu
5. **ParameterSpec Desteği**
İşlemci temel sı nı fları , mevcut ParametersSpec mekanizması aracı lı ğı yla parametre yerleştirmesini desteklemelidir
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
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
Yerleştirilen değerlerin beklenen türlere ve kı sı tlamalara uyduğunu doğrulayı n
Eksik veya geçersiz parametre başvuruları için hata işleme sağlayı n
#### Yerleştirme Kuralları
Parametreler, işlemci parametrelerinde `{parameter-name}` biçimini kullanı r
Parametrelerdeki parametre adları , akı şı n `parameters` bölümündeki anahtarlarla eşleşir
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
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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)
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
Bu, `parameters = Map(String())` tanı mlayan Pulsar şeması gerekliliğidir
Örnek çözüm:
```
Flow parameter mapping: "model": "llm-model"
Processor parameter: "model": "{model}"
User provides: "model": "gemma3:8b"
Final parameter: "model": "gemma3:8b"
Example with type conversion:
Parameter type default: 0.7 (number)
Stored in flow: "0.7" (string)
Substituted in processor: "0.7" (string)
```
## Test Stratejisi
Parametre şema doğrulama için birim testleri
İşlemci parametrelerindeki parametre yerleştirme için entegrasyon testleri
Farklı parametre değerleriyle akı şları başlatmak için uçtan uca testler
Parametre formu oluşturma ve doğrulama için kullanı cı arayüzü testleri
Çok sayı da parametre içeren akı şlar için performans testleri
Kenar durumları : eksik parametreler, geçersiz türler, tanı mlanmamı ş parametre referansları
## Geçiş Planı
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
## Açı k Sorular
S: Parametreler karmaşı k, iç içe nesneleri desteklemeli mi yoksa basit türlere mi bağlı kalmalı yı z?
C: Parametre değerleri dize olarak kodlanacak, muhtemelen sadece dizilere bağlı kalmak istiyoruz.
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.
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
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?
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: Garip enjeksiyonları ve uç durumları ortadan kaldı rmak için sadece string değiştirme işlemleri.
2026-04-11 01:08:44 +00:00
=======
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)
2026-04-10 12:22:20 -04:00
## Referanslar
JSON Şema Özellikleri: https://json-schema.org/
Akı ş Tanı m Özellikleri: docs/tech-specs/flow-class-definition.md