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`.
版本
来源
- 内容摘要
- sha256:9e50d98c38df38057cc90e396def59e51993ea59eaa983d23c45a71e684e8b0b
- 发布时间
- 2026-11-15T08:08:55Z
- 签名身份
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
签名
- 官方application/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:2050079cb4b6e7b8c29405a6b754797e33d3f58b1b45f0cf4fccf51b20b4f541
此版本的引用
oci://hub.aggrega.ai/component/core/ai-agent/n8n:1.1.0开发者参数
开发者在 Aggregate 中设置的值。
扩展 BaseComponents#/schemas/BaseAgentParameter
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| workflow_id | string | — | 是 | — |
| allow_env_access_in_nodes | boolean | false | 否 | Whether 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_definition | string | — | 否 | The 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_enabled | boolean | false | 否 | Turns 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. |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| image | string | — | 否 | Container image running the n8n platform. |
| port | integer (min 1024, max 65535) | 5678 | 否 | Port n8n listens on inside its container, serving the editor and the webhook endpoint, and the port of its Service on Kubernetes. On Docker Compose, where infra.published_port differs from it, set infra.external_base_url to http://127.0.0.1:<published_port> so the addresses n8n shows name the published port. |
| published_port | integer (min 1024, max 65535) | — | 否 | Port published on the host's loopback address, 127.0.0.1, on Docker Compose, forwarding to infra.port inside the container; any process on this machine can reach it there. Unset, nothing is published. Kubernetes realizations refuse it; reach the Service with kubectl port-forward, or attach core/public-ingress. |
| source_version | string | — | 否 | Version 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. |
| storage | object | — | 否 | — |
| external_base_url | string | — | 否 | Externally 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. |
输出契约
此组件通过 uses 拓扑向使用方发布的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| metrics_endpoint | string | — | 否 | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics`, the host being the platform's Service name and the port `infra.port`, 5678 unless the Release sets another. Empty while values.metrics_enabled is false. |
uses 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
model
- 选择器
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- 注入
- env, file
经由此套接字的每个连接可填充的槽位
| 槽位 | 选择器 | 必需 | 注入 | 敏感 | 描述 |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | 否 | env | 是 | Optional 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
- 选择器
- component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
- 注入
- env, file
经由此套接字的每个连接可填充的槽位
| 槽位 | 选择器 | 必需 | 注入 | 敏感 | 描述 |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | 否 | env | 是 | Optional 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. |
| endpoint | feature.aggrega.ai/kind=secret | 否 | env | 是 | Optional 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
- 选择器
- datastore.aggrega.ai/engine in (vector, semantic-memory, search)
- 注入
- env, file
经由此套接字的每个连接可填充的槽位
| 槽位 | 选择器 | 必需 | 注入 | 敏感 | 描述 |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | 否 | env | 是 | Optional 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. |
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
未声明附加槽位。
自注入允许列表
未声明自注入管道。
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
- 使用使用套接字 «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
附加槽位:credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 →core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 → - 使用使用套接字 «tools»
component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
附加槽位:credential, endpoint
- 使用使用套接字 «vector_store»
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
附加槽位:credential
- $ref扩展模式(values)
BaseComponents#/schemas/BaseAgentParameter
被使用
使用套接字 «runner»
使用套接字 «api»
使用套接字 «runner»
使用套接字 «api»
使用套接字 «services»
使用套接字 «api»
使用套接字 «services»
使用套接字 «services»
使用套接字 «sandbox»
使用套接字 «plugin_daemon»
使用套接字 «ssrf_proxy»
使用套接字 «sandbox»
使用套接字 «plugin_daemon»
使用套接字 «ssrf_proxy»
使用套接字 «api»
使用套接字 «ssrf_proxy»
使用套接字 «api»
使用套接字 «api»
使用套接字 «sandbox»
使用套接字 «plugin_daemon»
使用套接字 «ssrf_proxy»
使用套接字 «sandbox»
使用套接字 «plugin_daemon»
使用套接字 «ssrf_proxy»
使用套接字 «target_agent»
使用套接字 «upstream»
使用套接字 «forward_target»
使用套接字 «scrape_target»
使用套接字 «store»
适用于
适用于
适用于
适用于
适用于
适用于
适用于
实现
实现
实现