trustgraph/docs/tech-specs/flow-configurable-parameters.tr.md

layout	title	parent
default	Akış Şeması Yapılandırılabilir Parametreler Teknik Özellikleri	Turkish (Beta)

Akış Şeması Yapılandırılabilir Parametreler Teknik Özellikleri

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.

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.

<<<<<<< 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:

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. <<<<<<< 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}"

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.

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ı 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. ======= Yapılandırılabilir parametreler sistemi, aşağıdaki teknik bileşenleri gerektirir:

3. 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

4. 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/

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:

{
  "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:

{
  "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) <<<<<<< 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: 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:

{
  "flow_class": "document-analysis",
  "flow_id": "customer-A-flow",
  "parameters": {
    "llm-model": "claude-3",
    "llm-temperature": 0.5,
    "chunk-size": 1024
  }
}

<<<<<<< HEAD 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.

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)

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 <<<<<<< 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: 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 <<<<<<< 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 =======
10. Şablon Yerine Koyma: İşlemci parametrelerindeki parametre yer tutucularını çözümlenmiş değerlerle değiştirin
11. İş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ı 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:

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)

Ö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 <<<<<<< 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:

{
  "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:

   {
     "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

   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 <<<<<<< 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 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

<<<<<<< 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

CLI Entegrasyonu

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

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 <<<<<<< 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 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 <<<<<<< 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:

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ı

<<<<<<< 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

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.

<<<<<<< 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? 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.

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

JSON Şema Özellikleri: https://json-schema.org/ Akış Tanım Özellikleri: docs/tech-specs/flow-class-definition.md