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

Mengimpor alur kerja n8n — agen AI yang menjawab pesan chat

Alur kerja n8n — sebuah pemicu chat, sebuah AI Agent, sebuah OpenAI Chat Model, dan sebuah Simple Memory — diimpor oleh aggrega import menjadi sebuah Aggregate, sebuah Release, dan sebuah Manifest yang dapat di-build untuk Docker Compose sebagaimana tertulis.

Mengimpor alur kerja n8n membahasnya langkah demi langkah: perintahnya, berkas yang ditulisnya, build-nya, dan menjalankan apa yang di-build-nya. Folder ini memuat setiap tahap dari panduan tersebut:

folderisinya
source/alur kerja, support-agent.json; .aggrega-config.yaml yang menjadikan folder ini ruang kerja; dan import-answers.yaml, jawaban atas hal yang tidak dapat dimuat oleh alur kerja mana pun, yang diminta oleh impor untuk Kubernetes
draft/berkas yang ditulis oleh aggrega import support-agent.json --target compose, tanpa diubah, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar

source/support-agent.json ditulis untuk contoh ini, dalam bentuk yang digunakan n8n saat mengekspor alur kerja.

Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.

Membuat contoh

Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example import-n8n

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd import-n8n

Build

Impor membuat draf berkas Aggrega di samping proyek, di source/, dan menarik apa yang dibutuhkan build. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan registry default workspace sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten workspace, dan menyebutkannya berdasarkan digest-nya dalam catatan yang ditulisnya di samping draf. Workspace yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder-folder itu sebagai gantinya:

Terminal window
cd source
aggrega import support-agent.json --target compose
aggrega validate --release release.yaml
aggrega build --release release.yaml

Cara menjalankan apa yang ditulis build ada di panduan yang ditautkan di atas.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-n8n`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-n8n` dan tanpa `dir`: alat ini menulis contoh ke folder `import-n8n` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor oleh contoh ini. Kemudian panggil alat `import` dengan `workspace_root` diatur ke `import-n8n/source`, `source` diatur ke `support-agent.json`, dan `target` diatur ke `compose`: alat ini membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `support-agent.json`, menulis drafnya ke `import-n8n/source`, dan menarik apa yang dibutuhkan draf tersebut. Kemudian panggil alat `validate` dengan `workspace_root` diatur ke `import-n8n/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-n8n/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `import-n8n/source/dist/`.

Mengujinya

Dengan stack berjalan seperti yang dijalankan oleh panduan langkah demi langkah — kredensial tersimpan dan workflow aktif — buka http://127.0.0.1:5678 untuk editor n8n, lalu kirim pesan ke pemicu chat dengan pengguna dan kata sandi yang disimpannya, yang dibaca dari CHAT_USER dan CHAT_PASSWORD pada input standar curl:

Terminal window
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \
http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \
-d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'
HTTP/1.1 500 Internal Server Error
[… omitted: the response's other headers]
{"message":"Error in workflow"}

Proses tersebut menyimpan placeholder untuk kunci OpenAI, sehingga workflow berhenti pada panggilannya ke model, dan eksekusinya di editor menampilkan penolakan OpenAI: Incorrect API key provided: sk-place*****************-key.

Diimpor dengan --target helm dan diterapkan ke Kubernetes, n8n menerima pesan yang sama di alamat yang sama setelah kredensial disimpan dan workflow diaktifkan pada instans yang berjalan, seperti yang ditunjukkan panduan langkah demi langkah, dan sebuah port lokal diteruskan ke Service-nya; proses tersebut mendapatkan jawaban yang sama di sana:

Terminal window
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678