Bir n8n iş akışını içe aktarma
Bu adım adım kılavuz, n8n’den dışa aktarılmış bir iş akışını — sohbet mesajlarını bir OpenAI sohbet modeli ve bir bellekle yanıtlayan bir yapay zekâ ajanını — yazıldıkları hâliyle iş akışını taşıyan n8n’i Docker Compose için derleyen bir Aggregate, bir Release ve bir Manifest’e içe aktarır, ardından bunları derler ve sonucu çalıştırır. Aşağıdaki her dosya ve her çıktı bloğu gerçek bir çalıştırmadan gelir; iş akışı ve kılavuzun her aşaması import-n8n örneğindedir; orada bir denetim betiği içe aktarmayı yeniden çalıştırır, yazdıklarını, yazdırdıklarını ve bu sayfanın alıntıladığı blokları orada tutulan dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler.
Örneği oluşturun
Bu içe aktarmayı bu sayfadaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin için çalıştırtabilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example import-n8nArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer; ondan sonraki, aşağıda, yeni klasörün içindeki, bu sayfanın içe aktardıklarını barındıran ve içe aktarmanın çalıştığı yer olan source klasörüne geçer:
cd import-n8n
İş akışı
Bu kılavuz için n8n’in bir iş akışını dışa aktardığı biçimde yazılmış olan support-agent.json dört düğüm içerir: bir sohbet tetikleyicisi, kısa bir sistem mesajı olan bir AI Agent, gpt-4o-mini seçen bir OpenAI Chat Model düğümü ve bir Simple Memory düğümü; bunlar, n8n’in her birini çıktığı düğümün adına göre listelediği bağlantılarla birleştirilir. Sohbet tetikleyicisi herkese açıktır; bu yüzden URL’sine gönderilen bir sohbet mesajı iş akışını başlatır ve tetikleyici gönderenden bir kullanıcı ve parola ister, bunları n8n’in sakladığı bir temel kimlik doğrulama kimlik bilgisine karşı denetler:
"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" } }Model düğümü kimlik bilgisini aynı şekilde, başvuruyla seçer — dışa aktarma her kimlik bilgisinin tanımlayıcısını ve adını taşır, kullanıcıyı, parolayı veya anahtarı asla taşımaz:
"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" } }İş akışının yanındaki bir .aggrega-config.yaml, klasörü bir çalışma alanı yapar:
# 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.aive import-answers.yaml, hiçbir iş akışının tutamayacağı şeylerin yanıtlarını tutar. Docker Compose için bir içe aktarmanın hiçbirine ihtiyacı yoktur: OpenAI anahtarını, Docker Compose’un kabuğunuzdan doldurduğu bir değişken başvurusuyla ekler. Kubernetes için bir içe aktarma ise onu, yalnızca sizin adlandırabileceğiniz bir Kubernetes Secret’inin adıyla ekler; bu yüzden dosya o Secret’i adlandırır (bkz. Kubernetes üzerinde):
# 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"İçe aktarma yanıt dosyası dosyayı ayrıntılı olarak açıklar.
İçe aktarma her düğümü çalışma alanının kataloğundaki Components ile karşılaştırır ve --target kataloğun Recipes’inden bir Manifest taslağı oluşturur. Çalışma alanı hiçbir katalog klasörü belirtmediği için içe aktarma, standart kütüphane kataloğunu içe aktarıcısını getirdiği kayıt defterinden okur. Bu, yayımlanmış kataloğun imzalı bir anlık görüntüsüdür: ilk içe aktarma onu getirir, doğrular ve çalışma alanının içerik önbelleğinde tutar; içe aktarmanın taslaklarının yanına yazdığı kayıt da onu özetiyle adlandırır. Kendi katalog klasörlerini AGGREGA_CATALOG_DIRS içinde veya workspace.catalog_dirs altında belirten bir çalışma alanı ise bunun yerine bunlara göre içe aktarır. source klasörüne geçin:
cd sourceİçe aktarmayı çalıştırma
aggrega import support-agent.json --target composeStandart çıktıda yazdıklarını listeler:
wrote aggregate.yamlwrote release.yamlwrote manifest.yamlwrote .aggrega-import.jsonStandart hatada, <workspace> onu çalıştırdığınız klasörü temsil edecek şekilde:
[… 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 emptywarn: 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 emptywarn: 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 includedmade 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.9143made 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)
mappedsatırı, OpenAI Chat Model düğümünün standart kütüphanenin OpenAI modeli olancore/ai-model/openaihâline geldiğini söyler; yüksek düzeyde 0.9143 değeriyle eşleştiği için taslak olarak hazırlanmak yerine başvurulmuştur: platformunmodelsoketine bağlanmış kendi başına bir bileşen.made no choicesatırları, tetikleyicinin, ajanın ve belleğin, n8n’in kendisinin çalıştırdığı iş akışının içinde kaldığını söyler.- İlk iki
warnsatırı, tetikleyicinin ve model düğümünün seçtiği saklanan kimlik bilgilerinin, n8n’in kimlik bilgisi olarak işaretlediği tanımlayıcılarını adlandırır. Bunlar sır değil, başvurudur ve yazıldıkları gibi taşınır. - Üçüncü
warnsatırı dikkatle okunması gerekendir: model düğümü OpenAI’a, taslağın bağladığı bağlantı üzerinden değil, seçtiği saklanan kimlik bilgisiyle ulaşır. Platform bağlantıyı n8n’in ortamına teslim eder ve Aggregate, taslağın yaptığı gibivalues.allow_env_access_in_nodesdeğerinifalseolarak bıraktığı sürece n8n bir iş akışının kendi ortamını okumasını reddeder. Bunutrueolarak ayarlamak, her iş akışının ve bir iş akışını düzenleyebilen herkesin, teslim edilen anahtar dahil platformun her değişkenini okumasına izin verir. Bu nedenle iş akışının kullandığı anahtar, Çalıştırın bölümünün gösterdiği gibi n8n’in sakladığı anahtardır. - Son iki satır çekme işlemidir. Yanıtlanacak bir şey kalmadığı için içe aktarma, taslağı oluşturulan Release’in bağımlılıklarını
aggrega pullgibi çekti verelease.lockdosyasını yazdı; aşağıdaki derlemenin başka bir şeye ihtiyacı yoktur.warningsatırı derlemenin de yazdırdığı bir satırdır ve Doğrulama ve derleme bunu açıklar.
Yanıt dosyası, bu içe aktarmanın sormadığı bir Secret’ı adlandırır: içe aktarma onun için boş bir şey bırakmaz, bu yüzden hiçbir yanıt uygulamaz ve dosyayı olduğu gibi bırakır.
Ne yazar
Aggregate, Release ve Manifest, iş akışının kendi adı olan Support agent değerinin support-agent biçimine indirgenmesiyle imported/support-agent olarak adlandırılır — adı olmayan bir iş akışı dosyasının adını alır — ve içe aktarıcının target_namespace ayarının belirlediği ad alanı altında yer alır; bu ad alanı, başka birini ayarlamadığınız sürece imported olur (Ayarlar).
aggregate.yaml — standart kütüphanenin n8n platformu olan core/ai-agent/n8n’in bir örneği; iş akışını dışa aktarıldığı hâliyle taşır, iş akışının çoğu burada dışarıda bırakılmıştır; ayrıca model soketine bağlanmış model:
apiVersion: aggrega.ai/v1beta1kind: Aggregatemetadata: 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-miniworkflow_id, dışa aktarmanın iş akışına verdiği tanımlayıcıdır. Model, düğümün seçtiği gpt-4o-mini modeliyle birlikte core/ai-model/openai’dır; üstündeki yorum, düğümün benzediği katalogdaki başka bir Component’i puanıyla birlikte adlandırır. Platformun modele sunduğu OpenAI anahtarı, bağlantı üzerinde, n8n’in ortamına geldiği değişken olan OPENAI_API_KEY ile bildirilir; nereden geldiğini Release söyler.
release.yaml — Aggregate’i Manifest ile dağıtan Release:
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: 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: {}environmentdevelopmentdeğerindedir; bu, üstündeki yorumun Release’in dağıtıldığı ortamla değiştirilmesini söylediği bir varsayılandır.- İmaj, n8n 1.110.1’dir; kataloğun n8n için Recipes’inin çalıştırdığı sürümdür.
published_port, n8n’in hizmet verdiği port olan 5678’dir; bu yüzden düzenleyici makinenizdehttp://127.0.0.1:5678adresinde yanıt verir. Yorumunda belirtildiği gibi, bu makinedeki her süreç ona orada ulaşabilir ve başka hiçbir şey ulaşamaz; n8n’i yalnızca yığının ağında tutmak için satırı silin. 5678 dışındaki birpublished_port, yanındainfra.external_base_url: http://127.0.0.1:<published_port>gerektirir; aksi halde n8n düzenleyicisinin ve webhook’larının adreslerinilocalhost:5678üzerinde bildirir.- Anahtar, yığın başladığında Docker Compose’un kabuğunuzdan doldurduğu bir değişken başvurusudur:
${OPENAI_API_KEY}. Standart kütüphanenin OpenAI modeli barındırılan bir hizmettir ve ona giden bir bağlantı bir kimlik bilgisi taşımalıdır; bu yüzden iş akışı anahtarını n8n’in deposundan okusa da Release bir kimlik bilgisi ekler.
manifest.yaml — platformun ve modelin Compose Recipes’i ile anahtarın değişken başvurusunu Compose dosyasına yazıldığı gibi yazan gerçekleştirme:
apiVersion: aggrega.ai/v1beta1kind: Manifestmetadata: name: imported/support-agent version: 0.1.0spec: 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, içe aktarmanın yazdıklarının kaydıdır ve daha sonraki bir aggrega import --sync bunu okur; release.lock ise Release’in çözümlendiği her katalog varlığını sürüm ve özet (digest) ile sabitler.
Doğrulama ve derleme
aggrega validate --release release.yamlaggrega build --release release.yaml

Doğrulama şunu yazdırır:
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)ve derleme, <workspace> taslakları içeren klasörü temsil edecek şekilde:
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>/distwarning satırı, Compose dosyasının iş akışını taşıyan bölümüyle, yani derlemenin etiketlerini koyacak bir hizmeti olmayan üst düzey bir configs girdisiyle ilgilidir. notice satırı tavsiye niteliğindedir: gizli değer Feature’ı, origin değerini Aggregate’in values alanından ya da Release’in infra alanından kabul eder ve bildirim bir yaprağın her ikisinde de bildirildiğini raporlar. Hiçbiri kararı değiştirmez.
dist/compose/docker-compose.yaml, n8n’i ve n8n başlamadan önce iş akışını içe aktaran bir hizmeti içerir:
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İş akışı n8n’e, yığın her başladığında aynı veri birimi üzerinde, n8n’in kendisinden önce çalıştırılan n8n import:workflow aracılığıyla ulaşır. Aggregate allow_env_access_in_nodes değerini false olarak bıraktığı için, n8n’in bir iş akışının ortamını okumasına koyduğu engel olan N8N_BLOCK_ENV_ACCESS_IN_NODE, "true" değerindedir. Bu nedenle OpenAI Chat Model düğümü, sohbet tetikleyicisinin kullanıcı adını ve parolasını okuduğu gibi, anahtarını n8n’in kendi kimlik bilgisi deposundan okur ve aşağıdaki çalıştırma adımları ikisini de saklar. n8n’in Compose Recipe’i makinenizde yalnızca Release n8n’in infra alanında published_port ayarladığında bir port yayımlar ve o zaman da yalnızca geri döngü adresi 127.0.0.1 üzerinde; bu ayar olmadan servise yalnızca yığının ağı üzerinden ulaşılır.
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. Workspace klasöründe henüz bir `import-n8n` klasörü yoksa, `example` değeri `import-n8n` olarak ayarlanmış ve `dir` olmadan `scaffold` aracını bir kez çağır: araç örneği, `source` klasörü bu sayfanın içe aktardıklarını içeren yeni bir `import-n8n` klasörüne yazar. Ardından `workspace_root` değeri `import-n8n/source`, `source` değeri `support-agent.json` ve `target` değeri `compose` olarak ayarlanmış şekilde `import` aracını çağır: araç ihtiyaç duyduğu yanıtları `support-agent.json` dosyasının yanındaki `import-answers.yaml` dosyasından okur, taslaklarını `import-n8n/source` içine yazar ve taslakların ihtiyaç duyduklarını çeker. Ardından `workspace_root` değeri `import-n8n/source` ve `release` değeri `release.yaml` olarak ayarlanmış şekilde `validate` aracını, `workspace_root` değeri `import-n8n/source`, `release` değeri `release.yaml` ve `write` değeri true olarak ayarlanmış şekilde de `build` aracını çağır. Derlemenin hangi dosyaları yazdığını bana söyle; bunlar `import-n8n/source/dist/` altındadır.VS Code’da açın
Visual Studio Code için Aggrega uzantısı yüklüyken, içe aktarmanın taslaklarını yazdığı import-n8n/source klasörünü VS Code’da açın. Klasörde tek bir Release, yani taslağı oluşturulan release.yaml bulunur; bu yüzden düzenleyici onu sizin için seçer ve siz taslakları düzenlerken onları bu Release’e göre denetleyip bulduklarını dosyada ve Sorunlar panelinde işaretler. Komut Paleti’ndeki Aggrega: Show topology graph, 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ı klasörün dist/ dizinine yazar. Gerisini Aggrega’yı Visual Studio Code’da kullanma anlatır.
Çalıştırın
n8n, iş akışının seçtiği iki kimlik bilgisini de tanımlayıcılarıyla kendi deposundan okur: OpenAI anahtarını Rb7nW2xQ9kT4mZ1c altında, sohbetin kullanıcı adını ve parolasını ise Vx3mQ8rLb2Nk7Tz5 altında. n8n’in kendi komut satırı bunları bir dosyadan, bu tanımlayıcılar altında saklar. Bunları kendi değerlerinizle credentials.json dosyasına yazın:
[ {"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"}}]Anahtarı, taslak Release’in okuduğu şekilde kabuğunuzda ayarlayın ve yığını başlatın:
export OPENAI_API_KEY='your OpenAI key'docker compose -p support-agent -f dist/compose/docker-compose.yaml up -d --wait-p, Bir içe aktarma nasıl çalışır bölümünün çalıştırma adımının açıkladığı gibi projeyi adlandırır. --wait, iş akışını içe aktaran hizmet çalışıp çıktıktan sonra, n8n sağlıklı olduğunu bildirdiğinde döner. Kimlik bilgilerini n8n’in kapsayıcısına kopyalayın, içe aktarın ve kopyayı kaldırın:
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec -T n8n sh -c 'umask 077; cat > /tmp/credentials.json' < credentials.jsondocker compose -p support-agent -f dist/compose/docker-compose.yaml exec n8n n8n import:credentials --input=/tmp/credentials.jsondocker 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 artık iki kimlik bilgisini de tutuyor, bu yüzden credentials.json dosyasını silin:
rm credentials.jsonArdından iş akışını etkinleştirin ve etkinleştirmenin geçerli olması için n8n’i yeniden başlatın:
docker compose -p support-agent -f dist/compose/docker-compose.yaml exec n8n n8n update:workflow --id=sQ4vT8nKp2LmX7bR --active=truedocker compose -p support-agent -f dist/compose/docker-compose.yaml restart n8ndocker compose -p support-agent -f dist/compose/docker-compose.yaml ps n8n n8n’i yeniden (healthy) olarak gösterdiğinde, docker compose -p support-agent -f dist/compose/docker-compose.yaml logs n8n çıktısında Activated workflow "Support agent" (ID: sQ4vT8nKp2LmX7bR) yer alır.
Test edin
published_port’un yayımladığı adres olan http://127.0.0.1:5678 adresini açın: n8n’in düzenleyicisi ilk ziyarette bir sahip hesabı ister, ardından Support agent’ı gösterir.
Sohbet tetikleyicisi bir mesajı yalnızca yukarıda saklanan kullanıcı adı ve parolayla kabul eder; bunlar olmadan HTTP/1.1 401 Unauthorized ve Authorization is required! yanıtını, yanlış bir parolayla ise HTTP/1.1 403 Forbidden yanıtını verir. İkisi CHAT_USER ve CHAT_PASSWORD içindeyken curl bunları standart girdisinden okur, böylece hiçbir komut satırında görünmezler:
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"}Çalıştırma OpenAI anahtarı için bir yer tutucu sakladı; bu yüzden iş akışı modele yaptığı çağrıda durdu. n8n bu yürütmeyi saklar; düzenleyici onu iş akışının yürütmeleri altında, OpenAI’ın reddiyle birlikte listeler: Incorrect API key provided: sk-place*****************-key. Kendi anahtarınızla yanıt HTTP/1.1 200 OK ve ajanın cevabıdır, {"output": "…"} biçiminde.
Kubernetes’te, Kubernetes’te bölümünün anlattığı derleme uygulandığında n8n verilerini pod’u yaşadığı sürece yaşayan bir birimde tutar; bu yüzden yeni bir pod sakladıklarınız olmadan başlar. Bunun yerine kimlik bilgilerini çalışan örnekte saklayın ve iş akışını orada etkinleştirin. credentials.json dosyasını Çalıştırın bölümündeki gibi yazın, uyguladığınız ad alanında kubectl exec aracılığıyla standart girdisinden içe aktarın ve ardından silin:
kubectl exec -i -n <namespace> deploy/n8n -- n8n import:credentials --input=/dev/stdin < credentials.jsonDefaulted 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.n8n’in Service’ine, n8n-default, yerel bir port yönlendirin ve komutu çalışır durumda bırakın:
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678Başka bir terminalden, sizi oturum açtıran ve oturumu cookies.txt içinde tutan n8n API’si üzerinden sahip hesabını kurun, ardından iş akışını etkinleştirin:
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}'İkinci yanıt, "active":true içeren iş akışıdır. Yukarıdaki sohbet mesajı ardından ona aynı adreste, değiştirilmeden ulaşır; çalıştırma aynı {"message":"Error in workflow"} yanıtını ve yürütmede aynı reddi aldı.
Yığını aşağıdaki komutla durdurun. -v ayrıca n8n’in veri birimini ve onunla birlikte saklanan kimlik bilgilerini ve etkinleştirmeyi de kaldırır:
docker compose -p support-agent -f dist/compose/docker-compose.yaml down -vKubernetes üzerinde
Aynı iş akışı, helm hedefiyle Kubernetes için içe aktarılır. Docker Compose taslakları zaten source içinde bulunur ve içe aktarma oradaki bir Aggregate’in üzerine asla yazmaz; bu nedenle bunları --output-dir ile kendilerine ait bir klasöre taslak olarak yazın, ardından o klasörden doğrulayıp derleyin:
aggrega import support-agent.json --target helm --output-dir helmcd helmaggrega validate --release release.yamlaggrega build --release release.yamlTaslaklar, hedefin farklı olduğu yerlerde farklılaşır. Manifest platformu helm/n8n’e, modeli helm/openai’a ve anahtarı helm/k8s-existing-secret’a eşler; bu sonuncusu anahtarı ad alanında zaten bulunan bir Secret’tan okur. Release anahtarı core/referenced-secret olarak ekler ve yanıt dosyasından o Secret’ı, openai-api-key’i adlandırır.
Derleme, düz Kubernetes manifestlerini çalışma alanı kökü olan source altındaki dist/helm/ içine yazar; bu, helm klasöründen bakıldığında ../dist/helm/ olur. Secret’ı uyguladığınız ad alanında, anahtarı value veri anahtarı altında tutacak şekilde oluşturun, ardından klasörü Bir içe aktarma nasıl çalışır sayfasının çalıştırma adımının açıkladığı gibi uygulayın. İş akışı, kimlik bilgilerini hâlâ n8n’in kendi deposundan okur; Kubernetes’te bu depoyu Test edin bölümü doldurur.