Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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 import

draf 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 --sync memperbarui 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. Pengaturan empty_credentials milik 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.

  1. Mulai dari ruang kerja. Impor menulis drafnya di bawah root ruang kerja tempat impor dijalankan — folder yang berisi .aggrega-config.yaml dengan kunci workspace — atau di bawah direktori yang disebutkan --output-dir. Impor tidak pernah menimpa Aggregate yang sudah ada di sana.

  2. 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 --target menyusun draf Manifest dari Recipes katalog tersebut. Tanpa katalog, impor tidak punya apa pun untuk dicocokkan, dan --target ditolak, 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, folder catalog di root ruang kerja, atau direktori yang disebutkan AGGREGA_CATALOG_DIRS. Berkas katalog pustaka standar itu sendiri adalah folder aggrega-catalog dari repositori aggrega-hub, https://github.com/aggrega-ai/aggrega-hub, bagi ruang kerja yang menginginkannya sebagai folder. --upgrade mengambil 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.

  3. Jalankan impor. Sebutkan file atau direktorinya:

    Terminal window
    aggrega import compose.yaml --target compose

    Format dikenali dari nama dan isi file; --format menyebutkannya jika tidak dikenali. --target menyebutkan kapabilitas penyedia, seperti compose atau helm, 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: pada compose, sebuah rahasia adalah referensi variabel yang diisi Docker Compose dari shell Anda; pada helm, 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.

  4. 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.yaml di 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.

  5. Impor menarik apa yang dibutuhkan build. Setelah tidak ada lagi yang kurang, impor menarik dependensi Release hasil draf, seperti yang dilakukan aggrega pull, dan menulis release.lock di sampingnya. Dengan --offline, impor tidak menarik apa pun dan menyebutkan perintah aggrega pull yang perlu dijalankan.

  6. Validasi dan bangun. Di folder yang berisi draf:

    Terminal window
    aggrega validate --release release.yaml
    aggrega build --release release.yaml

    Jika keduanya lolos, build telah menulis file target di bawah dist/. Penolakan menyebutkan apa yang harus diubah dan di mana, dalam dokumen yang Anda ubah.

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

    Tanpa -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, dengan docker compose -p <name> -f dist/compose/docker-compose.yaml exec <service> …, atau dari kontainer yang Anda jalankan di jaringan itu dengan docker 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/openai miliknya 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, bertipe core/ai-model/ollama, dengan model: qwen2.5:0.5b di values miliknya;
    • di Manifest, Recipe Compose miliknya: core/ai-model/ollama: compose/ollama;
    • di Release, local-model: {}, serta endpoint milik model OpenAI, di bawah infra miliknya, 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>, seperti gpt-4o-mini atau gpt-4.1: docker compose -p <name> -f dist/compose/docker-compose.yaml exec local-model ollama cp qwen2.5:0.5b <model>.

    OPENAI_API_KEY kemudian 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 diberikan endpoint, sehingga berikan juga alamat server kepada kredensial tersebut, sebagai url di samping apiKey dalam data-nya. Server Ollama yang dijalankan core/ai-model/ollama secara default melayani Responses API milik OpenAI selain Chat Completions, sehingga agen deklaratif Agent Framework yang menyebutkan apiType: Responses menjangkaunya sebagaimana tertulis.

    Build untuk Kubernetes, yaitu target helm, menulis manifes biasa alih-alih chart, seperti yang dijelaskan penyedia helm: di bawah dist/helm/, atau, untuk komponen yang ditempatkan Release dalam sebuah boundary, di bawah dist/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 konteks kubectl Anda, atau ke default jika 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/

    -R menjangkau file di folder-folder tersebut. Service ClusterIP, 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 dengan kubectl port-forward svc/<service> <local port>:<port>, yang terus berjalan sampai Anda menghentikannya.

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

FormatApa yang dibacanyaPanduan langkah demi langkah
Composefile Compose beserta file override-nya, atau direktori yang berisi keduanyaMengimpor proyek Compose
Konfigurasi klien MCP.mcp.json, claude_desktop_config.json, .vscode/mcp.json, .cursor/mcp.json, atau server.json registri MCPMengimpor konfigurasi klien MCP
Langflowflow yang diekspor dari Langflow, sebagai JSONMengimpor alur Langflow
Flowisechatflow atau agentflow yang diekspor dari Flowise, sebagai JSONMengimpor chatflow Flowise
n8nworkflow yang diekspor dari n8n, sebagai JSONMengimpor workflow n8n
Difyaplikasi yang diekspor dari Dify dalam DSL-nya, sebagai YAMLMengimpor aplikasi Dify
CrewAIdeklarasi agen dan tugas dari proyek CrewAIMengimpor proyek CrewAI
LangGraphlanggraph.json dari aplikasi LangGraphMengimpor aplikasi LangGraph
Google ADKfile Agent Config dari aplikasi yang dibangun di atas Google ADK, mulai dari root_agent.yamlMengimpor agen Google ADK
Microsoft Agent Frameworkagen deklaratif, dokumen YAML berjenis PromptMengimpor 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.