Component
core/ai-agent/dify-worker
The Dify task worker — the Celery consumer that runs everything a Dify installation does off the request path: indexing uploaded documents into the vector datastore, executing scheduled and queued workflow runs, generating dataset segments, and delivering mail and webhooks. It takes work from the Redis-compatible broker wired through the `cache` uses-socket, reads and writes the platform's relational model in the PostgreSQL backend wired through `backend`, and writes embeddings into the vector datastore wired through `vector_store`. Workflow code nodes it executes run in the sandbox wired through `sandbox`, and outbound requests to addresses a user supplied are routed through the forward proxy wired through `ssrf_proxy`. It serves no port and nothing connects to it — work reaches it through the broker — so it publishes no provides contract and renders as a stateless worker tier. By default nothing reaches Dify's vendor: infra.telemetry_enabled turns on its daily usage event, and infra.marketplace_enabled its daily plugin upgrade check against the plugin marketplace.
Versione
Provenienza
- Digest del contenuto
- sha256:3fe0f7701ed392f6517da04e6d5c7168044cc4ca129ec2430b8abbe34d6969e9
- Pubblicato
- 2026-11-15T08:08:52Z
- Identità di firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Ufficialeapplication/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:9993f64b63ebc9759ad16bdd7e5e06f5750ca9654bc22e50473426a23a092ea8
Riferimento a questa versione
oci://hub.aggrega.ai/component/core/ai-agent/dify-worker:1.1.0Parametri dello sviluppatore
Valori che lo sviluppatore imposta nell’Aggregate.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| vector_index_prefix | string | Vector_index | no | Name prefix the worker gives the collections it creates in the wired vector datastore. It matches the API server's prefix, because the two write the same collections. |
| indexing_max_segmentation_tokens | integer (min 1) | 4000 | no | Longest segment, in tokens, the dataset indexer produces when it splits a document. |
Dimensionamento dell’operatore
Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| engine_version | string | 1.17.0 | no | Dify API container image tag. The API server, the scheduler and this worker run the same image, so a Release moves all three together. |
| log_level | string (DEBUG | INFO | WARNING | ERROR | CRITICAL) | INFO | no | Log verbosity the worker emits. |
| concurrency | integer (min 1) | 4 | no | Number of task slots one worker process runs in parallel. Raising it raises throughput and the worker's memory ceiling together, so it is sized with compute.memory. |
| telemetry_enabled | boolean | false | no | Lets the worker send Dify's anonymous daily usage event, and the install event when the server's own was not delivered, to otel.dify.ai, falling back to otel.dify.cn. Unset or false, nothing reaches those hosts. Set it on the server and the scheduler too. |
| marketplace_enabled | boolean | false | no | Lets the worker reach Dify's plugin marketplace (marketplace.dify.ai): the daily plugin upgrade check the scheduler enqueues, and installing the plugins a new workspace is configured with. Model-provider plugins such as OpenAI's install from the marketplace, so a Release whose applications use one sets it. Unset or false, nothing reaches that host. Set it on the server and the scheduler too. |
| compute | object | — | no | — |
| overrides | object (open) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contratto di output
Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.
Nessun valore di output dichiarato.
Socket uses
I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.
backend
- Selettore
- component.aggrega.ai/category=datastore
- Iniezione
- env
Slot che ogni connessione attraverso questo socket può riempire
| Slot | Selettore | Obbligatorio | Iniezione | Sensibile | Descrizione |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sì | Optional password the worker presents to the backend this connection reaches, shared with that backend. When attached, supplies the backend password via the credential subsystem; unattached, the Recipe uses the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password. |
cache
- Selettore
- component.aggrega.ai/category=datastore
- Iniezione
- env
Slot che ogni connessione attraverso questo socket può riempire
| Slot | Selettore | Obbligatorio | Iniezione | Sensibile | Descrizione |
|---|---|---|---|---|---|
| server_ca | feature.aggrega.ai/kind=secret | no | file | sì | Optional authority the worker checks the cache's certificate against while the cache publishes protocol valkey-tls or redis-tls, where the image does not already trust the authority that signs it. Its Secret holds ca.crt. The Recipe mounts the whole Secret read-only and points the cache client and the task broker at the file. The build halts on a server_ca publishing no Secret name, and on one wired to a cache served without TLS. Fill it with core/referenced-secret. |
vector_store
- Selettore
- datastore.aggrega.ai/engine in (vector, semantic-memory, search)
- Iniezione
- env
Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.
sandbox
- Selettore
- component.aggrega.ai/category=ai-agent
- Iniezione
- env
Slot che ogni connessione attraverso questo socket può riempire
| Slot | Selettore | Obbligatorio | Iniezione | Sensibile | Descrizione |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sì | Optional execution-key credential the worker presents on every request to the sandbox this connection reaches. The same credential is attached to the code_execution_key slot on the sandbox, so both ends hold the same value. Unattached, the Recipe uses the pinned development literal `dify-sandbox`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it. |
plugin_daemon
- Selettore
- component.aggrega.ai/category=ai-agent
- Iniezione
- env
Slot che ogni connessione attraverso questo socket può riempire
| Slot | Selettore | Obbligatorio | Iniezione | Sensibile | Descrizione |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sì | Optional credential the worker presents on every call it makes to the plugin runtime this connection reaches. The runtime holds the same key in its plugin_daemon_key slot and the API server presents it on its own connection, so the credential is attached to all three or to none: attaching it to some of them leaves the rest carrying a different value, which renders cleanly and is refused when the call is made. Unattached, the Recipe uses the pinned development literal `dify-plugin-daemon-server-key`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it. |
ssrf_proxy
- Selettore
- component.aggrega.ai/category=ai-agent
- Iniezione
- env
Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.
Slot di aggancio
Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.
| Slot | Selettore | Obbligatorio | Iniezione | Sensibile | Descrizione |
|---|---|---|---|---|---|
| secret_key | feature.aggrega.ai/kind=secret | sì | env | sì | Required application-secret credential. The worker decrypts stored model-provider credentials under it, so it carries the same secret as the API server. There is no default: the build halts when nothing fills this slot. |
| inner_api_key | feature.aggrega.ai/kind=secret | no | env | sì | Optional credential the plugin runtime presents on every call back into the internal API, which the worker compares against its own. The worker and the API server declare this slot under the same name and the plugin runtime presents it on its connection to the API server, so the credential is attached to all three or to none: attaching it to some of them leaves the rest carrying a different value, which renders cleanly and is refused when the call is made. Unattached, the Recipe uses the pinned development literal `dify-plugin-inner-api-key`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it. |
Elenco consentito di auto-iniezione
env
Relazioni
Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.
Usa
- usausa il socket «backend»
component.aggrega.ai/category=datastore
Slot di aggancio: credential
core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/valkey v1.0.0 →core/datastore/weaviate v1.0.0 → - usausa il socket «cache»
component.aggrega.ai/category=datastore
Slot di aggancio: server_ca
core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/valkey v1.0.0 →core/datastore/weaviate v1.0.0 → - usausa il socket «vector_store»
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
Non dichiara slot di aggancio.
- usausa il socket «sandbox»
component.aggrega.ai/category=ai-agent
Slot di aggancio: credential
core/ai-agent/a2a-remote v1.0.0 →core/ai-agent/agent-framework v1.0.0 →core/ai-agent/agent-framework v1.1.0 →core/ai-agent/agenta-api v1.0.0 →core/ai-agent/agenta-cron v1.0.0 →core/ai-agent/agenta-migrations v1.0.0 →core/ai-agent/agenta-runner v1.0.0 →core/ai-agent/agenta-services v1.0.0 →core/ai-agent/agenta-web v1.0.0 →core/ai-agent/agenta-web-mobile v1.0.0 →core/ai-agent/agenta-worker-queues v1.0.0 →core/ai-agent/agenta-worker-streams v1.0.0 →core/ai-agent/anthropic v1.0.0 →core/ai-agent/autogen v1.0.0 →core/ai-agent/autogpt v1.0.0 →core/ai-agent/bedrock v1.0.0 →core/ai-agent/bland v1.0.0 →core/ai-agent/claude-agent-sdk v1.0.0 →core/ai-agent/crewai v1.0.0 →core/ai-agent/crewai v1.1.0 →core/ai-agent/dify v1.0.0 →core/ai-agent/dify v1.1.0 →core/ai-agent/dify-plugin-daemon v1.0.0 →core/ai-agent/dify-sandbox v1.0.0 →core/ai-agent/dify-ssrf-proxy v1.0.0 →core/ai-agent/dify-web v1.0.0 →core/ai-agent/dify-web v1.1.0 →core/ai-agent/dify-worker v1.0.0 →core/ai-agent/dify-worker-beat v1.0.0 →core/ai-agent/dify-worker-beat v1.1.0 →core/ai-agent/dynamiq v1.0.0 →core/ai-agent/flowise v1.0.0 →core/ai-agent/flowise v1.1.0 →core/ai-agent/gemini v1.0.0 →core/ai-agent/google-adk v1.0.0 →core/ai-agent/google-adk v1.1.0 →core/ai-agent/griptape v1.0.0 →core/ai-agent/gumloop v1.0.0 →core/ai-agent/haystack v1.0.0 →core/ai-agent/langflow v1.0.0 →core/ai-agent/langflow v1.1.0 →core/ai-agent/langgraph v1.0.0 →core/ai-agent/langgraph v1.1.0 →core/ai-agent/letta v1.0.0 →core/ai-agent/librechat v1.0.0 →core/ai-agent/librechat v1.1.0 →core/ai-agent/librechat v1.2.0 →core/ai-agent/lindy v1.0.0 →core/ai-agent/livekit-agent-worker v1.0.0 →core/ai-agent/llamaindex v1.0.0 →core/ai-agent/mastra v1.0.0 →core/ai-agent/metagpt v1.0.0 →core/ai-agent/n8n v1.0.0 →core/ai-agent/n8n v1.1.0 →core/ai-agent/open-webui v1.0.0 →core/ai-agent/openai-agents-sdk v1.0.0 →core/ai-agent/openclaw v1.0.0 →core/ai-agent/openhands v1.0.0 →core/ai-agent/phidata v1.0.0 →core/ai-agent/promptflow v1.0.0 →core/ai-agent/pydantic-ai v1.0.0 →core/ai-agent/retell v1.0.0 →core/ai-agent/rivet v1.0.0 →core/ai-agent/semantic-kernel v1.0.0 →core/ai-agent/smolagents v1.0.0 →core/ai-agent/vapi v1.0.0 →core/ai-agent/vertex-ai v1.0.0 → - usausa il socket «plugin_daemon»
component.aggrega.ai/category=ai-agent
Slot di aggancio: credential
core/ai-agent/a2a-remote v1.0.0 →core/ai-agent/agent-framework v1.0.0 →core/ai-agent/agent-framework v1.1.0 →core/ai-agent/agenta-api v1.0.0 →core/ai-agent/agenta-cron v1.0.0 →core/ai-agent/agenta-migrations v1.0.0 →core/ai-agent/agenta-runner v1.0.0 →core/ai-agent/agenta-services v1.0.0 →core/ai-agent/agenta-web v1.0.0 →core/ai-agent/agenta-web-mobile v1.0.0 →core/ai-agent/agenta-worker-queues v1.0.0 →core/ai-agent/agenta-worker-streams v1.0.0 →core/ai-agent/anthropic v1.0.0 →core/ai-agent/autogen v1.0.0 →core/ai-agent/autogpt v1.0.0 →core/ai-agent/bedrock v1.0.0 →core/ai-agent/bland v1.0.0 →core/ai-agent/claude-agent-sdk v1.0.0 →core/ai-agent/crewai v1.0.0 →core/ai-agent/crewai v1.1.0 →core/ai-agent/dify v1.0.0 →core/ai-agent/dify v1.1.0 →core/ai-agent/dify-plugin-daemon v1.0.0 →core/ai-agent/dify-sandbox v1.0.0 →core/ai-agent/dify-ssrf-proxy v1.0.0 →core/ai-agent/dify-web v1.0.0 →core/ai-agent/dify-web v1.1.0 →core/ai-agent/dify-worker v1.0.0 →core/ai-agent/dify-worker-beat v1.0.0 →core/ai-agent/dify-worker-beat v1.1.0 →core/ai-agent/dynamiq v1.0.0 →core/ai-agent/flowise v1.0.0 →core/ai-agent/flowise v1.1.0 →core/ai-agent/gemini v1.0.0 →core/ai-agent/google-adk v1.0.0 →core/ai-agent/google-adk v1.1.0 →core/ai-agent/griptape v1.0.0 →core/ai-agent/gumloop v1.0.0 →core/ai-agent/haystack v1.0.0 →core/ai-agent/langflow v1.0.0 →core/ai-agent/langflow v1.1.0 →core/ai-agent/langgraph v1.0.0 →core/ai-agent/langgraph v1.1.0 →core/ai-agent/letta v1.0.0 →core/ai-agent/librechat v1.0.0 →core/ai-agent/librechat v1.1.0 →core/ai-agent/librechat v1.2.0 →core/ai-agent/lindy v1.0.0 →core/ai-agent/livekit-agent-worker v1.0.0 →core/ai-agent/llamaindex v1.0.0 →core/ai-agent/mastra v1.0.0 →core/ai-agent/metagpt v1.0.0 →core/ai-agent/n8n v1.0.0 →core/ai-agent/n8n v1.1.0 →core/ai-agent/open-webui v1.0.0 →core/ai-agent/openai-agents-sdk v1.0.0 →core/ai-agent/openclaw v1.0.0 →core/ai-agent/openhands v1.0.0 →core/ai-agent/phidata v1.0.0 →core/ai-agent/promptflow v1.0.0 →core/ai-agent/pydantic-ai v1.0.0 →core/ai-agent/retell v1.0.0 →core/ai-agent/rivet v1.0.0 →core/ai-agent/semantic-kernel v1.0.0 →core/ai-agent/smolagents v1.0.0 →core/ai-agent/vapi v1.0.0 →core/ai-agent/vertex-ai v1.0.0 → - usausa il socket «ssrf_proxy»
component.aggrega.ai/category=ai-agent
Non dichiara slot di aggancio.
core/ai-agent/a2a-remote v1.0.0 →core/ai-agent/agent-framework v1.0.0 →core/ai-agent/agent-framework v1.1.0 →core/ai-agent/agenta-api v1.0.0 →core/ai-agent/agenta-cron v1.0.0 →core/ai-agent/agenta-migrations v1.0.0 →core/ai-agent/agenta-runner v1.0.0 →core/ai-agent/agenta-services v1.0.0 →core/ai-agent/agenta-web v1.0.0 →core/ai-agent/agenta-web-mobile v1.0.0 →core/ai-agent/agenta-worker-queues v1.0.0 →core/ai-agent/agenta-worker-streams v1.0.0 →core/ai-agent/anthropic v1.0.0 →core/ai-agent/autogen v1.0.0 →core/ai-agent/autogpt v1.0.0 →core/ai-agent/bedrock v1.0.0 →core/ai-agent/bland v1.0.0 →core/ai-agent/claude-agent-sdk v1.0.0 →core/ai-agent/crewai v1.0.0 →core/ai-agent/crewai v1.1.0 →core/ai-agent/dify v1.0.0 →core/ai-agent/dify v1.1.0 →core/ai-agent/dify-plugin-daemon v1.0.0 →core/ai-agent/dify-sandbox v1.0.0 →core/ai-agent/dify-ssrf-proxy v1.0.0 →core/ai-agent/dify-web v1.0.0 →core/ai-agent/dify-web v1.1.0 →core/ai-agent/dify-worker v1.0.0 →core/ai-agent/dify-worker-beat v1.0.0 →core/ai-agent/dify-worker-beat v1.1.0 →core/ai-agent/dynamiq v1.0.0 →core/ai-agent/flowise v1.0.0 →core/ai-agent/flowise v1.1.0 →core/ai-agent/gemini v1.0.0 →core/ai-agent/google-adk v1.0.0 →core/ai-agent/google-adk v1.1.0 →core/ai-agent/griptape v1.0.0 →core/ai-agent/gumloop v1.0.0 →core/ai-agent/haystack v1.0.0 →core/ai-agent/langflow v1.0.0 →core/ai-agent/langflow v1.1.0 →core/ai-agent/langgraph v1.0.0 →core/ai-agent/langgraph v1.1.0 →core/ai-agent/letta v1.0.0 →core/ai-agent/librechat v1.0.0 →core/ai-agent/librechat v1.1.0 →core/ai-agent/librechat v1.2.0 →core/ai-agent/lindy v1.0.0 →core/ai-agent/livekit-agent-worker v1.0.0 →core/ai-agent/llamaindex v1.0.0 →core/ai-agent/mastra v1.0.0 →core/ai-agent/metagpt v1.0.0 →core/ai-agent/n8n v1.0.0 →core/ai-agent/n8n v1.1.0 →core/ai-agent/open-webui v1.0.0 →core/ai-agent/openai-agents-sdk v1.0.0 →core/ai-agent/openclaw v1.0.0 →core/ai-agent/openhands v1.0.0 →core/ai-agent/phidata v1.0.0 →core/ai-agent/promptflow v1.0.0 →core/ai-agent/pydantic-ai v1.0.0 →core/ai-agent/retell v1.0.0 →core/ai-agent/rivet v1.0.0 →core/ai-agent/semantic-kernel v1.0.0 →core/ai-agent/smolagents v1.0.0 →core/ai-agent/vapi v1.0.0 →core/ai-agent/vertex-ai v1.0.0 →
Usato da
usa il socket «runner»
usa il socket «api»
usa il socket «runner»
usa il socket «api»
usa il socket «services»
usa il socket «api»
usa il socket «services»
usa il socket «services»
usa il socket «sandbox»
usa il socket «plugin_daemon»
usa il socket «ssrf_proxy»
usa il socket «sandbox»
usa il socket «plugin_daemon»
usa il socket «ssrf_proxy»
usa il socket «api»
usa il socket «ssrf_proxy»
usa il socket «api»
usa il socket «api»
usa il socket «sandbox»
usa il socket «plugin_daemon»
usa il socket «ssrf_proxy»
usa il socket «target_agent»
usa il socket «scrape_target»
si applica a
si applica a
si applica a
implementa
implementa