Impor
aggrega import membaca proyek yang ditulis dalam format lain — alur yang diekspor dari Langflow, konfigurasi klien MCP, file Compose, dan format lain yang tercantum di bawah — lalu menulis file Aggrega darinya: sebuah Aggregate, sebuah Release, dan, untuk target yang disebutkan --target, sebuah Manifest. Bersama-sama, file tersebut membentuk ruang kerja yang lolos validasi dan dapat dibangun sebagaimana tertulis, setelah beberapa nilai yang tidak dapat dimuat oleh sumber mana pun dijawab: impor menanyakan masing-masing nilai itu satu kali dan menyimpan jawabannya dalam file jawaban. Perintah ini tidak men-deploy apa pun dan tidak menjangkau kluster atau akun cloud apa pun. Draf tersebut adalah file biasa di ruang kerja Anda, dan apa yang terjadi padanya selanjutnya terserah Anda.
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
aggrega importdraf file Aggrega
untuk Anda tinjau dan sunting
Proyek Anda yang sudah ada masuk, draf file Aggrega keluar. Tidak ada yang di-deploy; Anda meninjau draf terlebih dahulu.
Apa yang Anda peroleh
- Proyek Anda sampai ke Aggrega tanpa ditulis ulang secara manual. Aggregate, Release, dan Manifest yang didrafkan adalah jenis file yang sama dengan yang akan Anda tulis sendiri. File tersebut dapat dibangun sebagaimana tertulis untuk target yang disebutkan impor, dan setiap kebijakan tata kelola yang dilampirkan ruang kerja Anda menilai build tersebut seperti build lainnya.
- Apa yang dinyatakan sumber akan dibawa. Node atau layanan yang memiliki kecocokan kuat di katalog mereferensikan Component katalog tersebut, dengan nilai yang diberikan sumber kepadanya, seperti model yang disebutkan sebuah alur. Platform tempat sumber berjalan didrafkan dengan image yang dijalankan oleh Recipes katalog untuk platform tersebut. Rahasia didrafkan sebagai referensi ke asalnya, tidak pernah sebagai nilainya.
- Anda hanya ditanya tentang apa yang tidak dapat dimuat oleh sumber mana pun, satu kali. Jawaban disimpan dalam file jawaban di samping sumber, sehingga impor berikutnya dari sumber yang sama tidak menanyakan apa pun.
- Draf itu milik Anda. Draf berupa YAML biasa di ruang kerja Anda, tanpa meninggalkan apa pun yang menjadi tumpuan build. Sunting, ganti nama, dan commit draf tersebut.
- Draf dapat mengikuti sumbernya.
aggrega import --syncmemperbarui draf dari impor sebelumnya sesuai sumber yang berubah, dengan hanya mengubah apa yang ditulis oleh impor. Jika sumber mengubah bagian yang telah Anda sunting, perintah ini berhenti dan menyebutkan bagian tersebut alih-alih menimpa suntingan Anda.
Yang tidak dilakukannya
Impor menyusun draf dari apa yang dinyatakan sumber dan apa yang ditentukan katalog Anda, lalu menanyakan sisanya. Setiap draf menyebutkan, dalam komentar di samping nilai, dari mana nilai yang didrafkannya berasal.
- Impor tidak menebak apa yang tidak dapat dinyatakan sumber Anda. Tidak ada sumber yang menyebutkan lingkungan tempat sebuah Release di-deploy, sehingga Release yang didrafkan menyebutkan
development, dengan komentar yang menyatakan bahwa itu adalah default yang perlu diubah. Nilai yang diwajibkan katalog dan tidak dimuat oleh sumber mana pun — email akun pemilik, image aplikasi yang dibangun dari kode Anda sendiri, nama Secret Kubernetes — didrafkan kosong dan ditanyakan, seperti yang dijelaskan Cara impor berjalan di bawah. - Impor tidak membaca kode. Program milik sebuah alur atau proyek tidak dibaca: program sebuah crew CrewAI, kode graf sebuah aplikasi LangGraph, kode sumber sebuah komponen Langflow selain membawanya di dalam alur.
- Impor tidak menilai arti sebuah nilai. Setiap node atau layanan dibandingkan dengan Components di katalog ruang kerja Anda — nama, kategori, label, dan nama nilai yang dideklarasikannya. Kecocokan di tingkat tinggi direferensikan di draf; kecocokan yang lebih lemah ditulis sebagai komentar yang menyebutkan Component dan skornya, untuk Anda pilih.
- Impor tidak mengubah versi yang dijalankan platform untuk mengikuti sumber. Image platform didrafkan pada versi yang diketahui dijalankan oleh Recipes katalog untuk platform tersebut, dan jika sumber menyebutkan versi lain, komentar di samping image menyebutkannya.
- Impor tidak memindahkan kredensial keluar dari sumber Anda untuk Anda. Nilai yang dapat memuat kunci — nilai lingkungan, header, baris perintah server MCP — secara default dibawa ke draf sebagaimana tertulis, dan impor menyebutkan masing-masing dalam peringatan
credential-carried, tidak pernah berdasarkan nilainya. Pengaturanempty_credentialsmilik pengimpor justru menuliskannya kosong (Pengaturan). Baca peringatan tersebut sebelum Anda membagikan draf. - Impor tidak men-deploy atau menjalankan apa pun. Impor membaca sumber dan katalog Anda, lalu menulis file. Membangun draf, dan menjalankan apa yang ditulis build, adalah langkah terpisah yang Anda lakukan.
Cara impor berjalan
Anda dapat menjalankan impor dengan perintah di bawah ini, atau meminta asisten AI Anda menjalankannya untuk Anda.
-
Mulai dari ruang kerja. Impor menulis drafnya di bawah root ruang kerja tempat impor dijalankan — folder yang berisi
.aggrega-config.yamldengan kunciworkspace— atau di bawah direktori yang disebutkan--output-dir. Impor tidak pernah menimpa Aggregate yang sudah ada di sana. -
Katalog pembanding. Impor menilai sumber Anda terhadap Components dalam katalog ruang kerja, dan tidak terhadap apa pun lainnya. Jika ruang kerja tidak menyebutkan folder katalognya sendiri, katalog tersebut adalah katalog pustaka standar, yang dibaca dari registri default ruang kerja: setiap penerbitan katalog menerbitkan snapshot bertanda tangan dari seluruh katalog, dan impor pertama mengambil snapshot itu, memverifikasi tanda tangannya, menyimpannya di cache konten ruang kerja, dan menyebutkannya dengan digest-nya dalam catatan yang ditulisnya di samping draf, sehingga impor berikutnya atas draf yang sama membaca katalog yang sama tanpa menanyai registri lagi. Terhadap katalog itu, layanan PostgreSQL dicocokkan dengan
core/datastore/postgres, dan--targetmenyusun draf Manifest dari Recipes katalog tersebut. Tanpa katalog, impor tidak punya apa pun untuk dicocokkan, dan--targetditolak, karena tidak ada Recipe yang terikat ke target.Ruang kerja yang menyebutkan folder katalognya sendiri mengimpor terhadap folder-folder itu sebagai gantinya, dan tidak mengambil snapshot apa pun: direktori yang dicantumkan
workspace.catalog_dirs, foldercatalogdi root ruang kerja, atau direktori yang disebutkanAGGREGA_CATALOG_DIRS. Berkas katalog pustaka standar itu sendiri adalah folderaggrega-catalogdari repositoriaggrega-hub, https://github.com/aggrega-ai/aggrega-hub, bagi ruang kerja yang menginginkannya sebagai folder.--upgrademengambil snapshot terbaru yang diterbitkan registri dan sejak itu mengimpor terhadapnya; di bawah--offline, impor yang harus mengambil snapshot berhenti dan menyebutkan apa yang perlu dijalankan. -
Jalankan impor. Sebutkan file atau direktorinya:
Terminal window aggrega import compose.yaml --target composeFormat dikenali dari nama dan isi file;
--formatmenyebutkannya jika tidak dikenali.--targetmenyebutkan kapabilitas penyedia, seperticomposeatauhelm, dan menyusun draf Manifest yang memetakan setiap jenis komponen dan jenis fitur yang dibutuhkan draf ke Recipe dengan kapabilitas tersebut yang ditawarkan katalog Anda untuknya: satu-satunya yang ada, atau, di antara beberapa, yang dinamai sesuai jenisnya. Release hasil draf menyebutkan Manifest itu, dan isi draf mengikuti target: padacompose, sebuah rahasia adalah referensi variabel yang diisi Docker Compose dari shell Anda; padahelm, nama sebuah Kubernetes Secret. Pada galat standar, impor menyebutkan format yang dibacanya, setiap peringatan, dan satu baris untuk setiap node yang dipetakannya; pada keluaran standar, impor mencantumkan file yang ditulisnya. -
Jawab apa yang tidak dimuat sumber mana pun. Nilai yang diwajibkan katalog dan tidak dapat dimuat oleh sumber mana pun — email akun pemilik, image aplikasi yang dibangun dari kode Anda sendiri, nama sebuah Kubernetes Secret — dijawab sekali. Impor membaca jawaban dari
import-answers.yamldi samping sumber, atau dari file yang disebutkan--answers; di terminal, impor menanyakan setiap nilai yang masih kurang, satu pertanyaan sekali waktu, dan menulis jawaban Anda ke file itu. Rahasia dijawab dengan asalnya — variabel atau nama sebuah Secret — tidak pernah dengan nilainya. Jika tidak ada yang dapat ditanyakan — dalam integrasi berkelanjutan, melalui pipe, dari asisten atau editor — impor menulis file jawaban berisi kunci setiap nilai yang kurang dan jawaban kosong, mencantumkannya, lalu keluar dengan status 1; isi semuanya lalu jalankan impor lagi. Satu file jawaban melayani setiap target: jawaban yang tidak dibutuhkan draf untuk suatu target tetap disimpan di file dan tidak digunakan. File jawaban impor menjelaskan file itu secara lengkap. -
Impor menarik apa yang dibutuhkan build. Setelah tidak ada lagi yang kurang, impor menarik dependensi Release hasil draf, seperti yang dilakukan
aggrega pull, dan menulisrelease.lockdi sampingnya. Dengan--offline, impor tidak menarik apa pun dan menyebutkan perintahaggrega pullyang perlu dijalankan. -
Validasi dan bangun. Di folder yang berisi draf:
Terminal window aggrega validate --release release.yamlaggrega build --release release.yamlJika keduanya lolos, build telah menulis file target di bawah
dist/. Penolakan menyebutkan apa yang harus diubah dan di mana, dalam dokumen yang Anda ubah. -
Jalankan apa yang ditulis oleh build. Build untuk Docker Compose menulis
dist/compose/docker-compose.yaml, dan file tersebut tidak menamai proyek Compose apa pun, jadi beri nama dengan-p:Terminal window docker compose -p <name> -f dist/compose/docker-compose.yaml up -dTanpa
-p, Docker Compose menamai proyek berdasarkan folder yang memuat file tersebut,compose, sehingga dua ruang kerja yang dijalankan dengan cara itu berbagi satu proyek. Layanan-layanan berada di satu jaringan, yang dinamai Docker Compose berdasarkan proyek,<name>_compose. Layanan yang port-nya tidak dipublikasikan oleh build dijangkau dari dalam jaringan itu, dengandocker compose -p <name> -f dist/compose/docker-compose.yaml exec <service> …, atau dari kontainer yang Anda jalankan di jaringan itu dengandocker run --network <name>_compose …. Bagian “Jalankan” dan “Uji” pada sebuah panduan langkah demi langkah menunjukkan perintah untuk build-nya sendiri.Sebuah eksekusi menjawab tanpa kunci OpenAI setelah model
core/ai-model/openaimiliknya diarahkan ke model kecil yang disajikan oleh Ollama di proyek yang sama, dengan tiga perubahan pada file hasil draf, build dengan--auto-pull, yang menarik apa yang dibutuhkan komponen tambahan, dan satu perintah setelah stack berjalan:- di Aggregate, satu komponen lagi, yang tidak terhubung ke apa pun:
local-model, bertipecore/ai-model/ollama, denganmodel: qwen2.5:0.5bdivaluesmiliknya; - di Manifest, Recipe Compose miliknya:
core/ai-model/ollama: compose/ollama; - di Release,
local-model: {}, sertaendpointmilik model OpenAI, di bawahinframiliknya, diatur ke alamat server tersebut yang kompatibel dengan OpenAI,http://local-model:11434/v1; - setelah stack berjalan, model yang ditarik disalin dengan nama model yang disebutkan oleh model OpenAI milik build,
<model>, sepertigpt-4o-miniataugpt-4.1:docker compose -p <name> -f dist/compose/docker-compose.yaml exec local-model ollama cp qwen2.5:0.5b <model>.
OPENAI_API_KEYkemudian dapat berisi nilai tidak kosong apa pun milik Anda sendiri: server lokal tidak memeriksa satu pun. Workflow n8n membaca alamat dan kunci model dari kredensial yang dipilih node modelnya, bukan dari alamat yang diberikanendpoint, sehingga berikan juga alamat server kepada kredensial tersebut, sebagaiurldi sampingapiKeydalamdata-nya. Server Ollama yang dijalankancore/ai-model/ollamasecara default melayani Responses API milik OpenAI selain Chat Completions, sehingga agen deklaratif Agent Framework yang menyebutkanapiType: Responsesmenjangkaunya sebagaimana tertulis.Build untuk Kubernetes, yaitu target
helm, menulis manifes biasa alih-alih chart, seperti yang dijelaskan penyedia helm: di bawahdist/helm/, atau, untuk komponen yang ditempatkan Release dalam sebuah boundary, di bawahdist/boundaries/<boundary>/helm/, sebagian di antaranya dalam folder tersendiri di bawahnya. File yang tidak menyebutkan namespace, seperti file dari build MCP dan Dify, masuk ke namespace yang disebutkan kontekskubectlAnda, atau kedefaultjika konteks itu tidak menyebutkan satu pun; buat terlebih dahulu Secrets yang dibacanya di sana, lalu terapkan folder tersebut:Terminal window kubectl apply -R -f dist/helm/-Rmenjangkau file di folder-folder tersebut. ServiceClusterIP, jenis yang diberikan build MCP dan Dify kepada server yang dijalankannya, hanya dapat dijangkau dari dalam kluster: untuk menjangkaunya dari mesin Anda, teruskan port lokal ke sana dengankubectl port-forward svc/<service> <local port>:<port>, yang terus berjalan sampai Anda menghentikannya. - di Aggregate, satu komponen lagi, yang tidak terhubung ke apa pun:
Di samping drafnya, impor menulis .aggrega-import.json, catatan tentang apa yang ditulisnya. Simpan file itu selama Anda berniat menjalankan aggrega import --sync, yang membacanya untuk membedakan suntingan Anda dari tulisannya sendiri. Simpan juga file jawaban: file itu tidak memuat rahasia apa pun, sehingga dapat disimpan dalam kontrol versi di samping sumber, dan setiap impor berikutnya atas sumber itu membacanya.
Dengan asisten AI
Asisten AI yang disiapkan dengan alat-alat Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke dalamnya.
Gunakan hanya alat Aggrega, dan jangan membuat folder apa pun sendiri. Panggil alat `import` dengan `source` disetel ke `compose.yaml` dan `target` disetel ke `compose`: alat ini menulis drafnya ke folder Workspace. Jika alat itu menyatakan masih ada nilai yang kurang, sebutkan kepada saya setiap nilai dan apa artinya, lalu tunggu selagi saya menulis jawaban saya di samping kuncinya dalam file jawaban yang disebutkannya; kemudian panggil lagi alat `import` dengan cara yang sama. Setelah itu panggil alat `validate` dengan `release` disetel ke `release.yaml`, dan alat `build` dengan `release` disetel ke `release.yaml` serta `write` disetel ke true. Beri tahu saya file mana yang ditulis build; file-file itu berada di bawah `dist/` dalam folder Workspace.Membukanya di VS Code
Dengan ekstensi Aggrega untuk Visual Studio Code terpasang, buka di VS Code ruang kerja tempat impor dijalankan — folder yang memuat .aggrega-config.yaml-nya: draf ada di dalamnya, di root-nya atau di folder yang disebutkan --output-dir. Jika ruang kerja memuat satu Release, editor memilihnya untuk Anda; jika memuat lebih dari satu, Aggrega: Select Release… memilih yang dikerjakan editor. Editor memeriksa draf terhadap Release yang dipilih saat Anda menyuntingnya, menandai apa yang ditemukannya di file dan di panel Problems. Aggrega: Show topology graph, di Command Palette, menggambar komponen Release yang dipilih dan koneksi di antaranya. Aggrega: Build, Aggrega: Preview build, dan Aggrega: Pull bekerja pada Release yang sama, dan masing-masing juga merupakan tombol pada panel Commands di tampilan Aggrega pada bilah aktivitas; Build menulis file-filenya ke dist/ ruang kerja. Menggunakan Aggrega di Visual Studio Code membahas sisanya.
Asal pengimpor
Setiap format dibaca oleh sebuah plugin pengimpor. Pengimpor inti milik kompiler, satu untuk setiap format dalam tabel di bawah, diterbitkan bersama setiap rilis kompiler dan melayani formatnya di setiap ruang kerja, tanpa entri di katalog Anda. Impor pertama yang membutuhkan salah satunya mengambilnya dari registri default ruang kerja, pada versi kompiler itu sendiri, memverifikasinya, dan menyimpannya di cache konten ruang kerja, sehingga setiap impor berikutnya membacanya dari sana, tanpa memerlukan jaringan untuknya. Jika modul sama sekali tidak dapat diambil — misalnya ruang kerja sedang offline — impor berhenti dan menyebutkan dua cara untuk menempatkannya di mesin. Pengimpor inti menjelaskan setiap pengimpor secara lengkap, beserta pengaturan yang diberikan kepada pengimpor melalui entri plugins.importer.
Format
| Format | Apa yang dibacanya | Panduan langkah demi langkah |
|---|---|---|
| Compose | file Compose beserta file override-nya, atau direktori yang berisi keduanya | Mengimpor proyek Compose |
| Konfigurasi klien MCP | .mcp.json, claude_desktop_config.json, .vscode/mcp.json, .cursor/mcp.json, atau server.json registri MCP | Mengimpor konfigurasi klien MCP |
| Langflow | flow yang diekspor dari Langflow, sebagai JSON | Mengimpor alur Langflow |
| Flowise | chatflow atau agentflow yang diekspor dari Flowise, sebagai JSON | Mengimpor chatflow Flowise |
| n8n | workflow yang diekspor dari n8n, sebagai JSON | Mengimpor workflow n8n |
| Dify | aplikasi yang diekspor dari Dify dalam DSL-nya, sebagai YAML | Mengimpor aplikasi Dify |
| CrewAI | deklarasi agen dan tugas dari proyek CrewAI | Mengimpor proyek CrewAI |
| LangGraph | langgraph.json dari aplikasi LangGraph | Mengimpor aplikasi LangGraph |
| Google ADK | file Agent Config dari aplikasi yang dibangun di atas Google ADK, mulai dari root_agent.yaml | Mengimpor agen Google ADK |
| Microsoft Agent Framework | agen deklaratif, dokumen YAML berjenis Prompt | Mengimpor agen deklaratif Microsoft Agent Framework |
aggrega import adalah referensi lengkap perintah ini: setiap flag, cara sumber dikenali, apa yang diubah --sync, dan apa yang ditolaknya. File jawaban impor menjelaskan file jawaban: di mana letaknya, apa isinya, dan bagaimana sebuah rahasia dijawab.