Aggrega geliştirici niyeti (Aggregate) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json
Özyinelemeli, parametreli yapay zekâ mimarisi. Hem bir derlemenin kökü hem de yeniden kullanılabilir modül olarak işlev görür.
Aggregate varlıklarının yazımına ilişkin açıklamalı rehberlik için Aggregate yazım başvurusuna bakın; bu sayfa, o başvurunun açıkladığı yapısal şemayı belgeler.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “Aggregate” | evet | Sabit: "Aggregate" |
metadata | object | evet | |
defs | string[] | hayır | Derleyici için düz bir O(1) sözlüğü korurken Aggregate’i DRY tutmak amacıyla standart YAML çapaları (& ve *) için isteğe bağlı blok. Manifest üzerindeki eşdeğer bloğu yansıtır. |
spec | object | evet | Geliştirici Niyeti yüzeyi: genel parametre sözleşmesi, iç içe aggregate içe aktarımları, dışa aktarılan bileşenlerin genel API’si, alt sistem gruplamaları ve modülü oluşturan bileşen örnekleri. |
Ek özelliklere izin verilmez.
aggregate.metadata
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | En az 1 karakter uzunluğunda. |
version | string | evet | Aggregate modülünün katı Anlamsal Sürümlemesi. Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | hayır | |
maintainers | object[] | hayır | Bu varlığın sahibi olan bakımcıların listesi. |
license | string | hayır | Bu varlığın tanımladığı yazılımın lisansı için MIT veya AGPL-3.0 gibi bir SPDX tanımlayıcısı. Bu dosyanın koşullarını değil, o yazılımın koşullarını kaydeder. |
repository | string | hayır | Kaynak dosyaların bulunduğu Git deposunun URL’si. |
home | string | hayır | Bu varlığın ana sayfasının, wiki’sinin veya belgelerinin URL’si. |
keywords | string[] | hayır | Kullanıcı arayüzünde keşfedilebilirlik için tanımlayıcı anahtar sözcüklerin listesi. |
labels | string eşlemi | hayır | Katalog keşfi, ilke değerlendirmesi ve Studio/IDE filtrelemesi için modül düzeyinde duck-typing etiketleri. Bu etiketler Aggregate’in yeniden kullanılabilir bir modül olarak kimliğini tanımlar (ör. aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). Alt bileşen düğümlerine aktarılmazlar; bileşen etiketleri yalnızca Alan 2’deki Component katalog varlığından gelir. |
Ek özelliklere izin verilmez.
aggregate.metadata.maintainers[]
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | |
email | string | hayır | |
url | string | hayır |
Ek özelliklere izin verilmez.
aggregate.spec
Geliştirici Niyeti yüzeyi: genel parametre sözleşmesi, iç içe aggregate içe aktarımları, dışa aktarılan bileşenlerin genel API’si, alt sistem gruplamaları ve modülü oluşturan bileşen örnekleri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
parameters | object eşlemi | hayır | Genel ortam sözleşmesi. Her girdi, kompakt biçim sözcük dağarcığının alt kümesini (type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties) yazan, türü belirlenmiş bir sözleşme nesnesidir. İç içe yapı, türlü biçimin properties: alt alanıyla ifade edilir. Release karşılaması satır içi (parameters: {…}) ya da tek kaynaklı dosya içe aktarımı (parameters: {$import: |
aggregates | object eşlemi | hayır | İçe aktarılan modüller olarak işlev gören iç içe aggregate’ler. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$. |
exportedComponents | string eşlemi | hayır | Genel API Arayüzü. Açığa çıkarılan bir genel adı dahili bir bileşen kimliğine eşler. Bu modülü içe aktaran üst Aggregates, bileşenlere bu genel adlarla başvurur. |
subsystems | subsystem eşlemi | hayır | Bir Aggregate’in bileşenlerinin alt sistemlere adlandırılmış mantıksal gruplamaları. Üst düzey components ile birbirini dışlar; ikisinin birden bildirilmesi reddedilir. Yazarın default olarak adlandırdığı bir alt sistem, sıradan bir bildirilmiş alt sistemdir ve derleyicinin yalnızca components içeren bir Aggregate için sentezlediği default’tan ayrıdır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$. |
components | component_instance eşlemi | hayır | Bu Aggregate’i oluşturan, doğrudan üst düzeyde yazılan mantıksal atomik bileşenlerin eşlemi. Üst düzey components ile subsystems birbirini dışlar; ikisinin birden bildirilmesi reddedilir. Bileşenler burada (subsystems olmadan) yazıldığında, derleyici yükleme sırasında bunları sentezlenmiş bir default alt sisteme katlar ve IR bu alt sistemi sentezlenmiş olarak işaretler. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi veya kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$. |
Ek özelliklere izin verilmez.
Tanımlar
inject_delivery
Bir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features.
Tür: object[]
inject_block
Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri hedefin provides anahtarlarına (uses[].inject), bir iliştirmenin FeatureRecipe’sinin yayımladığı provides anahtarlarına (features.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | inject_delivery | hayır | Bir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features. |
file | inject_delivery | hayır | Bir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features. |
arg | inject_delivery | hayır | Bir girdi dizisi olarak yazılan tek bir teslim mekanizması. Her girdi bir ‘in’ (yerel tanımlayıcı — ortam değişkeni adı, dosya yolu, argüman bayrağı veya mekanizmaya özgü özel bir anahtar) ve buna ek olarak ‘from’ (çözümlenecek bir provides anahtarı) ya da ‘value’ (isteğe bağlı olarak self-inject çözümlemesinde değerlendirilen Go şablon ifadeleri içeren düz bir dize) alanlarından tam olarak birini taşır. ‘from’, uses[].inject bağlamında hedefin provides değerlerine, bir iliştirmenin features. |
component_uses_block
Bir bileşenin bağımlı olduğu bileşenlere kurduğu bağlantılar, sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir takma ad altında adlandırılan bağlantı, geliştiricinin bağlantıya özgü değerlerini ve soketin bildirdiği yuvaları dolduran ekleri taşıyabilir.
Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.
Değerler string[] or map of object türündedir.
Başka hiçbir anahtara izin verilmez.
feature_uses_block
Eklenmiş bir Feature’ın kurduğu bağlantılar; Feature’ın usesSchema içinde bildirdiği bir sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir Feature’ın kurduğu bağlantı kendine ait ek taşımaz: ihtiyaç duyduğu bir kimlik bilgisi, Feature’ın kendi featuresSchema içinde bildirdiği bir yuvayı doldurur ve Feature’ın yanına eklenir.
Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$.
Değerler string[] or map of object türündedir.
Başka hiçbir anahtara izin verilmez.
connection_attachment
Bir bağlantının taşıdığı tek bir ek: bağlantının soketinin bildirdiği bir yuvayı dolduran Feature ve geliştiricinin onun için verdiği yapılandırma.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | Bu ekin talep ettiği Feature arayüzünün URI’si (ör. core/referenced-secret:1.0.0). |
description | string | hayır | Bu bağlantının eki neden taşıdığını açıklayan isteğe bağlı belgeleme. |
values | object | hayır | Feature için geliştirici tarafından sağlanan, şema bildirimiyle doğrulanan yapılandırma. |
Ek özelliklere izin verilmez.
subsystem
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
description | string | hayır | Bu alt sistemin amacını ve temsil ettiği mantıksal gruplamayı açıklayan isteğe bağlı belgeleme. |
annotations | string, object veya null eşlemi | hayır | Bu alt sistem üzerinde geliştirici tarafından yazılan ek açıklamalar. Değerler dize, yapılandırılmış nesne (alt anahtardan değere bir eşlem; devralınan yapılandırılmış bir değerle alt anahtar bazında birleştirilir) veya null’dır; üst alt sistemden devralınan bir anahtar üzerinde açıkça belirtilen null, devralınan bağlamayı bu alt sistemden kaldırır (ek açıklamaya dayalı Feature devre dışı bırakma). Burada bildirilen ek açıklamalar iç içe alt sistemlere ve içerilen bileşenlere devredilir; anahtar bazında daha yakın düzey geçerli olur. Türetilen her IR düğümündeki .context.annotations.aggregate kümesine kadar aşağı doğru aktarılır. |
features | object eşlemi | hayır | Bu alt sistemdeki tüm bileşenlere eklenen kesişen özellikler. Bileşen düzeyindeki özelliklerle aynı şemaya sahiptir (type, values, uses, inject). Graf sonlandırılırken her bileşene düzleştirilir ve yürütme sırasında bileşen düzeyindeki özelliklerden sonra konumlanır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$. |
subsystems | subsystem eşlemi | hayır | Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$. |
components | component_instance eşlemi | hayır | Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Nokta kullanılamaz. Desen: ^[a-zA-Z0-9_-]+$. |
Ek özelliklere izin verilmez.
component_instance
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | İstenen soyut Component, bir başvuru olarak: metadata.name değeri ile isteğe bağlı bir :version (ör. core/api-server:1.0.0); asla bir dosya yolu değil. Üç Katmanlı Varlık Çözümleme Modeli (çalışma alanı katalog dizinleri → önbellek → kayıt defteri) ile çözümlenir: yerel olarak yazılan bir Component, çalışma alanı kökündeki catalog/ altına veya workspace.catalog_dirs altında listelenen bir dizine yerleştirilir; göreli dosya yolu olarak yazılan bir type ise hiçbir kataloğun içermediği bir varlık olarak derlemeyi durdurur. |
active | boolean veya string | hayır | Bu bileşenin derlenmiş topolojide bulunup bulunmadığı. Bir boolean ya da .parameters üzerinde, bir boolean’a çözümlenmesi gereken bir string şablonu. false olarak çözümlendiğinde bileşen topolojiden budanır; bu, bileşenin uses kenarlarına ve eklerine de yayılır. Değerin bir parametreden türetilmesi, bir Release’in o parametreyi karşılayarak bileşenin varlığını açıp kapatmasını sağlar. Belirtilmediğinde varsayılan değer true’dur. Varsayılan: true |
description | string | hayır | Bu bileşen örneğinin uygulamadaki rolünü açıklayan isteğe bağlı belgeler. IR grafiğine taşınır. |
annotations | string, object veya null eşlemi | hayır | Bu bileşen üzerinde geliştiricinin yazdığı ek açıklamalar (annotations). Değerler dize, yapılandırılmış nesne (alt anahtardan değere bir eşlem; devralınan yapılandırılmış bir değerle alt anahtar bazında birleştirilir) veya null’dır; bir üst alt sistemden devralınan bir anahtar üzerinde açıkça verilen null, devralınan bağlamayı bu bileşenden kaldırır (ek açıklamayla yönlendirilen Feature devre dışı bırakma). Component düzeyindeki ek açıklamalar, devralınan alt sistem düzeyindeki ek açıklamaları anahtar bazında geçersiz kılar; aynı alt sistemdeki kardeş bileşenler kendi ek açıklama eşlemlerini birbirinden bağımsız olarak korur. |
values | object | hayır | Component’e aktarılan, şeması tarafından doğrulanan opak bilişsel özellikler. |
uses | component_uses_block | hayır | Bir bileşenin bağımlı olduğu bileşenlere kurduğu bağlantılar, sokete göre anahtarlanır. Her soket hedeflerini listeler ya da her bağlantıyı bir takma ad altında adlandırır. Bir takma ad altında adlandırılan bağlantı, geliştiricinin bağlantıya özgü değerlerini ve soketin bildirdiği yuvaları dolduran ekleri taşıyabilir. |
inject | inject_block | hayır | Bileşen düzeyinde self-inject. Bileşenin kendi değerlerini (‘value:’ ile) ya da kendi provides anahtarlarını (‘from:’ ile) doğrudan teslim hattına (.context.inject) enjekte eder. Yalnızca Component katalog varlığı ilgili mekanizmalarla ‘spec.inject’ bildiriyorsa izin verilir. uses[].inject içinde bildirilen bir anahtarla çakışan bir inject anahtarı, inject kaynakları arasında yinelenen bir teslim anahtarı olarak derlemeyi durdurur. |
features | object eşlemi | hayır | Bu bileşene eklenen Features; yazarın her eke verdiği örnek adına göre anahtarlanır. Bu, tek ekleme yüzeyidir: operasyonel bir Feature, bir kimlik bilgisi Feature’ı (feature.aggrega.ai/kind: secret etiketli olan) ve bir kimlik Feature’ı, aynı anahtar sözcük ve aynı biçim altında burada eklenir. Aralarındaki fark, ekin nasıl bildirildiği değil, ne ürettiğidir. Örnek adı, Component’in featuresSchema içinde bildirdiği bir yuvayla eşleşen ek o yuvayı doldurur; diğer her örnek adı serbest bir ektir. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$. |
Ek özelliklere izin verilmez.