İçe aktarma
aggrega import, başka bir biçimde yazılmış bir projeyi — Langflow’dan dışa aktarılmış bir akışı, bir MCP istemcisinin yapılandırmasını, bir Compose dosyasını ve aşağıda listelenen diğer biçimleri — okur ve ondan Aggrega dosyaları yazar: bir Aggregate, bir Release ve --target’ın belirttiği hedef için bir Manifest. Hiçbir kaynağın tutamayacağı birkaç değer yanıtlandığında, bunlar birlikte yazıldığı haliyle doğrulanan ve derlenen bir çalışma alanı oluşturur: içe aktarma bu değerlerin her birini bir kez sorar ve yanıtları bir yanıt dosyasında saklar. Hiçbir şeyi dağıtmaz ve hiçbir kümeye ya da bulut hesabına erişmez. Taslaklar çalışma alanınızdaki düz dosyalardır ve onlara bundan sonra ne olacağı size kalmıştır.
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
aggrega importtaslak Aggrega dosyaları
gözden geçirmeniz ve düzenlemeniz için
Mevcut projeniz girer, taslak Aggrega dosyaları çıkar. Hiçbir şey dağıtılmaz; taslakları önce siz gözden geçirirsiniz.
Size ne kazandırır
- Projeniz elle yeniden yazılmadan Aggrega’ya ulaşır. Taslağı hazırlanan Aggregate, Release ve Manifest, kendiniz yazacağınız türden dosyalardır. Yazıldıkları haliyle içe aktarmanın belirttiği hedef için derlenirler ve çalışma alanınızın eklediği her yönetişim politikası bu derlemeyi diğerleri gibi değerlendirir.
- Kaynağın belirttikleri aktarılır. Kataloğun güçlü bir eşleşme içerdiği bir düğüm ya da hizmet, kaynağın ona verdiği değerlerle, örneğin bir akışın belirttiği modelle birlikte o katalog Component’ine başvurur. Kaynağın üzerinde çalıştığı bir platformun taslağı, kataloğun o platform için Recipes’inin çalıştırdığı imajla hazırlanır. Bir gizli bilginin taslağı hiçbir zaman değeri olarak değil, nereden geldiğine yapılan bir başvuru olarak hazırlanır.
- Size yalnızca hiçbir kaynağın tutamayacağı şeyler, bir kez sorulur. Yanıtlar kaynağın yanındaki bir yanıt dosyasında saklanır; böylece aynı kaynağın bir sonraki içe aktarımı hiçbir şey sormaz.
- Taslaklar sizindir. Çalışma alanınızdaki düz YAML dosyalarıdır ve geride derlemenin bağımlı olduğu hiçbir şey bırakmazlar. Onları düzenleyin, yeniden adlandırın, commit edin.
- Taslak kaynağını izleyebilir.
aggrega import --sync, önceki bir içe aktarmanın taslaklarını değişen bir kaynağa göre günceller ve yalnızca içe aktarmanın yazdıklarını değiştirir. Kaynak, sizin düzenlediğiniz bir bölümü değiştirdiyse, düzenlemenizin üzerine yazmak yerine durur ve o bölümü adlandırır.
Ne yapmadığı
Bir içe aktarma, kaynağın belirttiklerinin ve kataloğunuzun belirlediklerinin taslağını hazırlar, gerisini sorar. Her taslak, hazırladığı bir değerin nereden geldiğini değerin yanındaki bir yorumda belirtir.
- Kaynağınızın belirtemeyeceği şeyleri tahmin etmez. Hiçbir kaynak bir Release’in dağıtıldığı ortamı belirtmez; bu nedenle taslağı hazırlanan Release
development’ı belirtir ve bunun değiştirilmesi gereken bir varsayılan olduğunu söyleyen bir yorum içerir. Kataloğun gerektirdiği ve hiçbir kaynağın tutmadığı bir değer — bir sahip hesabının e-postası, kendi kodunuzdan derlenen bir uygulamanın imajı, bir Kubernetes Secret’ının adı — boş olarak taslağa yazılır ve aşağıda Bir içe aktarma nasıl çalışır bölümünün anlattığı gibi sorulur. - Kod okumaz. Bir akışın ya da bir projenin kendi programı okunmaz: bir CrewAI ekibinin programı, bir LangGraph uygulamasının çizge kodu, bir Langflow bileşeninin kaynak kodu, akışın içinde taşınması dışında.
- Bir değerin ne anlama geldiğini yargılamaz. Her düğüm ya da hizmet, çalışma alanınızın kataloğundaki Components ile karşılaştırılır — adları, kategorileri, etiketleri ve bildirdikleri değerlerin adları. Yüksek kademedeki bir eşleşmeye taslakta başvurulur; daha zayıf olanı, Component’i ve puanını belirten bir yorum olarak yazılır ve seçimi siz yaparsınız.
- Kaynağı izlemek için bir platformun çalıştırdığı sürümü değiştirmez. Bir platformun imajının taslağı, kataloğun o platform için Recipes’inin çalıştırdığı bilinen sürümle hazırlanır ve kaynak başka bir sürüm belirttiğinde imajın yanındaki bir yorum bu sürümü belirtir.
- Kimlik bilgilerini sizin yerinize kaynağınızdan çıkarmaz. Bir anahtar taşıyabilen bir değer — bir ortam değeri, bir başlık, bir MCP sunucusunun komut satırı — varsayılan olarak taslağa yazıldığı gibi taşınır ve içe aktarma her birini, asla değeriyle değil, bir
credential-carrieduyarısında adlandırır. İçe aktarıcınınempty_credentialsayarı bunları bunun yerine boş yazar (Ayarlar). Bir taslağı paylaşmadan önce uyarıları okuyun. - Hiçbir şeyi dağıtmaz ya da çalıştırmaz. Kaynağı ve kataloğunuzu okur ve dosya yazar. Taslakları derlemek ve derlemenin yazdıklarını çalıştırmak, sizin attığınız ayrı adımlardır.
Bir içe aktarma nasıl çalışır
Bir içe aktarmayı aşağıdaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin için çalıştırtabilirsiniz.
-
Bir çalışma alanından başlayın. Bir içe aktarma, taslaklarını çalıştığı çalışma alanının kökü altına — bir
.aggrega-config.yamldosyasını birworkspaceanahtarıyla barındıran klasör — ya da--output-dir’in belirttiği dizinin altına yazar. Zaten orada bulunan bir Aggregate’in üzerine asla yazmaz. -
Karşılaştırdığı katalog. İçe aktarma, kaynağınızı çalışma alanının kataloğundaki Components ile puanlar, başka hiçbir şeyle değil. Çalışma alanı kendine ait bir katalog klasörü belirtmediğinde bu, çalışma alanının varsayılan kayıt defterinden okunan standart kütüphane kataloğudur: kataloğun her yayımlanışı, kataloğun tamamının imzalı bir anlık görüntüsünü yayımlar ve ilk içe aktarma bu anlık görüntüyü getirir, imzasını doğrular, çalışma alanının içerik önbelleğinde saklar ve taslakların yanına yazdığı kayıtta onu özet değeriyle adlandırır; böylece aynı taslakların sonraki bir içe aktarması, kayıt defterine yeniden sormadan aynı kataloğu okur. Ona karşı bir PostgreSQL hizmeti
core/datastore/postgresile eşleştirilir ve--targetkataloğun Recipes’inden bir Manifest taslağı hazırlar. Katalog yoksa içe aktarmanın eşleştireceği bir şey olmaz ve hedefe hiçbir Recipe bağlanmadığından--targetreddedilir.Kendi katalog klasörlerini belirten bir çalışma alanı bunun yerine onlara karşı içe aktarır ve hiçbir anlık görüntü getirmez:
workspace.catalog_dirs’in listelediği dizinler, çalışma alanı kökündeki bircatalogklasörü ya daAGGREGA_CATALOG_DIRS’in adlandırdığı dizinler. Standart kütüphane kataloğunun kendi dosyaları, onları klasör olarak isteyen bir çalışma alanı içinaggrega-hubdeposununaggrega-catalogklasörüdür, https://github.com/aggrega-ai/aggrega-hub.--upgrade, kayıt defterinin yayımladığı en yeni anlık görüntüyü getirir ve o andan itibaren ona karşı içe aktarır;--offlinealtında, bir anlık görüntü getirmesi gereken içe aktarma durur ve neyin çalıştırılacağını belirtir. -
İçe aktarmayı çalıştırın. Dosyayı ya da dizini belirtin:
Terminal window aggrega import compose.yaml --target composeBiçim, dosyanın adından ve içeriğinden tanınır; tanınmadığı yerde
--formatonu belirtir.--target,composeya dahelmgibi bir sağlayıcı yeteneğini belirtir ve taslakların ihtiyaç duyduğu her bileşen türünü ve özellik türünü, kataloğunuzun onun için sunduğu o yeteneğe ait Recipe’ye eşleyen bir Manifest taslağı hazırlar: var olan tek Recipe’ye ya da birden fazlası varsa türün adını taşıyana. Taslak Release o Manifest’i adlandırır ve taslakların içeriği hedefe göre belirlenir:composeüzerinde bir gizli değer, Docker Compose’un kabuğunuzdan doldurduğu bir değişken başvurusudur;helmüzerinde ise bir Kubernetes Secret’ın adıdır. İçe aktarma standart hatada okuduğu biçimi, her uyarıyı ve eşlediği her düğüm için bir satırı adlandırır; standart çıktıda ise yazdığı dosyaları listeler. -
Hiçbir kaynağın içermediğini yanıtlayın. Kataloğun gerektirdiği ve hiçbir kaynağın içeremeyeceği bir değer — bir sahip hesabının e-postası, kendi kodunuzdan derlenen bir uygulamanın imajı, bir Kubernetes Secret’ın adı — bir kez yanıtlanır. İçe aktarma yanıtları kaynağın yanındaki
import-answers.yamldosyasından ya da--answersseçeneğinin belirttiği dosyadan okur; bir terminalde hâlâ eksik olan her değeri birer birer sorar ve yanıtlarınızı o dosyaya yazar. Bir gizli değer, değeriyle değil, nereden geldiğiyle — bir değişkenle ya da bir Secret’ın adıyla — yanıtlanır. Hiçbir şeyin sorulamadığı yerlerde — sürekli entegrasyonda, bir boru üzerinden, asistandan ya da düzenleyiciden — içe aktarma, her eksik değerin anahtarını ve boş bir yanıtı içeren yanıt dosyasını yazar, bunları listeler ve 1 durum koduyla çıkar; bunları doldurun ve içe aktarmayı yeniden çalıştırın. Tek bir yanıt dosyası her hedefe hizmet eder: bir hedefin taslaklarının ihtiyaç duymadığı bir yanıt dosyada tutulur ve kullanılmadan kalır. İçe aktarma yanıt dosyası dosyayı ayrıntılı olarak açıklar. -
İçe aktarma, derlemenin ihtiyaç duyduğunu çeker. Eksik bir şey kalmadığında içe aktarma, taslak Release’in bağımlılıklarını
aggrega pullgibi çeker ve yanınarelease.lockyazar.--offlinealtında hiçbir şey çekmez ve çalıştırılacakaggrega pullkomutunu belirtir. -
Doğrulayın ve derleyin. Taslakları içeren klasörde:
Terminal window aggrega validate --release release.yamlaggrega build --release release.yamlİkisi de geçtiğinde derleme, hedefin dosyalarını
dist/altına yazmış olur. Bir ret, değiştirdiğiniz belgede neyin nerede değiştirileceğini belirtir. -
Derlemenin yazdığını çalıştırın. Docker Compose için bir derleme
dist/compose/docker-compose.yamldosyasını yazar ve dosya hiçbir Compose projesini adlandırmaz; bu yüzden-pile bir proje adı verin:Terminal window docker compose -p <name> -f dist/compose/docker-compose.yaml up -d-polmadan Docker Compose projeyi, dosyayı içeren klasörün adıyla,composeolarak adlandırır, bu nedenle bu şekilde başlatılan iki çalışma alanı tek bir projeyi paylaşır. Servisler, Docker Compose’un projeye göre adlandırdığı tek bir ağda,<name>_composeağında bulunur. Derlemenin port yayımlamadığı bir servise bu ağın içindendocker compose -p <name> -f dist/compose/docker-compose.yaml exec <service> …ile ya da bu ağda başlattığınız bir konteynerdendocker run --network <name>_compose …ile erişilir. Bir adım adım kılavuzun “Çalıştırın” ve “Test edin” bölümleri, kendi derlemesi için komutları gösterir.Bir çalıştırma,
core/ai-model/openaimodeli aynı projede Ollama tarafından sunulan küçük bir modele yönlendirildiğinde bir OpenAI anahtarı olmadan yanıt verir; bunun için taslak dosyalarda üç değişiklik, eklenen bileşenin ihtiyaç duyduğunu çeken--auto-pullile bir derleme ve stack çalıştıktan sonra bir komut gerekir:- Aggregate’te, hiçbir şeye bağlanmamış bir bileşen daha:
core/ai-model/ollamatüründe,valuesiçindemodel: qwen2.5:0.5bbulunanlocal-model; - Manifest’te, onun Compose Recipe’si:
core/ai-model/ollama: compose/ollama; - Release’te,
local-model: {}ve OpenAI modelinininfraaltındakiendpointdeğeri, o sunucunun OpenAI uyumlu adresi olanhttp://local-model:11434/v1olarak ayarlanmış; - yığın çalıştıktan sonra, çekilen modelin, derlemenin OpenAI modelinin belirttiği model adıyla,
<model>ile — örneğingpt-4o-miniveyagpt-4.1— kopyalanması:docker compose -p <name> -f dist/compose/docker-compose.yaml exec local-model ollama cp qwen2.5:0.5b <model>.
Bundan sonra
OPENAI_API_KEYsizin seçeceğiniz boş olmayan herhangi bir değeri taşıyabilir: yerel sunucu hiçbirini denetlemez. Bir n8n iş akışı modelin adresini ve anahtarını,endpoint’in ilettiği adresten değil, model düğümünün seçtiği kimlik bilgisinden okur; bu yüzden o kimlik bilgisine de sunucunun adresini,dataiçindeapiKey’in yanında birurlolarak verin.core/ai-model/ollama’nın varsayılan olarak çalıştırdığı Ollama sunucusu, Chat Completions’ın yanı sıra OpenAI’ın Responses API’sini de sunar; bu yüzdenapiType: Responsesbelirten bir Agent Framework bildirime dayalı ajanı ona yazıldığı haliyle ulaşır.Kubernetes için bir derleme, yani
helmhedefi, helm sağlayıcısının açıkladığı gibi bir chart yerine düz manifestler yazar:dist/helm/altına ya da bir Release’in bir sınıra yerleştirdiği bileşenler içindist/boundaries/<boundary>/helm/altına; bunların bazıları altında kendilerine ait bir klasörde bulunur. MCP ve Dify derlemelerinin dosyaları gibi namespace belirtmeyen dosyalar,kubectlbağlamınızın belirttiği namespace’e, hiçbirini belirtmiyorsadefault’a gider; önce okudukları Secret’ları orada oluşturun, ardından klasörü uygulayın:Terminal window kubectl apply -R -f dist/helm/-R, bu klasörlerdeki dosyalara da ulaşır. MCP ve Dify derlemelerinin çalıştırdıkları sunuculara verdiği tür olanClusterIPService’e yalnızca küme içinden erişilebilir: kendi makinenizden birine erişmek içinkubectl port-forward svc/<service> <local port>:<port>ile ona yerel bir bağlantı noktası yönlendirin; bu komut siz durdurana kadar çalışır. - Aggregate’te, hiçbir şeye bağlanmamış bir bileşen daha:
İçe aktarma, taslaklarının yanına, yazdıklarının kaydı olan .aggrega-import.json dosyasını yazar. aggrega import --sync komutunu çalıştırmayı düşündüğünüz sürece onu saklayın; bu komut sizin düzenlemelerinizi kendi yazdıklarından ayırt etmek için onu okur. Yanıt dosyasını da saklayın: hiçbir gizli değer içermez, bu yüzden kaynağın yanında sürüm denetiminde durabilir ve o kaynağın sonraki her içe aktarması onu okur.
Bir yapay zekâ asistanıyla
Aggrega’nın araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullan ve kendin hiçbir klasör oluşturma. `import` aracını `source` değeri `compose.yaml` ve `target` değeri `compose` olacak şekilde çağır: taslaklarını Workspace klasörüne yazar. Hâlâ eksik değerler olduğunu söylerse, her birini ve ne olduğunu bana söyle ve belirttiği yanıt dosyasında yanıtlarımı anahtarlarının yanına yazarken bekle; ardından `import` aracını aynı şekilde yeniden çağır. Sonra `validate` aracını `release` değeri `release.yaml` olacak şekilde, `build` aracını da `release` değeri `release.yaml` ve `write` değeri true olacak şekilde çağır. Derlemenin hangi dosyaları yazdığını bana söyle; bunlar Workspace klasöründe `dist/` altındadır.VS Code’da açın
Visual Studio Code için Aggrega uzantısı yüklüyken, içe aktarmanın çalıştığı çalışma alanını — .aggrega-config.yaml dosyasını içeren klasörü — VS Code’da açın: taslaklar onun içinde, kökünde ya da --output-dir’in belirttiği klasördedir. Çalışma alanı tek bir Release içeriyorsa düzenleyici onu sizin için seçer; birden fazla içeriyorsa düzenleyicinin üzerinde çalışacağını Aggrega: Select Release… seçer. Düzenleyici, siz düzenlerken taslakları seçili Release’e göre denetler ve bulduklarını dosyada ve Sorunlar panelinde işaretler. Komut Paleti’ndeki Aggrega: Show topology graph, seçili Release’in bileşenlerini ve aralarındaki bağlantıları çizer. Aggrega: Build, Aggrega: Preview build ve Aggrega: Pull aynı Release üzerinde çalışır ve her biri etkinlik çubuğundaki Aggrega görünümünün Commands panelinde bir düğme olarak da bulunur; Build dosyalarını çalışma alanının dist/ klasörüne yazar. Geri kalanını Aggrega’yı Visual Studio Code’da kullanma ele alır.
İçe aktarıcılar nereden gelir
Her biçim bir içe aktarıcı eklentisi tarafından okunur. Derleyicinin, aşağıdaki tablodaki her biçim için bir tane olan çekirdek içe aktarıcıları, her derleyici sürümüyle birlikte yayımlanır ve kataloğunuzda hiçbir girdi olmadan her çalışma alanında kendi biçimlerine hizmet eder. Bunlardan birine ihtiyaç duyan ilk içe aktarma onu çalışma alanının varsayılan kayıt defterinden, derleyicinin kendi sürümünde getirir, doğrular ve çalışma alanının içerik önbelleğinde saklar; böylece sonraki her içe aktarma onu oradan okur ve bunun için ağa erişmez. Modül hiç getirilemediğinde — örneğin çalışma alanı çevrimdışıysa — içe aktarma durur ve onu makineye koymanın iki yolunu belirtir. Çekirdek içe aktarıcılar her içe aktarıcıyı ve bir içe aktarıcıya bir plugins.importer girdisi aracılığıyla verilen ayarları ayrıntılı olarak açıklar.
Biçimler
| Biçim | Ne okur | Adım adım kılavuz |
|---|---|---|
| Compose | bir Compose dosyası ve onun geçersiz kılma dosyası ya da bunları içeren bir dizin | Bir Compose projesini içe aktarma |
| MCP istemci yapılandırmaları | .mcp.json, claude_desktop_config.json, .vscode/mcp.json, .cursor/mcp.json ya da bir MCP kayıt defterinin server.json dosyası | Bir MCP istemci yapılandırmasını içe aktarma |
| Langflow | Langflow’dan JSON olarak dışa aktarılmış bir akış | Bir Langflow akışını içe aktarma |
| Flowise | Flowise’tan JSON olarak dışa aktarılmış bir chatflow ya da agentflow | Bir Flowise chatflow’unu içe aktarma |
| n8n | n8n’den JSON olarak dışa aktarılmış bir iş akışı | Bir n8n iş akışını içe aktarma |
| Dify | Dify’dan kendi DSL’inde YAML olarak dışa aktarılmış bir uygulama | Bir Dify uygulamasını içe aktarma |
| CrewAI | bir CrewAI projesinin ajan ve görev bildirimleri | Bir CrewAI projesini içe aktarma |
| LangGraph | bir LangGraph uygulamasının langgraph.json dosyası | Bir LangGraph uygulamasını içe aktarma |
| Google ADK | Google ADK üzerine kurulmuş bir uygulamanın root_agent.yaml dosyasından başlayan Agent Config dosyaları | Bir Google ADK ajanını içe aktarma |
| Microsoft Agent Framework | bildirimsel bir ajan, Prompt türünde bir YAML belgesi | Bir Microsoft Agent Framework bildirimsel ajanını içe aktarma |
aggrega import, komutun tam başvuru kaynağıdır: her bayrak, bir kaynağın nasıl tanındığı, --sync’in neyi değiştirdiği ve neyi reddettiği. İçe aktarma yanıtları dosyası, yanıtlar dosyasını açıklar: nerede bulunduğunu, neyi içerdiğini ve bir gizli bilginin nasıl yanıtlandığını.