Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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`.

Wersja

1.0.01.1.0

Pochodzenie

OficjalnyPodpisano tożsamością podpisującą, którą ten katalog uznaje za oficjalnego wydawcę.
Skrót zawartości
sha256:772818daad76a25f73dd64f4236d7c429dc306ee3f632fe72ab3600c93d08c00
Opublikowano
2026-11-10T10:08:31Z
Tożsamość podpisująca
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Podpis

  • Oficjalnyapplication/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

Referencja w tej wersji

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

Parametry dewelopera

Wartości ustawiane przez dewelopera w encji Aggregate.

Rozszerza BaseComponents#/schemas/BaseAgentParameter

NazwaTypWartość domyślnaWymaganeOpis
workflow_idstring—tak—
allow_env_access_in_nodesbooleanfalsenieWhether 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—nieThe 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_enabledbooleanfalsenieTurns 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.

Wymiarowanie przez operatora

Wymiarowanie infrastruktury, które operator dostraja dla każdego środowiska.

NazwaTypWartość domyślnaWymaganeOpis
imagestring—nieContainer image running the n8n platform.
source_versionstring—nieVersion 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—nie—
external_base_urlstring—nieExternally 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.

Kontrakt wyjściowy

Wartości, które ten komponent publikuje konsumentom za pośrednictwem topologii uses.

NazwaTypWartość domyślnaWymaganeOpis
metrics_endpointstring—nieThe 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.

Gniazda uses

Gniazda zależności, przez które łączy się ten komponent. Cel każdego połączenia poprowadzonego przez gniazdo musi spełniać jego selektor etykiet, a każde połączenie może przenosić dołączenie w slotach deklarowanych przez gniazdo. Wymagany slot musi wypełnić każde połączenie, które encja Aggregate lub encja Release prowadzi przez gniazdo.

model

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

Sloty, które może wypełnić każde połączenie przez to gniazdo

SlotSelektorWymaganeWstrzykiwanieWrażliweOpis
credentialfeature.aggrega.ai/kind=secretnieenvtakOptional 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
Wstrzykiwanie
env, file

Sloty, które może wypełnić każde połączenie przez to gniazdo

SlotSelektorWymaganeWstrzykiwanieWrażliweOpis
credentialfeature.aggrega.ai/kind=secretnieenvtakOptional 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=secretnieenvtakOptional 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)
Wstrzykiwanie
env, file

Sloty, które może wypełnić każde połączenie przez to gniazdo

SlotSelektorWymaganeWstrzykiwanieWrażliweOpis
credentialfeature.aggrega.ai/kind=secretnieenvtakOptional 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.

Sloty dołączania

Nazwane punkty wiązania, w których encja Feature dołącza się do tego komponentu. Selektor slotu ogranicza, która encja Feature może go wypełnić, a jego lista inject określa, jak można dostarczyć materiał encji Feature. Wymagany slot musi być powiązany w każdej instancji, przez dołączenie w instancji lub w zakresie nad nią, a slot wrażliwy jest zadeklarowany do obsługi materiału tajnego. Encja Feature może również dołączyć się pod nazwą, której nie deklaruje żaden slot.

Nie zadeklarowano slotów dołączania.

Lista dozwolonych samowstrzyknięć

Nie zadeklarowano potoków samowstrzykiwania.

Relacje

Typowane krawędzie do innych opublikowanych encji i od nich. Odwołanie bez opublikowanego celu jest renderowane jako przerwana krawędź, a nie jako łącze.

Używa

Używane przez

Dokumentacja pojęcia Component →

Katalog Aggrega — otwarty indeks komponentów, funkcji, receptur oraz wtyczek, które je renderują.

Zbudowano przy użyciu wspólnego systemu projektowego Aggrega.

Prywatność