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

Mengimpor workflow n8n

Panduan langkah demi langkah ini mengimpor sebuah workflow yang diekspor dari n8n — agen AI yang menjawab pesan chat dengan model chat OpenAI dan sebuah memori — menjadi sebuah Aggregate, sebuah Release, dan sebuah Manifest yang, sebagaimana tertulis, membangun n8n yang membawa workflow tersebut untuk Docker Compose, lalu membangunnya dan menjalankan hasilnya. Setiap file dan setiap blok keluaran di bawah ini berasal dari eksekusi nyata; workflow dan setiap tahap panduan ini ada di contoh import-n8n, tempat sebuah skrip pemeriksaan menjalankan impor lagi, membandingkan apa yang ditulisnya, apa yang dicetaknya, dan blok-blok yang dikutip halaman ini dengan file yang disimpan di sana, serta memvalidasi dan membangun apa yang ditulis impor.

Membuat contoh

Anda dapat menjalankan impor ini dengan perintah di halaman ini, 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; perintah sesudahnya, di bawah, berpindah ke folder source milik folder baru itu, yang berisi apa yang diimpor halaman ini dan merupakan tempat impor dijalankan:

Terminal window
cd import-n8n

Folder source dari contoh yang di-scaffold, dibuka di Visual Studio Code, menampilkan ekspor workflow n8n dari sebuah agen dukungan, terbuka pada node pemicu chat dan AI Agent-nya.

Workflow

support-agent.json, yang ditulis untuk panduan ini dalam bentuk ekspor workflow n8n, memuat empat node: sebuah pemicu chat, sebuah AI Agent dengan pesan sistem yang singkat, sebuah node OpenAI Chat Model yang memilih gpt-4o-mini, dan sebuah node Simple Memory, yang digabungkan oleh koneksi-koneksi yang dicantumkan n8n berdasarkan nama node asal masing-masing koneksi. Pemicu chat bersifat publik, sehingga pesan chat yang dikirim ke URL-nya memulai workflow, dan pemicu itu meminta pengguna dan kata sandi kepada pengirim, yang diperiksanya terhadap kredensial autentikasi dasar yang disimpan n8n:

"parameters": {
"public": true,
"authentication": "basicAuth",
"options": {}
},
[… omitted: the node's identifier, name, type, version, position and webhook identifier]
"credentials": {
"httpBasicAuth": {
"id": "Vx3mQ8rLb2Nk7Tz5",
"name": "Chat basic auth"
}
}

Node model memilih kredensialnya dengan cara yang sama, melalui referensi — ekspor membawa pengidentifikasi dan nama setiap kredensial, tidak pernah pengguna, kata sandi, atau kuncinya:

"parameters": {
"model": {
"__rl": true,
"value": "gpt-4o-mini",
"mode": "list",
"cachedResultName": "gpt-4o-mini"
},
"options": {}
},
"id": "6f1d2c3a-7b4e-4a8f-9c21-0d3e5f6a7b03",
"name": "OpenAI Chat Model",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [120, 220],
"credentials": {
"openAiApi": {
"id": "Rb7nW2xQ9kT4mZ1c",
"name": "OpenAI account"
}
}

Di samping workflow, sebuah .aggrega-config.yaml menjadikan folder tersebut sebuah ruang kerja:

# The workspace key marks this directory as the workspace root, so an import run
# here writes its drafts beside support-agent.json.
workspace: {}
# The registry the importer is fetched from the first time an import needs it.
default_registry: hub.aggrega.ai

dan import-answers.yaml menyimpan jawaban atas apa yang tidak dapat disimpan workflow mana pun. Impor untuk Docker Compose tidak memerlukan satu pun: impor itu melampirkan kunci OpenAI melalui referensi variabel yang diisi Docker Compose dari shell Anda. Impor untuk Kubernetes melampirkannya melalui nama sebuah Secret Kubernetes, yang hanya dapat Anda sebutkan, sehingga file tersebut menyebutkan Secret itu (lihat Di Kubernetes):

# Values the import could not draft from the source, keyed by the drafted file and the key path inside
# it. Write each one beside its key; an import of the same source, and a sync, read them from here and
# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable
# name, ${NAME}, or the name of a Kubernetes Secret.
release.yaml:
# The origin of the secret value, written by the operator in the Release. Read exactly as
# values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes
# from, never the value.
spec.components.n8n.uses.model.openai-chat-model.features.credential.infra.origin: "openai-api-key"

File jawaban impor menjelaskan file ini secara lengkap.

Impor menimbang setiap node terhadap Components di katalog ruang kerja, dan --target menyusun draf Manifest dari Recipes katalog tersebut. Ruang kerja tidak menyebutkan folder katalog apa pun, jadi impor membaca katalog pustaka standar dari registry tempat impor mengambil importer-nya: snapshot bertanda tangan dari katalog yang diterbitkan, yang diambil, diverifikasi, dan disimpan di cache konten ruang kerja oleh impor pertama, serta disebutkan melalui digest-nya dalam catatan yang ditulis impor di samping draf-drafnya. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder-folder itu sebagai gantinya. Pindah ke source:

Terminal window
cd source

Menjalankan impor

Terminal window
aggrega import support-agent.json --target compose

Pada keluaran standar, impor mencantumkan apa yang ditulisnya:

wrote aggregate.yaml
wrote release.yaml
wrote manifest.yaml
wrote .aggrega-import.json

Pada galat standar, dengan <workspace> mewakili folder tempat Anda menjalankannya:

[… omitted: a warning that the importer runs unverified, printed where its module is read from beside its Plugin entity in a catalog folder rather than fetched]
read as the n8n format, with drafted paths relative to <workspace>
warn: the value of credentials.httpBasicAuth.id of node When chat message received is carried as written in the flow the draft carries: its format marks the field as a credential, and setting empty_credentials to marked or all writes it empty
warn: the value of credentials.openAiApi.id of node OpenAI Chat Model is carried as written in the flow the draft carries: its format marks the field as a credential, and setting empty_credentials to marked or all writes it empty
warn: node OpenAI Chat Model reaches openai-chat-model, wired to the model socket of core/ai-agent/n8n as openai-chat-model, other than through that connection: an n8n @n8n/n8n-nodes-langchain.lmChatOpenAi node reaches the part at the address the stored credential it selects, or its own parameters, give; the platform delivers this connection as OPENAI_BASE_URL and OPENAI_API_KEY, but an n8n workflow reads a variable of the platform's environment only through an expression reading $env, which the platform refuses while values.allow_env_access_in_nodes is false, the value the draft leaves it at; setting it true lets every workflow, and every user who can edit one, read every variable of the platform's environment, the delivered credentials included
made no choice for When chat message received (@n8n/n8n-nodes-langchain.chatTrigger)
made no choice for AI Agent (@n8n/n8n-nodes-langchain.agent)
mapped OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi) to core/ai-model/openai as a reference, HIGH at 0.9143
made no choice for Simple Memory (@n8n/n8n-nodes-langchain.memoryBufferWindow)
warning: node "n8n" (provider "compose"): artifact "n8n-flow.compose-fragment.yaml": skipped provenance label injection — the fragment declares no compose service. Compose carries build provenance as service labels, so a fragment contributing only top-level networks, volumes or configs carries none; the services this component emits elsewhere carry the full set.
Pull complete: <workspace>/release.lock (entities=8, source_artifacts=0, external_inputs=0)

Impor yang dijalankan dari editor: draf Aggregate, Release, dan Manifest muncul di samping ekspor workflow, keluaran Aggrega mencantumkan bagaimana setiap node dipetakan dan file yang ditulis, dan sebuah notifikasi menyatakan bahwa impor menyusun draf 3 file, dikenali sebagai n8n.

  • Baris mapped menyatakan bahwa node OpenAI Chat Model menjadi model OpenAI milik pustaka standar, core/ai-model/openai, yang dirujuk alih-alih disusun sebagai draf, karena node ini cocok pada tingkat tinggi, dengan 0.9143: sebuah komponen tersendiri, yang dihubungkan ke soket model milik platform.
  • Baris-baris made no choice menyatakan bahwa pemicu, agen, dan memori tetap berada di dalam workflow, yang dijalankan sendiri oleh n8n.
  • Dua baris warn pertama menyebutkan pengidentifikasi kredensial tersimpan yang dipilih pemicu dan node model, yang ditandai n8n sebagai kredensial. Itu adalah referensi, bukan rahasia, dan dibawa sebagaimana tertulis.
  • Baris warn ketiga adalah yang perlu dibaca dengan saksama: node model menjangkau OpenAI dengan kredensial tersimpan yang dipilihnya, bukan melalui koneksi yang dihubungkan oleh draf. Platform mengirimkan koneksi ke lingkungan n8n, dan n8n menolak pembacaan lingkungannya oleh workflow selama Aggregate membiarkan values.allow_env_access_in_nodes bernilai false, seperti yang dilakukan draf. Menetapkannya ke true memungkinkan setiap workflow, dan setiap orang yang dapat menyunting workflow, membaca setiap variabel platform, termasuk kunci yang dikirimkan. Jadi kunci yang digunakan workflow adalah kunci yang disimpan n8n, seperti yang ditunjukkan Menjalankannya.
  • Dua baris terakhir adalah pull. Tidak ada lagi yang perlu dijawab, sehingga impor menarik dependensi Release hasil draf, seperti yang dilakukan aggrega pull, dan menulis release.lock; build di bawah tidak memerlukan apa pun lagi. Baris warning juga dicetak oleh build, dan Validasi dan build menjelaskannya.

Berkas jawaban menyebut sebuah Secret yang tidak diminta oleh impor ini: impor tidak membiarkan apa pun kosong untuknya, sehingga tidak menerapkan jawaban apa pun dan membiarkan berkas apa adanya.

Apa yang ditulisnya

Aggregate, Release, dan Manifest diberi nama imported/support-agent, berdasarkan nama workflow itu sendiri, Support agent, yang disingkat menjadi support-agent — workflow tanpa nama dinamai berdasarkan filenya — di bawah namespace yang ditetapkan oleh pengaturan target_namespace milik pengimpor, yaitu imported kecuali Anda menetapkan yang lain (Pengaturan).

aggregate.yaml — satu instans dari platform n8n milik pustaka standar, core/ai-agent/n8n, yang membawa workflow sebagaimana diekspor, yang sebagian besar dihilangkan di sini, dan model yang dihubungkan ke soket model-nya:

apiVersion: aggrega.ai/v1beta1
kind: Aggregate
metadata:
name: imported/support-agent
version: 0.1.0
description: Draft Aggregate imported from a source in the n8n format.
spec:
components:
n8n:
type: core/ai-agent/n8n
values:
workflow_id: 'sQ4vT8nKp2LmX7bR'
flow_definition: |
{
"id": "sQ4vT8nKp2LmX7bR",
"name": "Support agent",
[… omitted: the rest of the workflow, as exported]
}
uses:
model:
openai-chat-model:
target: openai-chat-model
# For the compose target, the lines below declare credential on openai-chat-model: a secret the Release alone attaches arrives under the key value, so each is declared with a key of its own and no two arrive under one; the Release attaches its origin, naming this type or none.
features:
credential:
type: core/secret-value
values:
key: OPENAI_API_KEY
# swap to core/ai-model/azure-openai (score 0.4125) by setting type: core/ai-model/azure-openai
openai-chat-model:
type: core/ai-model/openai
values:
model: |-
gpt-4o-mini

workflow_id adalah pengenal yang diberikan ekspor kepada workflow. Modelnya adalah core/ai-model/openai, dengan model yang dipilih node, gpt-4o-mini; komentar di atasnya menyebut Component lain dari katalog yang menyerupai node tersebut, beserta skornya. Kunci OpenAI yang disajikan platform kepada model dideklarasikan pada koneksi bersama variabel tempat kunci itu tiba di lingkungan n8n, OPENAI_API_KEY; Release menyatakan dari mana kunci itu berasal.

release.yaml — Release, yang men-deploy Aggregate dengan Manifest:

apiVersion: aggrega.ai/v1beta1
kind: Release
metadata:
name: imported/support-agent
# environment is a drafted default, since no source names the environment this Release deploys to; change it to name the one it deploys to.
environment: development
version: 0.1.0
description: Draft Release imported from a source in the n8n format.
spec:
aggregate: imported/support-agent
manifest: imported/support-agent
components:
n8n:
infra:
# The image running core/ai-agent/n8n, at the version this importer drafts, which the catalog's Recipes for it are known to run; the import does not raise or lower it to follow the source.
image: "n8nio/n8n:1.110.1"
# Published on this machine's loopback address, 127.0.0.1: reachable from this machine only, by any process running on it. Delete this line to keep the service internal.
published_port: 5678
uses:
model:
openai-chat-model:
features:
credential:
type: core/secret-value
infra:
# Attached by reference, never as a value: the credential n8n presents to openai-chat-model on its model connection, read from the variable OPENAI_API_KEY, which a target substituting variable references, as Docker Compose does when the stack starts, reads from the environment, so no file carries the value.
origin: "${OPENAI_API_KEY}"
openai-chat-model: {}
  • environment bernilai development, nilai bawaan yang menurut komentar di atasnya harus diubah ke lingkungan tempat Release di-deploy.
  • Image adalah n8n 1.110.1, versi yang dijalankan Recipes katalog untuk n8n.
  • published_port adalah 5678, port tempat n8n melayani, sehingga editor menjawab di http://127.0.0.1:5678 pada mesin Anda. Seperti yang dikatakan komentarnya, proses apa pun di mesin ini dapat menjangkaunya di sana dan tidak ada yang lain yang dapat; hapus baris tersebut agar n8n hanya berada di jaringan stack. published_port selain 5678 memerlukan infra.external_base_url: http://127.0.0.1:<published_port> di sampingnya, atau n8n melaporkan alamat editor dan webhook-nya di localhost:5678.
  • Kunci adalah referensi variabel, ${OPENAI_API_KEY}, yang diisi Docker Compose dari shell Anda saat stack dimulai. Model OpenAI milik pustaka standar adalah layanan yang di-hosting, dan koneksi ke model itu harus membawa kredensial, sehingga Release melampirkan satu kredensial meskipun workflow membaca kuncinya dari penyimpanan n8n.

manifest.yaml — Recipes Compose untuk platform dan model, serta realisasi yang menulis referensi variabel kunci ke dalam berkas Compose apa adanya:

apiVersion: aggrega.ai/v1beta1
kind: Manifest
metadata:
name: imported/support-agent
version: 0.1.0
spec:
mappings:
components:
type:
core/ai-agent/n8n: compose/n8n
core/ai-model/openai: compose/openai
features:
type:
core/secret-value: compose/dotenv-secret

.aggrega-import.json adalah catatan tentang apa yang ditulis oleh impor, yang dibaca oleh aggrega import --sync berikutnya, dan release.lock menyematkan setiap entitas katalog yang menjadi hasil resolusi Release, berdasarkan versi dan digest.

Validasi dan build

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

Draf Release yang dibuka di editor setelah divalidasi, dengan keluaran Aggrega dan sebuah notifikasi yang sama-sama melaporkan tidak ada masalah.

Build dari draf Release: folder dist muncul di Explorer, keluaran Aggrega mencantumkan file Docker Compose yang ditulis, dan sebuah notifikasi menyatakan bahwa 1 file telah ditulis.

Validasi mencetak:

notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
release dependency validation passed: release.yaml (schema-pillar + dependency pillars)

dan build, dengan <workspace> mewakili folder yang berisi draf:

warning: node "n8n" (provider "compose"): artifact "n8n-flow.compose-fragment.yaml": skipped provenance label injection — the fragment declares no compose service. Compose carries build provenance as service labels, so a fragment contributing only top-level networks, volumes or configs carries none; the services this component emits elsewhere carry the full set.
notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
[… omitted: a total build time, which differs per run]
Build completed: 1 file written to <workspace>/dist

Baris warning menyangkut bagian file Compose yang membawa workflow, sebuah entri configs tingkat atas, yang tidak memiliki layanan untuk ditempeli label build. Baris notice bersifat anjuran: Feature rahasia menerima origin-nya dari values milik Aggregate atau infra milik Release, dan pemberitahuan tersebut melaporkan bahwa satu leaf dideklarasikan di keduanya. Tidak satu pun mengubah putusan.

dist/compose/docker-compose.yaml memuat n8n dan sebuah layanan yang mengimpor workflow sebelum n8n dimulai:

services:
n8n:
image: n8nio/n8n:1.110.1
environment:
OPENAI_BASE_URL: https://api.openai.com/v1
OPENAI_API_KEY: ${OPENAI_API_KEY}
N8N_BLOCK_ENV_ACCESS_IN_NODE: "true"
ports:
- 127.0.0.1:5678:5678
[… omitted: the labels the build writes on every service, naming the Aggregate, the component, the environment and the compiler's version]
volumes:
- type: volume
source: n8n--data
target: /home/node/.n8n
networks:
- compose
depends_on:
n8n--import-flow:
condition: service_completed_successfully
[… omitted: the service's health check]
n8n--import-flow:
image: n8nio/n8n:1.110.1
command:
- import:workflow
- --input=/flows/workflow.json
entrypoint:
- n8n
[… omitted: the labels the build writes on every service]
volumes:
- type: volume
source: n8n--data
target: /home/node/.n8n
networks:
- compose
restart: "no"
configs:
- source: n8n-flow
target: /flows/workflow.json

Workflow sampai ke n8n melalui n8n import:workflow, yang dijalankan pada volume data yang sama setiap kali stack dimulai, sebelum n8n itu sendiri. N8N_BLOCK_ENV_ACCESS_IN_NODE bernilai "true", yaitu blokir n8n terhadap workflow yang membaca lingkungannya, karena Aggregate membiarkan allow_env_access_in_nodes bernilai false. Jadi node OpenAI Chat Model membaca kuncinya dari penyimpanan kredensial milik n8n sendiri, sebagaimana pemicu chat membaca pengguna dan kata sandinya, dan langkah menjalankan di bawah ini menyimpan keduanya. Recipe Compose untuk n8n memublikasikan port di mesin Anda hanya jika Release menetapkan published_port di infra milik n8n, dan itu pun hanya pada alamat loopback, 127.0.0.1; tanpanya, layanan hanya dapat dijangkau di jaringan stack.

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 sendiri. Jika folder Workspace belum berisi folder `import-n8n`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-n8n` dan tanpa `dir`: alat itu menulis contoh ke folder `import-n8n` baru, yang folder `source`-nya berisi apa yang diimpor halaman ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-n8n/source`, `source` diatur ke `support-agent.json`, dan `target` diatur ke `compose`: alat itu 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. Lalu 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 build; file-file itu ada di bawah `import-n8n/source/dist/`.

Membukanya di VS Code

Dengan ekstensi Aggrega untuk Visual Studio Code terpasang, buka folder import-n8n/source di VS Code, tempat impor menulis drafnya. Folder ini berisi satu Release, yaitu draf release.yaml, sehingga editor memilihnya untuk Anda, dan editor memeriksa draf terhadap Release itu saat Anda menyuntingnya, menandai temuannya di file dan di panel Problems. Aggrega: Show topology graph, di Command Palette, menggambar komponen Release dan koneksi di antaranya. Aggrega: Build, Aggrega: Preview build, dan Aggrega: Pull bekerja pada Release yang sama, dan masing-masing juga merupakan tombol di panel Commands pada tampilan Aggrega di activity bar; Build menulis file-filenya ke dist/ di folder tersebut. Menggunakan Aggrega di Visual Studio Code membahas sisanya.

Menjalankannya

n8n membaca kedua kredensial yang dipilih workflow dari penyimpanannya sendiri, berdasarkan pengenalnya: kunci OpenAI di bawah Rb7nW2xQ9kT4mZ1c, serta pengguna dan kata sandi chat di bawah Vx3mQ8rLb2Nk7Tz5. Baris perintah milik n8n sendiri menyimpannya, di bawah pengenal tersebut, dari sebuah file. Tulis keduanya ke dalam credentials.json, dengan nilai Anda sendiri:

[
{"id": "Rb7nW2xQ9kT4mZ1c", "name": "OpenAI account", "type": "openAiApi", "data": {"apiKey": "your OpenAI key"}},
{"id": "Vx3mQ8rLb2Nk7Tz5", "name": "Chat basic auth", "type": "httpBasicAuth", "data": {"user": "a user of your own", "password": "a password of your own"}}
]

Atur kunci di shell Anda, sebagaimana Release draf membacanya, lalu mulai stack:

Terminal window
export OPENAI_API_KEY='your OpenAI key'
docker compose -p support-agent -f dist/compose/docker-compose.yaml up -d --wait

-p menamai proyek, sebagaimana dijelaskan oleh langkah menjalankan di Cara impor berjalan. --wait kembali begitu n8n melaporkan status sehat, setelah layanan yang mengimpor workflow selesai berjalan dan keluar. Salin kredensial ke dalam kontainer n8n, impor kredensial tersebut, lalu hapus salinannya:

Terminal window
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec -T n8n sh -c 'umask 077; cat > /tmp/credentials.json' < credentials.json
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec n8n n8n import:credentials --input=/tmp/credentials.json
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec n8n rm /tmp/credentials.json
[… omitted: n8n's notices about its settings file's permissions, error tracking and deprecated settings]
Successfully imported 2 credentials.

n8n kini menyimpan kedua kredensial, jadi hapus credentials.json:

Terminal window
rm credentials.json

Kemudian aktifkan workflow, lalu mulai ulang n8n agar aktivasinya berlaku:

Terminal window
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec n8n n8n update:workflow --id=sQ4vT8nKp2LmX7bR --active=true
docker compose -p support-agent -f dist/compose/docker-compose.yaml restart n8n

Setelah docker compose -p support-agent -f dist/compose/docker-compose.yaml ps n8n kembali menampilkan n8n (healthy), docker compose -p support-agent -f dist/compose/docker-compose.yaml logs n8n menampilkan Activated workflow "Support agent" (ID: sQ4vT8nKp2LmX7bR).

Mengujinya

Buka http://127.0.0.1:5678, alamat yang dipublikasikan published_port: editor n8n meminta akun pemilik pada kunjungan pertama, lalu menampilkan Support agent.

Pemicu chat hanya menerima pesan dengan pengguna dan kata sandi yang disimpan di atas; tanpanya, pemicu menjawab HTTP/1.1 401 Unauthorized dan Authorization is required!, dan dengan kata sandi yang salah HTTP/1.1 403 Forbidden. Dengan keduanya di CHAT_USER dan CHAT_PASSWORD, curl membacanya dari input standarnya, sehingga keduanya tidak muncul di baris perintah mana pun:

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"}

Eksekusi tersebut menyimpan nilai pengganti untuk kunci OpenAI, sehingga workflow berhenti pada panggilannya ke model. n8n menyimpan eksekusi itu, yang dicantumkan editor di bawah eksekusi workflow, beserta penolakan OpenAI: Incorrect API key provided: sk-place*****************-key. Dengan kunci Anda, balasannya adalah HTTP/1.1 200 OK dan jawaban agen, sebagai {"output": "…"}.

Di Kubernetes, dengan build yang dijelaskan Di Kubernetes telah diterapkan, n8n menyimpan datanya di volume yang hidup selama pod-nya hidup, sehingga pod baru dimulai tanpa apa yang Anda simpan; sebagai gantinya, simpan kredensial dan aktifkan workflow pada instans yang sedang berjalan. Tulis credentials.json seperti di Menjalankannya, impor melalui kubectl exec, dari input standarnya, di namespace tempat Anda menerapkan build, lalu hapus setelahnya:

Terminal window
kubectl exec -i -n <namespace> deploy/n8n -- n8n import:credentials --input=/dev/stdin < credentials.json
Defaulted container "main" out of: main, import-flow (init)
[… omitted: n8n's notices about its settings file's permissions, error tracking and deprecated settings]
Successfully imported 2 credentials.

Teruskan sebuah port lokal ke Service n8n, n8n-default, dan biarkan perintahnya tetap berjalan:

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

Dari terminal lain, siapkan akun pemilik melalui API n8n, yang memasukkan Anda dan menyimpan sesi di cookies.txt, lalu aktifkan workflow:

Terminal window
curl -sS -c cookies.txt -X POST http://127.0.0.1:5678/rest/owner/setup -H 'Content-Type: application/json' \
-d '{"email": "owner@example.com", "firstName": "Your", "lastName": "Name", "password": "a password of your own"}'
curl -sS -b cookies.txt -X PATCH http://127.0.0.1:5678/rest/workflows/sQ4vT8nKp2LmX7bR \
-H 'Content-Type: application/json' -d '{"active": true}'

Balasan kedua adalah workflow, dengan "active":true. Pesan chat di atas kemudian mencapainya di alamat yang sama, tanpa perubahan; eksekusi tersebut mendapatkan {"message":"Error in workflow"} yang sama dan penolakan yang sama di dalam eksekusi n8n.

Hentikan stack dengan perintah di bawah. -v juga menghapus volume data n8n, dan bersamanya kredensial yang tersimpan serta aktivasinya:

Terminal window
docker compose -p support-agent -f dist/compose/docker-compose.yaml down -v

Di Kubernetes

Workflow yang sama diimpor untuk Kubernetes dengan target helm. Draf untuk Docker Compose sudah berada di source, dan impor tidak pernah menimpa Aggregate di sana, jadi buat draf ini ke folder tersendiri dengan --output-dir, lalu validasi dan build dari folder tersebut:

Terminal window
aggrega import support-agent.json --target helm --output-dir helm
cd helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

Draf berbeda di bagian yang targetnya berbeda. Manifest memetakan platform ke helm/n8n, model ke helm/openai, dan kunci ke helm/k8s-existing-secret, yang membacanya dari Secret yang sudah ada di namespace. Release melampirkan kunci sebagai core/referenced-secret, dengan menyebut Secret tersebut, openai-api-key, dari berkas jawaban.

Build menulis manifes Kubernetes biasa di bawah dist/helm/ pada root workspace, source, yang dari helm adalah ../dist/helm/. Buat Secret di namespace tempat Anda menerapkan, yang menyimpan kunci di bawah kunci data value, lalu terapkan folder sebagaimana dijelaskan langkah menjalankan pada Cara impor berjalan. Workflow tetap membaca kredensialnya dari penyimpanan milik n8n sendiri, yang diisi oleh Mengujinya di Kubernetes.