Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Component

core/ai-agent/n8n

The n8n automation platform, run in-cluster as the image a Release names. n8n runs workflows built from connected nodes and started by a webhook, a schedule or an event, so deploying it gives the editor and the webhook endpoint together, with a model reachable from whichever node needs one. What this component exposes is the workflow a caller invokes and, optionally, the workflow definition itself: supplied in the Aggregate, it is imported before the platform starts and on every start, so the platform runs the workflow as authored, whatever its data directory holds. The catalog pins no image: the Release names it in `infra.image`, and the build halts naming the container image until it does. The model, and each tool and store wired into the optional `tools` and `vector_store` sockets, reach the platform as environment variables, each credential by reference; each socket's comments and slots name them. A connection writing an `inject:` block receives the names it dictates instead of those its target's values fill; its credentials stay. A workflow reads these through n8n's $env only where the Aggregate sets `values.allow_env_access_in_nodes` to true. By default the Recipes keep n8n's block on environment access in expressions and the Code node, and lifting it lets every workflow read every variable of the platform's environment, the delivered credentials included. On Kubernetes, reach for `n8n-chart`, rendering n8n's own chart, where a chart repository is reachable at build time, and for `n8n`, the workload synthesis, where the build must fetch nothing. Of the two, only `n8n-chart` keeps the data directory on a volume that survives a restart, sized by `infra.storage.size`.

Versi

1.0.01.1.0

Asal-usul

ResmiDitandatangani oleh identitas penandatangan yang diakui katalog ini sebagai penerbit resmi.
Digest konten
sha256:772818daad76a25f73dd64f4236d7c429dc306ee3f632fe72ab3600c93d08c00
Dipublikasikan
2026-11-10T10:08:31Z
Identitas penandatangan
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Tanda tangan

  • Resmiapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:28d68fab85eba8f19a937f9f9a3e2554360d27643ca4cedcda9753abcdf15c24

Referensi pada versi ini

oci://hub.aggrega.ai/component/core/ai-agent/n8n:1.0.0

Parameter pengembang

Nilai yang ditetapkan pengembang di Aggregate.

Memperluas BaseComponents#/schemas/BaseAgentParameter

NamaTipeBawaanWajibDeskripsi
workflow_idstring—ya—
allow_env_access_in_nodesbooleanfalsetidakWhether workflows may read the platform's environment through n8n's $env, in expressions and the Code node. While false, its default, the Recipes deliver N8N_BLOCK_ENV_ACCESS_IN_NODE set to true, n8n refuses every such read, and the delivered model, tool and store values cannot be read by a workflow. Set true, the variable is delivered as false, and every workflow, and every user who can edit one, can read every variable of the platform's environment, the delivered credentials included.
flow_definitionstring—tidakThe n8n workflow definition (JSON) the developer authors. Both targets realize it with an init step that imports the definition before the platform starts: the helm target carries it in a ConfigMap, and the compose target carries it in a config. An Aggregate's text is evaluated as a template before it is read, so a definition carrying n8n's own {{ ... }} expressions halts the build when written into an Aggregate as it stands; write each {{ in it as {{"{{"}}, and interpolation restores the definition's text. When unset, no init step is rendered and the platform deploys with no seeded workflow — author or import the workflow through the editor instead.
metrics_enabledbooleanfalsetidakTurns on n8n's own metrics, in the Prometheus format, and publishes their address as `metrics_endpoint`; while false that key is empty. They are served at /metrics on the platform's main port, which answers that path without a sign-in, so anything that reaches the port can read them.

Penentuan ukuran oleh operator

Ukuran infrastruktur yang disesuaikan operator untuk setiap lingkungan.

NamaTipeBawaanWajibDeskripsi
imagestring—tidakContainer image running the n8n platform.
source_versionstring—tidakVersion of n8n's own Helm chart the chart-backed Recipe pulls, defaulting to the version that Recipe was checked against. The workload-synthesis and compose Recipes pull no chart and read nothing here.
storageobject—tidak—
external_base_urlstring—tidakExternally reachable base URL of the platform, as assembled at the ingress tier — for example https://n8n.example.com. The platform composes from this the editor address it puts in the emails it sends and hands a SAML identity provider to return a browser to, and the base of every webhook URL it shows in the editor and registers with an outside service, so a service calling a workflow back reaches the platform. The editor is served from the root of that address; the product recommends a host of its own over a path behind a reverse proxy. Omitted, the Recipes set neither address and the platform composes both from its host, port and path settings, whose defaults name localhost — correct only for a platform no outside service calls.

Kontrak keluaran

Nilai yang dipublikasikan komponen ini kepada konsumen melalui topologi uses.

NamaTipeBawaanWajibDeskripsi
metrics_endpointstring—tidakThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:5678/metrics`, the host being the platform's Service name. Empty while values.metrics_enabled is false.

Soket uses

Soket dependensi yang menjadi jalur koneksi komponen ini. Target setiap koneksi yang dihubungkan melalui sebuah soket harus memenuhi selektor labelnya, dan setiap koneksi dapat membawa lampiran pada slot yang dideklarasikan soket tersebut. Slot wajib harus diisi oleh setiap koneksi yang dihubungkan oleh Aggregate atau Release melalui soket tersebut.

model

Selektor
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Injeksi
env, file

Slot yang dapat diisi oleh setiap koneksi melalui soket ini

SlotSelektorWajibInjeksiSensitifDeskripsi
credentialfeature.aggrega.ai/kind=secrettidakenvyaOptional credential the platform presents to the model this connection reaches. When attached, the Recipe delivers it to the platform as OPENAI_API_KEY (a Kubernetes secretKeyRef on helm, the inject pipe on compose), which a workflow reads through n8n's $env only while allow_env_access_in_nodes is true, the Recipes otherwise keeping n8n's block on environment access in nodes; unattached, the platform runs without an injected key.

tools

Selektor
component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
Injeksi
env, file

Slot yang dapat diisi oleh setiap koneksi melalui soket ini

SlotSelektorWajibInjeksiSensitifDeskripsi
credentialfeature.aggrega.ai/kind=secrettidakenvyaOptional credential the platform presents to the tool this connection reaches, under the request header the tool publishes as credential_header: as Bearer <credential> under Authorization, and as the whole value of any other header. When attached, the Recipe delivers it as AGGREGA_TOOL_<ALIAS>_CREDENTIAL (a Kubernetes secretKeyRef on helm, the inject pipe on compose), and, on a connection writing no inject block, the header as AGGREGA_TOOL_<ALIAS>_CREDENTIAL_HEADER where the tool publishes one.
endpointfeature.aggrega.ai/kind=secrettidakenvyaOptional whole address of the tool this connection reaches, the part carrying its key included, for a server that reads its key from its own address. When attached, the Recipe delivers it as AGGREGA_TOOL_<ALIAS>_URL in place of the endpoint the tool publishes: a Kubernetes secretKeyRef on helm, so the key reaches no rendered file, and the inject pipe on compose, written as delivered.

vector_store

Selektor
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
Injeksi
env, file

Slot yang dapat diisi oleh setiap koneksi melalui soket ini

SlotSelektorWajibInjeksiSensitifDeskripsi
credentialfeature.aggrega.ai/kind=secrettidakenvyaOptional credential the platform presents to the vector store this connection reaches, such as the API key the store checks. When attached, the Recipe delivers it as AGGREGA_VECTOR_STORE_<ALIAS>_CREDENTIAL (a Kubernetes secretKeyRef on helm, the inject pipe on compose); unattached, no credential is delivered for the store.

Slot lampiran

Titik pengikatan bernama tempat sebuah Feature dilampirkan ke komponen ini. Selektor sebuah slot membatasi Feature mana yang dapat mengisinya, dan daftar injeksinya menyebutkan cara materi Feature dapat dikirimkan. Slot wajib harus terikat pada setiap instans, melalui lampiran pada instans tersebut atau pada cakupan di atasnya, dan slot sensitif dideklarasikan untuk menangani materi rahasia. Sebuah Feature juga dapat dilampirkan dengan nama yang tidak dideklarasikan oleh slot mana pun.

Tidak ada slot lampiran yang dideklarasikan.

Daftar izin injeksi mandiri

Tidak ada pipa injeksi mandiri yang dideklarasikan.

Relasi

Sisi bertipe ke dan dari entitas lain yang dipublikasikan. Referensi tanpa target yang dipublikasikan ditampilkan sebagai sisi yang terputus, bukan sebagai tautan.

Menggunakan

Digunakan oleh

Referensi konsep Component →

Katalog Aggrega — indeks terbuka berisi komponen, fitur, resep, dan plugin yang merendernya.

Dibangun dengan sistem desain Aggrega yang digunakan bersama.

Privasi