İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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:

Terminal window
aggrega scaffold --example import-n8n

Ardı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:

Terminal window
cd import-n8n

Visual Studio Code'da açılmış, iskeleti oluşturulan örneğin source klasörü; bir destek ajanının n8n iş akışı dışa aktarımını, sohbet tetikleyicisi ve AI Agent düğümlerinden başlayarak gösteriyor.

İş 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.ai

ve 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:

Terminal window
cd source

İçe aktarmayı çalıştırma

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

Standart çıktıda yazdıklarını listeler:

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

Standart 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 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)

Düzenleyiciden çalıştırılan içe aktarma: taslağı oluşturulan Aggregate, Release ve Manifest iş akışı dışa aktarımının yanında görünüyor, Aggrega çıktısı her düğümün nasıl eşlendiğini ve yazılan dosyaları listeliyor ve bir bildirim, içe aktarmanın n8n olarak tanınan 3 dosyanın taslağını oluşturduğunu söylüyor.

  • mapped satırı, OpenAI Chat Model düğümünün standart kütüphanenin OpenAI modeli olan core/ai-model/openai hâ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: platformun model soketine bağlanmış kendi başına bir bileşen.
  • made no choice satı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 warn satı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ü warn satı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ığı gibi values.allow_env_access_in_nodes değerini false olarak bıraktığı sürece n8n bir iş akışının kendi ortamını okumasını reddeder. Bunu true olarak 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 pull gibi çekti ve release.lock dosyasını yazdı; aşağıdaki derlemenin başka bir şeye ihtiyacı yoktur. warning satı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/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, 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/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 development değ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 makinenizde http://127.0.0.1:5678 adresinde 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 bir published_port, yanında infra.external_base_url: http://127.0.0.1:<published_port> gerektirir; aksi halde n8n düzenleyicisinin ve webhook’larının adreslerini localhost: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/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, 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

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

Doğrulandıktan sonra düzenleyicide açılan taslak Release; Aggrega çıktısı ve bir bildirim, ikisi de hiçbir sorun bulunmadığını bildiriyor.

Taslak Release'in derlemesi: Gezgin'de bir dist klasörü görünüyor, Aggrega çıktısı yazılan Docker Compose dosyasını listeliyor ve bir bildirim 1 dosyanın yazıldığını söylüyor.

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>/dist

warning 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:

Terminal window
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:

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 artık iki kimlik bilgisini de tutuyor, bu yüzden credentials.json dosyasını silin:

Terminal window
rm credentials.json

Ardından iş akışını etkinleştirin ve etkinleştirmenin geçerli olması için n8n’i yeniden başlatın:

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

docker 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:

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

Ç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:

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.

n8n’in Service’ine, n8n-default, yerel bir port yönlendirin ve komutu çalışır durumda bırakın:

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

Baş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:

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

İ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:

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

Kubernetes ü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:

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

Taslaklar, 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.